devchain-cli 0.17.2 → 0.19.0

package/README.md

@@ -1,127 +1,98 @@
-# Devchain
+<p align="center">
+  <a href="https://devchain.cc"><img src=".github/assets/hero-banner.png" alt="DevChain — run a team of AI coding agents, on your machine" width="100%"></a>
+</p>
 
-> AI agent orchestration platform for software development teams
+<p align="center">
+  <a href="https://github.com/twitech-lab/devchain/releases"><img src="https://img.shields.io/github/v/release/twitech-lab/devchain?style=flat-square&color=6366f1" alt="Latest release"></a> <a href="https://www.npmjs.com/package/devchain-cli"><img src="https://img.shields.io/npm/v/devchain-cli?style=flat-square&color=8b5cf6" alt="npm version"></a> <a href="LICENSE"><img src="https://img.shields.io/badge/license-Elastic--2.0-blue?style=flat-square" alt="License: Elastic 2.0"></a> <a href="https://devchain.cc"><img src="https://img.shields.io/badge/docs-devchain.cc-6366f1?style=flat-square" alt="Documentation"></a>
+</p>
 
-[![npm version](https://img.shields.io/npm/v/devchain-cli)](https://www.npmjs.com/package/devchain-cli)
-[![License: Elastic-2.0](https://img.shields.io/badge/license-Elastic--2.0-blue)](LICENSE)
+<p align="center">
+  <b><a href="#quick-start">Quick Start</a></b> · <b><a href="https://devchain.cc/docs/quick-start-guide/">Docs</a></b> · <b><a href="#mobile-app">Mobile App</a></b> · <b><a href="https://github.com/twitech-lab/devchain/releases">Releases</a></b>
+</p>
 
-**[Homepage](https://devchain.cc/)** · **[Quick Start Guides](https://devchain.cc/docs/quick-start-guide/)** · **[What's New in v0.15.0](https://devchain.cc/releases/0.15.0/)**
+DevChain is a local-first orchestrator for AI coding agents. It runs Claude Code, Codex, OpenCode, Antigravity, and GitHub Copilot as coordinated teams — each agent in its own real tmux terminal, sharing a board of epics, a chat, and a code-review flow. You describe the work, the teams plan and build it in parallel, and you review and merge from the web UI — with an end-to-end-encrypted mobile app to keep an eye on everything when you step away.
 
-Devchain runs your AI coding agents as coordinated teams — each with their own terminal session, task queue, and chat. Group agents under team leads, assign epics, track progress on a visual board, and let teams scale themselves to match the workload. Supports Claude Code, Codex, OpenCode, Antigravity, and GitHub Copilot out of the box.
+## Key features
 
----
+- **Teams that manage themselves** — the Builders team adds Coders when work piles up and picks the right model per task: cheaper models for routine changes, top-tier models for harder work. The Planning team researches plans from several angles in parallel before you approve them.
+- **Real terminals, live** — every agent runs in a tmux session streamed to your browser with full TTY support. Watch it work, scroll back, or take over at any moment.
+- **A board agents actually use** — kanban-style epics and sub-epics with drag-and-drop; agents pick up tasks and update statuses themselves through MCP tools.
+- **Code review built in** — live pre-commit diff viewer with inline comments, `@mentions`, and threading, wired into the agent workflow.
+- **Session reader and context tracking** — full transcript viewer for all five providers, with per-turn token usage, cost tracking, and compaction events; live context-window bars for every agent.
+- **Skills and MCP** — sync community skill packs (Anthropic, OpenAI, Vercel, and more) and expose them to agents; the full MCP toolset is auto-configured before each session.
+- **Local-first** — everything lives in a local SQLite database and runs on your machine, with your provider accounts and keys.
 
-## Features
+<p align="center">
+  <img src=".github/assets/screenshot-chat-terminal.png" alt="DevChain chat with agent teams on the left and a Brainstormer session streaming in a real terminal on the right" width="100%">
+</p>
 
-### Agent Teams
-Group agents into named teams with team leads that do real management. The **Builders** team grows itself with the workload and picks the right model for each task — cheaper models for routine changes, top-tier models for harder work. The **Planning** team supports parallel planning: add multiple Architects on different models and the Brainstormer gathers independent framings from each before drafting the master plan. Choose your allowed providers per team when you create the project.
+## Supported providers
 
-### Mobile App
-Drive and monitor your agent teams from your phone, in open beta on [iOS](https://testflight.apple.com/join/VSbfE1c6) and [Android](https://play.google.com/apps/testing/com.twitech.devchain.mobile). Chat with agents, answer their AskUserQuestion prompts, reassign epics and add comments on the board, watch a live terminal viewport, and get push notifications the moment a session stops or needs your input. Everything between your PC and phone is end-to-end encrypted: the cloud relay only forwards sealed data it can't read, so your transcripts and commands stay private. Smart notifications, quiet hours, and per-project forwarding keep the noise down.
+| Provider | CLI | Sessions | Transcripts |
+|----------|-----|:--------:|:-----------:|
+| [Claude Code](https://claude.ai/claude-code) | `claude` | ✔ | ✔ |
+| [Codex](https://github.com/openai/codex) | `codex` | ✔ | ✔ |
+| [OpenCode](https://github.com/opencode-ai/opencode) | `opencode` | ✔ | ✔ |
+| [Antigravity](https://antigravity.google) | `agy` | ✔ | ✔ |
+| [GitHub Copilot](https://github.com/github/copilot-cli) | `copilot` | ✔ | ✔ |
 
-### 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.
+Model families such as GLM are available through per-provider configs, and you can switch the provider or model of any agent on the fly.
 
-### 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.
+## Quick start
 
-### 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](https://github.com/orgs/TwiTech-LAB/packages/container/package/devchain). Each container has Claude Code, Codex, and Antigravity 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, OpenCode, Antigravity, and GitHub Copilot — plus model families like GLM through provider configs. 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 is stored in a local SQLite database and the platform runs entirely on your machine. No cloud account is required to use it. If you opt into the mobile app, your PC and phone connect through an end-to-end encrypted relay, so even then your plaintext data never leaves your devices.
-
----
-
-## 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:
-  - [`claude`](https://claude.ai/claude-code) CLI
-  - [`codex`](https://github.com/openai/codex) CLI
-  - [`opencode`](https://github.com/opencode-ai/opencode) CLI
-  - [`agy`](https://antigravity.google) CLI (Google Antigravity)
-  - [`copilot`](https://github.com/github/copilot-cli) CLI (GitHub Copilot)
-
----
-
-## Installation
+Requirements: **Node.js 24 LTS or newer**, **tmux** (`brew install tmux` / `sudo apt install tmux`), and at least one provider CLI from the table above.
 
 ```bash
 npm install -g devchain-cli
+devchain start
 ```
 
----
+The browser opens automatically. Create a project, import a template, and start the Brainstormer session with a description of what you want to build. Run `devchain start --help` for ports, host binding, and foreground mode; `devchain stop` shuts the server down.
 
-## Quick Start
+### Native installation
 
-```bash
-# Start Devchain — opens browser automatically
-devchain start
+`better-sqlite3` v13 ships bundled Node-API artifacts, so mainstream supported installations do not need a C/C++ compiler for SQLite. DevChain's postinstall check opens an in-memory database, executes a query, and closes it; an unusable artifact now fails installation instead of only printing a diagnostic. Set `DEVCHAIN_SKIP_POSTINSTALL=1` only when intentionally bypassing that verification.
 
-# Start with a specific project
-devchain start --project /path/to/your/project
+CI executes the application and SQLite checks on Linux x64 with Node 24, plus a focused Node 26 compatibility lane. Published binaries or image manifests for other platform/architecture combinations prove artifact presence only; they are not runtime-execution evidence for macOS, Windows, or arm64.
 
-# Run in foreground with logs
-devchain start --foreground
+| Template | Agents | Best for |
+|----------|--------|----------|
+| `teams-dev` **(recommended)** | Planning team (Brainstormer + Architect), Builders team (Epic Manager + Coders), Code Reviewer | Auto-scaling Builders, parallel planning, tier-aware model routing |
+| `3-agents-dev` | Brainstormer, SubBSM, Coder | Faster iteration with lower token overhead |
 
-# Bind to all interfaces for VM/remote browser access
-devchain start --host 0.0.0.0
+## How it works
 
-# Stop the server
-devchain stop
+```mermaid
+graph LR
+    Browser["Web UI<br/>(React)"] -->|HTTP + Socket.IO| App["Local App<br/>(NestJS + Fastify)"]
+    App --> DB[("SQLite<br/>local storage")]
+    App <-->|tmux / PTY| Sessions["Agent terminal sessions"]
+    Sessions --- CLIs["Provider CLIs<br/>claude · codex · opencode · agy · copilot"]
+    CLIs <-->|MCP tools| App
+    Mobile["Mobile app<br/>(iOS / Android)"] <-->|E2EE relay<br/>sealed data only| App
 ```
 
-On first run, import a template from the project page to provision your agent team. Two templates are included:
+The Local App serves the web UI and stores all state in a local SQLite database. Agents run as provider CLIs inside tmux sessions and coordinate through DevChain's MCP tools — epics, chat, reviews, skills, and team management. The optional mobile app connects through an end-to-end-encrypted relay: the cloud only forwards sealed data it cannot read.
 
-| Template | Agents | Best for |
-|----------|--------|----------|
-| `teams-dev` **(recommended)** | Planning team (Brainstormer + Architect), Builders team (Epic Manager + Coders), Code Reviewer | New projects — auto-scaling Builders, parallel planning, tier-aware routing |
-| `3-agents-dev` | Brainstormer, SubBSM, Coder | Faster iteration with lower token overhead |
+## Mobile app
+
+Monitor and steer your agent teams from your phone, in open beta on [iOS (TestFlight)](https://testflight.apple.com/join/VSbfE1c6) and [Android (Play Store)](https://play.google.com/apps/testing/com.twitech.devchain.mobile). Chat with agents, answer their questions the moment they ask, reassign epics and comment on the board, watch a live terminal viewport, and get push notifications when a session stops or needs you. Reviewing and merging stay on the web — the phone is your mission control on the go. Everything between your PC and phone is end-to-end encrypted.
+
+## Resources
+
+- [Homepage](https://devchain.cc) — product overview and screenshots
+- [Quick Start Guides](https://devchain.cc/docs/quick-start-guide/) — visual step-by-step setup for both templates
+- [Releases](https://github.com/twitech-lab/devchain/releases) — versioned release notes
+- [Contributing](CONTRIBUTING.md) — development setup and project structure
 
----
+## Community and support
 
-## CLI Options
+Questions, bug reports, and feature requests are welcome in [GitHub Issues](https://github.com/twitech-lab/devchain/issues). Watch [Releases](https://github.com/twitech-lab/devchain/releases) to follow what ships.
 
-| Option | Description |
-|--------|-------------|
-| `-p, --port <number>` | Port to run on (default: 3000 or next available) |
-| `--host <address>` | Bind address (default: `127.0.0.1`; use `0.0.0.0` for remote/VM access — see [docs/setup.md](docs/setup.md)) |
-| `-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 |
+## Contributing
 
----
+Development setup, prerequisites, and project structure live in [CONTRIBUTING.md](CONTRIBUTING.md). Issues and pull requests are welcome.
 
 ## License
 
-[Elastic License 2.0](LICENSE) — Free to use. You may not provide this software as a managed service or competing commercial offering.
+Free and source-available under the [Elastic License 2.0](LICENSE). You may use, copy, and modify DevChain freely; you may not provide it as a managed service or a competing commercial offering.

package/dist/drizzle/0067_remove_claude_1m_provider_state.sql

@@ -0,0 +1,3 @@
+DROP TABLE `provider_probe_proofs`;--> statement-breakpoint
+ALTER TABLE `providers` DROP COLUMN `auto_compact_threshold_1m`;--> statement-breakpoint
+ALTER TABLE `providers` DROP COLUMN `one_million_context_enabled`;

package/dist/drizzle/0068_claude_launch_settings_json.sql

@@ -0,0 +1 @@
+ALTER TABLE `providers` ADD `claude_launch_settings_json` text;