DEV Community

Alex Chernysh
Alex Chernysh

Posted on • Originally published at bernstein.run

Getting Started: Your First Multi-Agent Run in 5 Minutes

#aicodingagentssetup #claudecodetutorial #gettingstarted #pythonclitools

This guide gets you from zero to a working multi-agent session in under 5 minutes. You'll install Bernstein, configure Claude Code as your agent, run a goal, and understand the output.

Step 1: Install Bernstein

Bernstein requires Python 3.12+. Install it with pip or uv:

pip install bernstein
Enter fullscreen mode Exit fullscreen mode

Or if you use uv:

uv pip install bernstein
Enter fullscreen mode Exit fullscreen mode

Verify the installation:

bernstein --version
# bernstein 1.8.8
Enter fullscreen mode Exit fullscreen mode

Step 2: Configure your agent

Bernstein needs at least one CLI coding agent installed. The fastest setup uses Claude Code, but 18 agents are supported including Codex, Gemini CLI, the OpenAI Agents SDK, Aider, and more.

Make sure Claude Code is installed and your API key is set:

# Install Claude Code if you haven't
npm install -g @anthropic-ai/claude-code

# Set your API key
export ANTHROPIC_API_KEY=sk-ant-...
Enter fullscreen mode Exit fullscreen mode

Bernstein auto-detects installed agents. Verify it finds yours:

bernstein agents
# Available agents:
#   claude (Claude Code) ✓
Enter fullscreen mode Exit fullscreen mode

Step 3: Run your first goal

cd into any git repository and run a goal:

cd your-project
bernstein run --goal "Add type hints to all functions in src/utils.py"
Enter fullscreen mode Exit fullscreen mode

Bernstein will:

  1. Decompose the goal into concrete tasks
  2. Assign each task a role, priority, and model
  3. Spawn agents in isolated git worktrees
  4. Monitor progress via heartbeats and output parsing
  5. Merge completed work back to your branch

Step 4: Read the TUI

The terminal UI shows live progress:

┌─ Bernstein v1.8.8 ─────────────────────────────────┐
│ Goal: Add type hints to all functions in src/utils  │
│ Tasks: 3 total │ 1 running │ 1 done │ 1 pending    │
│ Agents: 2 active │ Cost: $0.12                      │
├─────────────────────────────────────────────────────┤
│ ✓ task-001  Analyze existing type usage    00:42    │
│ ► task-002  Add type hints to helpers      01:15    │
│ ○ task-003  Add type hints to validators   pending  │
└─────────────────────────────────────────────────────┘
Enter fullscreen mode Exit fullscreen mode
  • ✓ = completed and merged
  • ► = currently running
  • ○ = pending (waiting for dependencies or an available agent)

Press q to stop gracefully (agents finish their current task) or Ctrl+C to force stop.

Step 5: Check the results

When all tasks complete, check what changed:

git log --oneline -5
# a1b2c3d Add type hints to validator functions
# d4e5f6g Add type hints to helper functions
# h7i8j9k Analyze existing type usage in src/utils.py
Enter fullscreen mode Exit fullscreen mode

Each agent's work is a separate commit, merged through Bernstein's merge queue. If any task failed, its changes are rolled back and the failure is logged in .sdd/dead_letter.json.

What to try next

Run a YAML plan for structured, multi-stage projects:

bernstein run plans/my-project.yaml
Enter fullscreen mode Exit fullscreen mode

Plans let you define stages, dependencies, roles, and complexity per task. See the plan file docs for the full schema.

Use multiple agent types by installing additional adapters:

# Bernstein will route tasks to the best available agent
pip install codex-cli  # or install any supported agent
bernstein agents       # see all detected agents
Enter fullscreen mode Exit fullscreen mode

Monitor costs across sessions:

bernstein cost
# Session total: $0.47
# By model: haiku=$0.03, sonnet=$0.28, opus=$0.16
Enter fullscreen mode Exit fullscreen mode

Check the API for programmatic access:

# Task server runs on port 8052 during sessions
curl http://127.0.0.1:8052/status
Enter fullscreen mode Exit fullscreen mode

Further reading

Top comments (0)