NeuralCode documentation
NeuralCode runs a team of Claude Code agents in parallel on your Mac — each in its own isolated git worktree. Start a task, let an agent work, review the diff, run it in the terminal, then merge. This documentation covers every feature in depth.
What NeuralCode is#
NeuralCode is a native macOS desktop app (built with Tauri v2 and React) that orchestrates the Claude Code CLI. Instead of running one agent in your terminal, you run many at once — each agent works inside its own git worktree on its own branch, so they never step on each other. You supervise the results as diffs and merge what you like.
The parallel-agents model#
Everything in NeuralCode is built around three nested ideas:
| Concept | What it is |
|---|---|
| Project | A git repository you've opened. The sidebar groups work by project, and one project can hold many workspaces. |
| Workspace | One task. Backed by a dedicated git worktree on its own branch, with its own chat history, diff, terminal and review. |
| Agent run | A single turn of the Claude Code agent inside a workspace — streamed live, with tool-use chips and a final summary. |
Because each workspace is a real worktree, you can run a bug fix, a feature, and a refactor simultaneously and watch them all progress in the sidebar.
The end-to-end flow#
A typical loop looks like this:
- Open a project — point NeuralCode at a git repo.
- Create a workspace — name the task; NeuralCode spins up a worktree + branch.
- Chat with the agent — describe the work; output streams in with tool-use chips.
- Review — inspect the diff, let a second agent self-review, and run your tests.
- Ship — commit, push, open a PR, or merge the branch into its base.
How these docs are organized#
- Core workflow — the day-to-day: projects, workspaces, chat, diff, review, terminal, and shipping.
- Integrations — GitHub (sign-in, issues, PRs) and Google sign-in.
- Configuration — settings, models, custom commands, and permission modes.
- Usage & maintenance — spend tracking, shortcuts, and updates.
- Developer reference — the Tauri commands, streaming events, and data model under the hood.
Use the search box (⌘K) any time to jump straight to a feature.