MCPcopy Index your code
hub / github.com/AgentOrchestrator/AgentBase

github.com/AgentOrchestrator/AgentBase @v1.5.0

Chat with this repo
repository ↗ · DeepWiki ↗ · release v1.5.0 ↗ · + Follow
2,181 symbols 4,566 edges 378 files 710 documented · 33%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Agent Base

Orchestrate multiple AI agents on a visual canvas — explore ideas in parallel, stay in control

When working with AI coding agents, you often want to explore multiple approaches simultaneously. Agent Base gives you a visual canvas to launch and manage multiple agents working in parallel, each with shared context but isolated edits, so they don't step on each other's toes.

Agent Base

Agent Base Agent Base

What Agent Base Does

  • Visual Canvas — Get a bird's-eye view of all your running agents. Zoom in on specific agents or zoom out to see the big picture of your parallel explorations.

  • Parallel Agent Execution — Launch multiple agents that share the same context. Explore different tasks, features, or approaches simultaneously without waiting for one to finish.

  • Isolated Edits — Choose whether agent edits are isolated from each other. Parallel agents can work on the same codebase without overwriting each other's changes.

  • Progress Tracking — Each agent's state is summarized with todo list progress and a summary of your initial request, so you can quickly understand what each agent is doing without diving into conversation logs.

  • Command Center — When multiple agents need your approval, open the command center to see all pending user requests in one place. No more switching between terminals.

Agent Base is local-first — everything runs on your machine.

MIT License GitHub Stars Last Commit Commit Activity Issues Ask DeepWiki

InstallationCommandsPreviewFeaturesIntegrations


🚀 Installation

Platform Compatibility: - ✅ macOS

Choose your preferred installation method:

📦 npm Installation

git clone https://github.com/AgentOrchestrator/agentbase.git
cd agentbase
npm install
cp .env.example .env  # Configure your environment
npm run dev

Access:

  • Desktop App: Launch the Electron desktop application

📋 Available Commands

Command Description
npm install Install all dependencies for the monorepo
npm run dev Start the desktop app in development mode with hot reload
npm run dev:desktop Start only the desktop app in development mode
npm run build Build all apps for production
npm run start Start all services in production mode (requires build first)

💡 Why We Built This

The Problem: When working with AI coding agents, we kept running into the same friction: you want to explore multiple ideas at once, but managing multiple terminal sessions is chaotic. You lose track of what each agent is doing. When several agents need your input, you're alt-tabbing between windows. And if two agents are editing the same files, they conflict.

The Solution: We built Agent Base as a visual control center for parallel agent work:

  • Canvas overview — See all your agents at a glance, zoom in on details or out for the big picture
  • Parallel exploration — Launch multiple agents with shared context to explore different approaches simultaneously
  • Isolated workspaces — Keep agent edits separate so parallel work doesn't conflict
  • Progress at a glance — Todo list progress and request summaries let you track each agent without reading logs
  • Centralized approvals — The command center collects all pending requests so you can handle them efficiently

This is the tool we wished we had: a way to orchestrate multiple AI agents visually, explore ideas in parallel, and stay in control of the chaos.


✨ Features

  • 🎨 Visual Canvas — Infinite canvas to arrange, organize, and monitor all your running agents
  • ⚡ Parallel Agents — Launch multiple agents with shared context to explore different tasks simultaneously
  • 🔀 Isolated Edits — Toggle edit isolation so parallel agents don't overwrite each other's changes
  • 📊 Progress Tracking — See todo list progress and request summaries for each agent at a glance
  • 🎛️ Command Center — Handle all pending approval requests from multiple agents in one place
  • 🤖 Multi-Agent Support — Works with Claude Code, Cursor, Codex, and more
  • 🏠 Local-First — Everything runs on your machine

🔌 Integrations

The visual canvas currently supports Claude Code with full orchestration capabilities. Any other agent runs in the canvas via the terminal. We welcome contributions to integrate additional AI coding assistants.

Canvas Support:

