AFK-surf/Comma

What is it?

Key features

• 01Turns larger requests into Tasks that are planned, executed and verified until done.
• 02Runs Loops that watch inboxes, repositories or feeds and wake the agent only when needed.
• 03Connects a Mac through Salix to read local files and, with permission, run commands.
• 04Can invoke Codex, Claude Code and other agents as Workers or Sub-agents.
• 05Provides a Docker Compose setup for self-hosting with PostgreSQL, Redis and MinIO.

Use cases

• Delegating multi-step personal or office errands that should continue across devices.
• Watching an inbox or repository and having the agent act only when something changes.
• Running a self-hosted personal agent that uses your own model provider key.
• Orchestrating existing coding agents such as Claude Code from one task board.

Quick start

1. 1

   Copy the example configuration

   cp .env.example .env
2. 2

   Set COMMA_OWNER_EMAIL and your model provider in .env

3. 3

   Build and start the Docker Compose stack

   docker compose up -d --build
4. 4

   Open http://localhost:8080, request a login code, and read it at http://localhost:8025

Things to know

• !Self-hosting needs Docker Compose v2.24 or later and a model provider account for real model calls.
• !The default stack does not include a mock model, so real model calls may incur provider charges.
• !The AGPL-3.0 license requires keeping source available if you serve a modified version.
• !Some features, such as Group cloud computers and Agent VMM hosts, need extra runtimes that this repository does not include.

Topics

FAQ

What is Comma?

Open-source, sessionless personal AI agent that turns goals into Tasks and keeps working on them across devices, with self-hosting via Docker Compose. Comma is a personal AI agent that organizes work around persistent Tasks rather than chat sessions. A quick question gets an answer in chat, while larger requests become Tasks that the agent plans, executes, reviews and verifies until the goal is complete. Tasks move through In progress, Needs Review and Done, and decisions that belong to the user wait in Needs Review.

Is Comma free to use? What license does it have?

Comma is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.

Is Comma still maintained?

Actively maintained. The last commit to Comma was on Oct 20, 2026.

What can I use Comma for?

Delegating multi-step personal or office errands that should continue across devices. Watching an inbox or repository and having the agent act only when something changes. Running a self-hosted personal agent that uses your own model provider key. Orchestrating existing coding agents such as Claude Code from one task board.

How do I install Comma?

Copy the example configuration: cp .env.example .env Set COMMA_OWNER_EMAIL and your model provider in .env Build and start the Docker Compose stack: docker compose up -d --build Open http://localhost:8080, request a login code, and read it at http://localhost:8025

Where can I get Comma?

The source code and installation instructions are on GitHub: https://github.com/AFK-surf/Comma