start
From zero to a working session.
A five-minute walk-through. Open a project, pick a model, ship a small change.
1. Open a project
From the directory of any project you want to work on:
anthracodeOn first launch you'll be asked for a model API key (Claude, GPT, local — your choice). The key is written to ~/.anthracode/config.json and never sent anywhere except the model provider.
2. Attach to an existing project URL
Anthracode can attach to an existing project share URL or directory:
anthracode attach https://opencode.ai/s/abc1233. Describe what you want
The agent plans before it edits. A typical short interaction:
> refactor the auth middleware
plan: 3 steps · est 6 min
▸ read auth.ts and 2 dependents
▸ extract verifyToken into lib/jwt.ts
▸ update callers, run tests
proceed? [y/n]Plans are explicit and revisable. Reject a step and the agent will re-plan.
4. Quit cleanly
Ctrl+C exits. Memory and tasks are flushed to disk on the way out. Re-running anthracode in the same directory picks up where you left off.
What just got created
Look in your project root:
.anthracode/
memory/ ← markdown files; you can read and edit them
tasks/ ← in-progress task lists
config.json ← project-level overridesThese are plain files — commit the ones you want versioned, ignore the rest. The defaults gitignore everything except memory/shared/.
