What do you want to do?
4 use cases
-
Run your own Comma instance with Docker Compose
Start a single-node personal agent on your own machine with one compose command.
- Comma
- Personal productivity
- Intermediate
View prompt
Clone the AFK-surf/Comma repository and follow its Self-host with Docker Compose section to start a single-node instance for <owner email>. Report the Web, Admin, and Product API addresses from the Interfaces table and any build errors. Verify that the login code arrives in the local inbox before you finish.
-
Run Comma locally with a mock model for testing
Start the backend and Web client without a model key and run the test suites.
- Comma
- Personal productivity
- Intermediate
View prompt
In the AFK-surf/Comma repository, install dependencies with pnpm, start the local stack with make dev, and run make test-clients and make test-systems. Report which suites pass and which fail, with the failing test names. Verify that the mock model is in use by confirming the README says make dev uses a deterministic mock model.
-
Set a Loop to wake Comma only when something needs it
Have Comma write a small watcher that acts only when an inbox, repo, or feed changes.
- Comma
- Personal productivity
- Intermediate
View prompt
Using Comma from the AFK-surf/Comma project or the hosted comma.surf service, ask the agent to create a Loop that watches <inbox, repository, or feed> and wakes the agent only when <trigger>. Report the Loop's name and what it watches. Verify that a test event produces a Task on the board without waking the agent for unrelated events.
-
Hand file edits on your Mac to Codex or Claude Code
Let Comma read files on your Mac and delegate changes to an agent you already use.
- Comma
- Codex
- Claude Code
- Personal productivity
- Advanced
View prompt
On a Mac with the Comma Mac app connected to Salix, ask Comma to read the files in <project folder> and pass the change <describe change> to Codex or Claude Code. Report the files changed and the commands run. Verify the result by reviewing the diff before accepting the Task.
How to use Comma
- Check you have what it needs: Docker Engine with Compose v2.24 or later for self-hosting; A model provider account, or a ChatGPT or Claude plan, for real model calls; Enough disk space for the first Docker build, which downloads Lean, Elixir, Go, and Node toolchains.
- Open AFK-surf/Comma on GitHub and read the README and license.
- Run
cp .env.example .envin the repository root. - Set COMMA_OWNER_EMAIL to your email address, and set COMMA_LLM_BASE_URL, COMMA_LLM_MODEL, and COMMA_LLM_API_KEY for your model provider in .env.
- Run
docker compose up -d --buildand wait for the first build to finish. - Open the Comma Web address from the Interfaces table and request a login code with your email.
These steps come from our top use case, Run your own Comma instance with Docker Compose, which also has a copy-paste agent prompt.
Get 5 new use cases every morning. Free, one short email, unsubscribe anytime.
Get them freeComma alternatives · Best AI repos for Personal productivity
About this repo
- Who it is forWritten for individuals and developers who want a self-hosted or hosted personal agent that keeps working on goals across devices.
- Why it is hot
- LanguageElixir
- Sourcegithub.com/AFK-surf/Comma · Back to Hot repos
Requirements
- Docker Engine with Compose v2.24 or later for self-hosting
- A model provider account, or a ChatGPT or Claude plan, for real model calls
- Enough disk space for the first Docker build, which downloads Lean, Elixir, Go, and Node toolchains
- A Mac with the Comma Mac app for local file and agent work
- pnpm and make for local development
Maintain Comma? Add the Featured on Deduped badge
Paste this into your README:
[](https://dedupedai.com/use-cases/afk-surf-comma/?ref=badge)
Questions about Comma
What is Comma?
Comma is an open-source, always-on personal agent that turns goals into persistent Tasks, runs them in agent loops, and works across your computers, phone, and cloud. It is an open-source project on GitHub: https://github.com/AFK-surf/Comma.
Who is Comma for?
Written for individuals and developers who want a self-hosted or hosted personal agent that keeps working on goals across devices.
What can I do with Comma?
4 use cases so far, for example: Run your own Comma instance with Docker Compose; Run Comma locally with a mock model for testing; Set a Loop to wake Comma only when something needs it. Each has steps and a copy-paste agent prompt.
What do I need to run Comma?
Docker Engine with Compose v2.24 or later for self-hosting; A model provider account, or a ChatGPT or Claude plan, for real model calls; Enough disk space for the first Docker build, which downloads Lean, Elixir, Go, and Node toolchains; A Mac with the Comma Mac app for local file and agent work.
What are alternatives to Comma?
Other hot AI repos in Personal productivity: Abacusai Bot, Unigit Ecosystem, Agent Peer Chat, Compass, Dossier.
Is Comma safe to run?
Deduped does not own, audit or vouch for it. Read the README and license, run it on your own systems first and review every command before you run it.