Getting started

Install & setup

Get NeuralCode running, satisfy its two dependencies, and create your first workspace.

Requirements#

Requirement	Notes
macOS 11+	Apple Silicon. NeuralCode ships as a tiny (~3 MB) native .dmg / .app.
git	Used for worktrees, diffs, commits and merges. Installed via the Xcode Command Line Tools if missing.
Claude Code CLI	The `claude` binary that actually runs the agents.
GitHub CLI (optional)	The `gh` binary, only needed to open pull requests.

Install the app#

1
Download the .dmg
Grab the latest build from the download page, open the disk image, and drag NeuralCode into Applications.
2
Launch it
On first launch the app runs a startup dependency check (below) before you can create workspaces.

The setup gate (dependency check)#

On first launch NeuralCode detects whether git and the claudeCLI are present. If either is missing, the whole app is replaced by a setup screen until you resolve it — you can't run agents without them.

Welcome to NeuralCode

A couple of tools are needed before you can run agents. We'll get them set up.

Git

git 2.43.0

Claude Code CLI

not found

Install

Re-check Continue

The setup gate detects git and the Claude Code CLI and offers a one-click install for anything missing.

Tool	If missing
Git	Click Install to trigger `xcode-select --install` (the macOS Command Line Tools dialog).
Claude Code CLI	Click Install to run the official installer (`claude.ai/install.sh`), falling back to `npm install -g @anthropic-ai/claude-code`.

Use Re-check after installing — when both tools are found the gate auto-advances. Continue is only enabled once git and claude are both present.

GitHub CLI is separate

The setup gate only gates on git and claude. The optional GitHub CLI (gh) is installed later from Settings → Git and is only needed for pull requests.

Create your first workspace#

1
Open a repository
Click Open a repository… in the sidebar and choose a local git repo. It appears as a project.
2
New workspace
Press ⌘ ⇧ N (or the + next to the project). Name the task, pick a base branch, and optionally write a starting prompt.
3
Start the agent
Describe the work in the composer and send. The agent runs in the workspace's isolated branch while output streams in.

New Workspace in 2xlabs

Name

fix-login-redirect

Base branch

main

Branch code-agents/fix-login-redirect from main, in a new worktree.

Task for the agent (optional)

Describe what Claude Code should do in this workspace…

CancelCreate Workspace

Creating a workspace branches a new git worktree from your chosen base branch.

Read Workspaces & worktrees to understand the isolation model, then The agent chat for the composer, models and slash commands.

Introduction

How it's built