NtwineQuick start
From npx ntwine to your first answered question.
Requirements
- Node 22.13 or later.
- A Claude Code or Codex subscription you're signed in to. Ntwine drives the subscription you already pay for. It brings its own pinned copy of each CLI, downloaded once on first start, so the version on your PATH never changes what a thread runs.
- Optionally, any ACP agent on your PATH: OpenCode, Gemini CLI, GitHub Copilot CLI, Cursor's agent, goose, Qwen Code and more.
Ntwine runs on macOS, Linux and Windows. It doesn't care how you do version control, and it doesn't need Git.
Run it in a project
cd path/to/acme
npx ntwine NTWINE v0.4.0 ready in 4.0s
➜ Local: http://127.0.0.1:9393/project/acme/
➜ Project: acme — path/to/acme
press ctrl-c to stop · run with --debug for the full event feedA browser tab opens on acme's board. Ntwine listens on port 9393 (19393 if something else holds it). The first time, it asks whether to add the repository as a project. Running the command never adds one by itself.
The first time a browser opens Ntwine, a short tour points out the project switcher, the prompt box, the queue and the thread list. A browser that opens a bare http://127.0.0.1:9393/ first asks which project to start in, listing every project Ntwine knows. Take the tour in ⌘K replays it.
Start a thread
Type a task in the prompt box and press Enter. You can pick the agent, model and effort beside the box. If you leave effort on auto, a quick model picks it for each prompt.
Answer when it asks
The agent works on its own until it reaches something only you can settle. Then its thread becomes a card in the queue, usually with a question you can answer in one keystroke. From there you can reply, snooze it, or mark it done with d.
Add another project
Run npx ntwine in a second repo. It joins the server that's already running and asks whether to add the repo. Once you confirm, its board opens. The switcher above the prompt box moves between projects, and its first choice, All projects, shows every project at once.
Prefer your editor?
The VS Code extension puts Ntwine beside your code.
Try it without touching your setup
npx ntwine --sandboxThis starts a disposable Ntwine with a throwaway home and project on its own port, and deletes it when the terminal closes. Your credentials come along, so it sees what your real board sees.