Integration Canvas Support Description
Claude Code ✅ Full Support Launch, monitor, and orchestrate multiple Claude Code agents on the canvas
Cursor 🤝 Contributions Welcome AI-first code editor
Codex 🤝 Contributions Welcome OpenAI's code generation model
FactoryDroid 🤝 Contributions Welcome Factory AI's coding agent
Windsurf 🤝 Contributions Welcome Codeium's AI coding assistant

Feature Support (Claude Code):

Feature Status
Visual Canvas
Parallel Agent Execution
Isolated Edits
Progress Tracking (Todo Lists)
Command Center (Approval Requests)
Shared Context

Legend: - ✅ Fully supported - 🤝 Contributions welcome

Want to help integrate your favorite AI assistant? Open an issue or contribute via PR!


⚠️ Early Stage Project

Note: We recently started building this project and it's in active development. Expect things to move fast, break occasionally, and evolve rapidly. We welcome contributions, feedback, and ideas as we shape the future of team collaboration for AI-assisted coding!


🤝 Contributing

Contributions welcome! This is a monorepo, so all code lives in one place: - Desktop App: apps/desktop/ - Shared code: packages/shared/

Please open an issue or PR in this repository!


Hai Dang & Max Prokopp

We want to build tools that enhance the experience of ai working alongside humans.

Made with ❤️ from Munich and Palo Alto

Extension points exported contracts — how you extend this code

IChatHistoryLoader (Interface)
(no doc) [8 implementers]
packages/shared/src/loaders/interfaces.ts
IStatusPersistence (Interface)
(no doc) [6 implementers]
apps/desktop/types/coding-agent-status.ts
IDatabaseLoader (Interface)
(no doc) [4 implementers]
packages/shared/src/loaders/interfaces.ts
INodeService (Interface)
(no doc) [9 implementers]
apps/desktop/src/renderer/context/node-services/types.ts
IAgentAdapter (Interface)
(no doc) [4 implementers]
packages/shared/src/hooks/adapters/base.ts
IRepresentationServiceLifecycle (Interface)
(no doc) [9 implementers]
apps/desktop/src/main/services/representation/interfaces/IRepresentationService.ts
ILoaderRegistry (Interface)
(no doc) [2 implementers]
packages/shared/src/loaders/interfaces.ts
ITitleComputer (Interface)
(no doc) [5 implementers]
apps/desktop/types/coding-agent-status.ts

Core symbols most depended-on inside this repo

log
called by 415
apps/desktop/src/instrumentation/logging/log-server.ts
getState
called by 237
apps/desktop/src/renderer/stores/IForkStore.ts
error
called by 177
apps/desktop/src/main/services/representation/implementations/RepresentationService.ts
push
called by 121
apps/desktop/src/instrumentation/logging/ring-buffer.ts
get
called by 101
apps/desktop/src/main/worktree/IWorktreeManager.ts
warn
called by 79
apps/desktop/src/main/services/representation/implementations/RepresentationService.ts
invoke
called by 72
apps/desktop/src/instrumentation/ipc-bridge.ts
on
called by 69
packages/shared/src/hooks/registry.ts

Shape

Method 918
Function 596
Interface 527
Class 136
Enum 4

Languages

TypeScript100%

Modules by API surface

packages/shared/src/types/repository.ts103 symbols
apps/desktop/src/renderer/context/node-services/types.ts39 symbols
apps/desktop/src/main/services/coding-agent/ClaudeCodeAgent.ts38 symbols
apps/desktop/src/renderer/context/node-services/coding-agent-adapter.ts37 symbols
apps/desktop/src/main/services/coding-agent/CodingAgent.ts28 symbols
apps/desktop/src/renderer/services/impl/AgentServiceImpl.ts27 symbols
apps/desktop/src/main/database/SQLiteDatabase.ts27 symbols
apps/desktop/src/main/services/representation/implementations/RepresentationService.ts26 symbols
apps/desktop/types/coding-agent-status.ts25 symbols
apps/desktop/src/renderer/stores/LinearStore.ts25 symbols
packages/shared/src/readers/cursor-reader.ts24 symbols
apps/desktop/src/renderer/services/coding-agent-adapters/ClaudeCodeAdapter.ts24 symbols

For agents

$ claude mcp add AgentBase \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact