agentleFS
PrisacariuRobertPrisacariuRobert/sidemates/site/llms-full.txt

sidemates / site

llms.txt9 starsChanged 37 days agoMITView on GitHub

Last updated: 7 October 2026. Source of truth: https://github.com/PrisacariuRobert/sidemates Sidemates is a free, open-source (MIT) macOS app that gives you a small team of named AI teammates running on your own Mac. Each teammate has a name, a job, a private workspace and its own browser. You talk to them in a chat, by voice, from your iPhone, or from Siri, and they do the work. Tagline: an AI team that does the work on your real Mac, not just…

  • Pipes a download into a shell

The file

We split this llms-full.txt into the rules it gives an agent

4 rules. About 0 are common, 4 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈4

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Start free: a Google Gemini key (a Google account, no card), or a free Nous Portal plan.

    line 29
  2. Distinctive:

    Use a subscription you already pay for: ChatGPT, Grok, GitHub Copilot (Pro, Pro+, Business).

    line 30
  3. Distinctive:

    No Windows or Linux desktop app.

    line 44
  4. Distinctive:

    When a teammate works, the text it needs is sent to the AI provider you chose, under that provider's terms.

    line 50

≈ “Common” is an estimate: at least 1 in 5 of the 3,592 llms.txt files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
llms-full.txt
# Sidemates — the full facts

Last updated: 7 October 2026. Source of truth: https://github.com/PrisacariuRobert/sidemates

## What it is

Sidemates is a free, open-source (MIT) macOS app that gives you a small team of named AI teammates running on your own Mac. Each teammate has a name, a job, a private workspace and its own browser. You talk to them in a chat, by voice, from your iPhone, or from Siri, and they do the work.

Tagline: an AI team that does the work on your real Mac, not just answers.

## What it can do

- Work in your own Apple apps: read Mail, Calendar, Reminders, Notes, Contacts and Messages; search the folders you choose; save mail attachments; draft emails; add reminders, notes and calendar events. Reading and searching happen on their own. Changes show the exact action and wait for your approval.
- Know you privately: an optional search index of your folders, Notes, Mail and Messages, stored on your Mac, so you can ask "What did Anna say about the Berlin trip, and when is it?". You see and delete anything it knows on a "What your team knows" page. Everything is opt-in.
- Browse the web: each teammate uses its own private browser profile, can stay signed in to the sites you choose, and links its sources. Sending, buying, signing in and submitting wait for your okay by default, showing the website and the exact button.
- Run on a schedule: routines such as "Every Monday at 9, plan my week", a morning brief of your day (calendar, unread mail, reminders), and a Sunday look back. Routines run while your Mac is awake; Sidemates can wake it once a day for them (macOS asks for the owner's password to allow that).
- Deliver real files: Word documents, spreadsheets and plans.
- Work as a team: write "Nova: find... Scout, double-check..." and each does their part in order.
- Autopilot: an opt-in mode, off by default and switched on per teammate (or for everyone), where a teammate acts like a person without asking first. It still stops for sign-ins, CAPTCHAs, more AI spending, saving new instructions and uploading saved files to a website, but not for purchases, payments, deletions or messages to new people. Every action is logged, it is never part of a shared teammate, and a teammate on Autopilot can be misled by hostile web pages or emails like any assistant, so use it for teammates you trust.
- Share teammates: a teammate can be shared as a link or added from the gallery at https://sidemates.app/teammates/. Imported teammates start with the browser and private computer off, use your own AI, and ask before anything important.
- Share a result: turn a finished answer into a web page with private details (emails, phone numbers, keys, your home folder) removed before it is shared.
- Phone and voice (beta): hands-free voice conversation; on iPhone, a Home Screen web app, plus "Hey Siri, ask Sidemates" and a Share menu shortcut. The phone has to reach the Mac first, which today means an HTTPS address the owner sets up (for example a tunnel on their own domain); then it pairs with one scan.
- Switch from another tool: one-click import from Hermes Agent and OpenClaw, including automations (imported paused).

## Which AI it uses

You choose, per teammate. Sidemates never resells tokens or adds a fee; each provider's own terms and limits apply.

- Start free: a Google Gemini key (a Google account, no card), or a free Nous Portal plan.
- Use a subscription you already pay for: ChatGPT, Grok, GitHub Copilot (Pro, Pro+, Business).
- Claude: works through the Claude Code you already have installed and signed in (Sidemates starts your own `claude` command and never sees your login), or with an API key. Anthropic restricts the use of Claude subscription logins in other products, and how that applies here is not settled, so check its terms before relying on it.
- Pay per use: OpenCode Go, any OpenAI-compatible API, or a Claude API key (from the Claude Console).
- Stay on your Mac: models run locally with Ollama.

## Price

The software is free. You pay only for the AI you connect, and free options exist.

## Where it runs and what it needs

- macOS 13 or later, Apple silicon or Intel. Install: curl -fsSL https://sidemates.app/install.sh | sh (a few minutes; it downloads about 140 MB).
- Web tasks need Chrome, Edge or Brave on the Mac. The private computer needs Docker.
- Works while your Mac is awake (it keeps it from dozing off while a job runs). It does not run in the cloud. A Linux runner exists for an always-on server, but there is no one-click hosted option.
- No Windows or Linux desktop app. No native iPhone app (a Home Screen web app instead).
- Public beta.

## Privacy and safety

- Your teammates, chats, files and the search index of your own notes, mail and messages are stored on your Mac. There is no Sidemates account and no tracking.
- When a teammate works, the text it needs is sent to the AI provider you chose, under that provider's terms. Choose a model running on your Mac to keep everything local.
- Teammate browsers are separate profiles, not a security sandbox.
- Security model: https://github.com/PrisacariuRobert/sidemates/blob/main/docs/SECURITY.md

## How it compares (as of 7 October 2026, from public pages)

- OpenAI dots: an always-on agent on its own cloud computer with a virtual browser; included with ChatGPT Pro and Business Premium; with permission it can also connect to the owner's own computer; the Pro plan isn't offered in the EEA, UK or Switzerland. Choose dots if you want a managed agent that works while your computer is off. Choose Sidemates if you want it on your Mac, with your Mac's apps, free, or in Europe.
- Grok Bot (xAI, distributed with Cursor): named teammates sharing one managed cloud computer; included with SuperGrok (about $30 a month), Cursor Pro (about $20 a month) and Cursor Teams since 26 August 2026. Choose it for a hosted team with a desktop and iOS app. Choose Sidemates for free software with isolated teammates on your hardware.
- Meta Muse: a consumer personal agent with its own secure VM and browser; free, $20 and $100 a month tiers; on the phone, the web and, since 17 September 2026, a Mac app that works in Mail, Messages, Calendar, Notes and files; available in the US and Canada. Choose it for a managed agent from Meta. Choose Sidemates for free, open-source software, the AI of your choice, or outside the US and Canada.
- Apple Siri AI (macOS 27): personal context from Mail, Messages, Notes, Photos and Calendar, with quick in-app actions; free beta with daily limits, English first, Apple silicon; in the EU on Macs but not yet on iPhones. Choose it for quick questions with nothing to install. Sidemates works alongside it for longer jobs.
- Hermes Desktop (Nous Research, MIT): a native app for macOS, Windows and Linux with free models through a Nous sign-in. Choose it on Windows or Linux, or for a terminal-first setup.
- OpenMausBot (Apache-2.0): an open-source team of AI bots, aimed at developers, that runs on the Claude, Codex and Grok command-line tools you already have; macOS, Windows, Ubuntu, Android and iOS; a paid Pro plan adds an always-on cloud workspace. Far more widely used than Sidemates today. Choose it for Windows, Linux or phone apps. Choose Sidemates for Mac depth (your own Mail, Calendar, Notes and Messages) and a simpler setup.
- OpenClaw (MIT): a self-hosted gateway to many chat apps with a large skill marketplace. Choose it for the widest chat-app reach.

Full comparison with sources: https://sidemates.app/alternatives/ (one page each for OpenAI dots, Grok Bot, Meta Muse, Siri AI and OpenMausBot)

## Links

- Website: https://sidemates.app/
- Source and README: https://github.com/PrisacariuRobert/sidemates
- Changelog: https://github.com/PrisacariuRobert/sidemates/blob/main/CHANGELOG.md
- Report a security issue privately: https://github.com/PrisacariuRobert/sidemates/blob/main/SECURITY.md

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.