arcee-ai /nac
Give AI agents ambitious work without losing the plot. nac is an open-source harness for long-running tasks, using a central orchestrator, threads, and structured episodes to stay aligned with your intent.
★ 314⑂ 34👁 0⑃ 582● 49▤ 11
+2
日增长
314
stars
34
forks
0
watchers
582
prs
49
issues
11
releases
README
Arcee •
Documentation •
Releases •
Arcee Open Model API
nac is an open-source agent harness for longer, ambitious tasks — experiments, training runs, infrastructure, and prototyping that has to stay aligned with the original intent. It uses a thread-and-episode architecture inspired by slate: a central orchestrator plans and decomposes work but cannot execute commands or edit files; it only launches threads, which return episodes — structured summaries of what they accomplished. Also takes inspiration from nanocode and pi. For the technical write-up, see the nac blog post.
Quickstart
By Hand. Install the latest stable release:
sh
curl -fsSL https://raw.githubusercontent.com/arcee-ai/nac/main/scripts/install.sh | sh
The installer puts nac-web in $HOME/.local/bin. Add that directory to your PATH if needed, then start the dashboard from your project,
sh
nac-web
and navigate to the interface in your browser (default: http://127.0.0.1:3210).
By Agent. Nac provides a portable onboarding skill and MCP integration; paste this into your chosen agent harness to install nac, configure it, and connect the MCP:
Install the nac onboarding skill with curl -fsSL https://raw.githubusercontent.com/arcee-ai/nac/main/scripts/install-skill.sh | sh -s -- --target agents, load nac-onboarding, and walk me through installing nac, selecting Arcee login, ChatGPT Codex login, or an OpenAI-compatible API key, adding MCP servers, and connecting your MCP client to nac.
Upgrade. Nac ships with a native upgrade function which can be used to install the latest stable release of nac.
sh
nac-web upgrade
Model Provider Authentication
Pick one before you start a session, or configure it later from the dashboard.
sh
Recommended: Arcee device-code login → Latest Open & Arcee Trinity models
nac-web arcee-auth login
ChatGPT account via OAuth → OpenAI models
nac-web codex-auth login
Any catalog provider (DeepSeek, Fireworks, Together, OpenAI, Anthropic, arcee-api, …)
export OPENAI_API_KEY=... or ANTHROPIC_API_KEY, TOGETHER_API_KEY, ARCEE_API_KEY, …
More details can be found in Providers and logins and Model configuration.
Uninstall
sh
curl -fsSL https://raw.githubusercontent.com/arcee-ai/nac/main/scripts/uninstall.sh | sh
Documentation
- Usage
- Release lifecycle
- AGENTS.md Files
- Skills
- Sandbox
- Configuration
- Data stores
- Example config
- Model configuration
- Catalog and cost
- Providers and logins
- HTTP API
- Model request security
Contributing
Pull requests are welcome. A CLA-signing bot checks every PR against arcee-ai's CLA; comment I have read the CLA Document and I hereby sign the CLA on your PR to sign it (or recheck to re-run the check).
The supported source workflow starts with one dependency setup per fresh
worktree:
sh
make setup
make dev
make dev runs the Rust API at http://127.0.0.1:3210 and the React app at
http://127.0.0.1:5173, with Vite HMR and API proTop issues
#151Add a transcription endpoint for dictated prompts3 comments · 2026-08-13#411A2Agent integration and compatibility testing3 comments · 2026-10-23#252Image tool results cause compaction and run failure after switching models2 comments · 2026-09-11#197Add durable goals with verifier-owned completion and blocked states1 comments · 2026-08-18#120Add image attachments to the session prompt bar0 comments · 2026-08-12
Latest release
v0.1.4 v0.1.4 2026-08-27NAC v0.1.4 lets you fork a finished conversation into a new independent session, and makes Stop wait until running work is actually gone. Conversation forks On a finished model turn, Create fork clones the chat through that prefix into a new session in the same project. The clone keeps the same workspace, model, and project, and copies threads, episodes, live thread events, steering, worksets, and workspace revisions from the copied prefix. It does not duplicate a sandbox worktree. The original chat shows live and deleted fork markers; deleting a fork updates those markers without a reload.