Skip to content

A-SOM/devchain

 
 

Repository files navigation

Devchain

AI agent orchestration platform for software development teams

npm version License: Elastic-2.0

Homepage · Quick Start Guide (PDF) · What's New in v0.11.0

Devchain runs your AI coding agents as a coordinated team — each with their own terminal session, task queue, and chat. Assign epics, track progress on a visual board, and let agents collaborate through a structured workflow. Supports Claude Code, Codex, Gemini CLI, and OpenCode out of the box.


Features

Session Reader

Full transcript viewer for active agent sessions, built into the Chat page. See every tool call, thinking block, and response with real-time token usage, cost tracking, and compaction events. Supports Claude Code and Codex transcripts with AI turn grouping, collapsible cards, IQR-based token hotspot detection, and keyboard navigation.

Context Tracking

Visual progress bars show each agent's context window usage in real time. Hover for exact token counts (e.g. "49% used — 98k of 200k"). An inline session summary bar in each terminal shows the active model, running cost, context percentage, and compaction count at a glance.

Provider Model Override

Change any agent's provider and model on the fly from the context menu — no template editing required. Model overrides are per-agent and persist across restarts, layering on top of template defaults.

Worktrees

Spin up isolated agent environments on dedicated git branches. Each worktree gets its own agent team, terminals, and chat — run multiple features in parallel and merge when ready. Worktrees run as Docker containers or local processes with full branch isolation.

Container Isolation

Worktree containers are provisioned automatically from the official Devchain image on GHCR. Each container has Claude Code, Codex, and Gemini CLI pre-installed, runs as a non-root user, and shares your git identity for correct commit attribution.

Skills

Browse and sync AI agent skills from community sources (Anthropic, OpenAI, Vercel, and more). Enable or disable skills per project and expose them to agents via MCP tools.

Visual Workflow Board

Kanban-style epic management with drag-and-drop, list view, board context menu, and URL-based filtering. Agents pick up tasks from the board and update status in real time.

Terminal Sessions

Real terminal streaming via tmux and WebSocket. Each agent gets its own session with scrollback, resize support, and inline access from the chat panel.

Code Review

Live pre-commit diff viewer with agent integration, inline comments, @mentions, comment threading, and VS Code-style file navigation.

Multi-Provider

Works with Claude Code, OpenAI Codex, Google Gemini CLI, GLM models, and OpenCode. Switch providers per agent or switch the whole team preset with a single click.

MCP Integration

Full Model Context Protocol support. Agents get access to epics, chat, skills, reviews, and more through MCP tools — auto-configured before each session.

Local-First

All data stored in a local SQLite database. No cloud account required, no data leaving your machine.


Requirements

  • Node.js >= 20
  • tmux — required for terminal sessions
    • macOS: brew install tmux
    • Ubuntu/Debian: sudo apt install tmux
  • Docker — optional, required for container-isolated worktrees
  • AI Provider — at least one of:

Installation

npm install -g devchain-cli

Quick Start

# Start Devchain — opens browser automatically
devchain start

# Start with a specific project
devchain start --project /path/to/your/project

# Run in foreground with logs
devchain start --foreground

# Stop the server
devchain stop

On first run, import a template from the project page to provision your agent team. Two templates are included:

Template Agents Best for
5-agents-dev Brainstormer, Epic Manager, SubBSM, Coder, Code Reviewer Complex projects with full planning
3-agents-dev Brainstormer, SubBSM, Coder Faster iteration with lower token overhead

CLI Options

Option Description
-p, --port <number> Port to run on (default: 3000 or next available)
-f, --foreground Run in foreground with visible logs
--no-open Don't open browser automatically
--db <path> Custom database directory path
--project <path> Open with a specific project path

License

Elastic License 2.0 — Free to use. You may not provide this software as a managed service or competing commercial offering.

About

No description, website, or topics provided.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • TypeScript 93.6%
  • HTML 5.4%
  • Other 1.0%