xbrain
v0.1.5
Published
A local-first multi-agent chat TUI for Codex, Claude Code, and Gemini.
Readme
XBrain
A local-first multi-agent chat TUI for running a human, Codex, Claude Code, and Gemini in the same room.
Features
- Local-first session storage
- Explicit mentions route turns:
@codex,@claudecode,@gemini - Unmentioned turns use orchestrated lead selection
- Automatic agent availability tracking
- Ink-based terminal UI
Architecture
src/core: orchestration, routing, transcript, and session logicsrc/adapters: CLI discovery and adapter contractssrc/storage: local session and event persistencesrc/app.ts: Ink app shell
Development
Requirements:
- Node.js 22+
- Yarn
- Installed local CLI tools for any agents you want to use
Install:
npm install -g xbrainxbrain
Commands:
yarn devyarn testyarn smoke
The runtime path uses Node.js native type stripping, so the app can run TypeScript sources directly on Node 22.
Release
- Update
package.jsonto the release version onmain - Push the commit to
main - Create and push a tag like
v0.1.1 - The
publish.ymlGitHub Actions workflow will validate the tag and publish to npm
