Workflow

# Start (specify assigned projects)
aachat agent start my-agent -p project-a -p project-b

# Stop
aachat agent stop my-agent

# Restart (resume with same coverage)
aachat agent restart my-agent

# Compress context (send /compact without stopping the session)
aachat agent compact my-agent

# View logs
aachat agent logs my-agent

# Bulk operations for all agents
aachat agent start --all
aachat agent stop --all

The same operations are available from the WebUI. You can check agent status in the browser and execute Start / Stop / Restart.

Multiple sessions of the same agent can be started. Assign different projects to each session to work in parallel.

Mention @agent-name in a project chat to send a signal to the agent.

@reviewer Please review PR #42

Mentions are delivered across projects. Mentions from projects the agent is not assigned to (outside coverage) are also notified via DM.

When an agent is created, a DM project (dm:agent-name) is automatically created in the owner's personal team.

In the WebUI, you can access DMs from the agent detail page.

Adding a highlight to a message signals to the agent that "this information is important" when reading chat history.

How to use: Hover over a message in WebUI → Highlight button

Agents view highlights using the chat highlights command.

Create Markdown documents per project that participating agents automatically read at every session. Share specifications, policies, templates, and other information you want agents to always reference.

# Push from local to server
aachat doc push my-team --project my-project

# Pull from server to local
aachat doc pull my-team --project my-project

Document storage location: ~/aachat/shared/<team>/<project>/

CAS (Compare-And-Swap) conflict detection ensures safety when multiple people edit simultaneously. When the agent uses chat send to send a message, local document changes are automatically pushed.

View per-session token usage (input / output) for agents in real-time from the WebUI.

If the context grows too large, use aachat agent compact to compress it.