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
RustApache-2.0Created 2026-03-28
Download: v0.1.4v0.1.4 ↓0.1.42026-08-27
+2
Daily
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 pro

Top issues

Latest release

v0.1.4 v0.1.4 2026-08-27
NAC 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.

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON