Conduit

A multi-agent Terminal User Interface (TUI) for orchestrating AI coding assistants. Run Claude Code and Codex CLI side-by-side with tab-based session management.

Features

• Multi-Agent Support - Seamlessly switch between Claude Code and Codex CLI
• Tab-Based Sessions - Run multiple concurrent agent sessions (up to 10 tabs)
• Real-Time Streaming - Watch agent responses as they're generated
• Token Usage Tracking - Monitor input/output tokens and estimated costs
• Session Persistence - Resume previous sessions with their full context
• Rich Terminal UI - Markdown rendering, syntax highlighting, and animations

Installation

Prerequisites

• Rust 1.70+ (for building from source)
• At least one supported agent installed:
  • Claude Code (claude binary)
  • Codex CLI (codex binary)

Build from Source

git clone https://github.com/conduit-cli/conduit.git
cd conduit
cargo build --release

The binary will be available at target/release/conduit.

Usage

# Start the TUI
conduit

# Debug keyboard input (useful for troubleshooting keybindings)
conduit debug-keys

Keyboard Shortcuts

Shortcut	Action
Ctrl+N	New project (opens project picker)
Alt+Shift+W	Close current tab
Tab / Shift+Tab	Switch to next/previous tab
Alt+1-9	Jump to specific tab
Alt+Shift+F†	Fork current session
/fork (slash menu)	Fork current session
Enter	Submit prompt
Shift+Enter or Alt+Enter	Add newline in input
Ctrl+C	Interrupt agent
Ctrl+Q	Quit
Ctrl+T	Toggle sidebar
Ctrl+G	Toggle view mode (Chat/Raw Events)
Ctrl+O	Show model selector
Ctrl+\	Toggle Build/Plan mode*
Alt+I	Import session
? or :help	Show help

* Note on Ctrl+\: Terminal emulators vary in how they report this key combination. Some terminals send it as Ctrl+4. Use conduit debug-keys to verify how your terminal reports this shortcut. If it doesn't work, you can customize the keybinding in your config. † Note on Alt+Shift+F: Some terminals don't emit distinct Alt+Shift combos. Use conduit debug-keys to verify how your terminal reports this shortcut and override the keybinding in your config if needed.

Architecture

src/
├── main.rs              # Entry point
├── lib.rs               # Library exports
├── agent/               # Agent integration layer
│   ├── runner.rs        # AgentRunner trait
│   ├── events.rs        # Unified event types
│   ├── stream.rs        # JSONL stream parser
│   ├── claude.rs        # Claude Code implementation
│   ├── codex.rs         # Codex CLI implementation
│   ├── models.rs        # Model registry and pricing
│   ├── session.rs       # Session metadata
│   └── history.rs       # History loading utilities
├── config/              # Configuration
│   ├── settings.rs      # App settings and pricing
│   ├── keys.rs          # Keybinding types and parsing
│   └── default_keys.rs  # Default keybindings
├── data/                # Data persistence
│   ├── database.rs      # SQLite database
│   ├── repository.rs    # Data access layer
│   └── workspace.rs     # Workspace management
├── session/             # Session management
│   ├── cache.rs         # Session caching
│   └── import.rs        # Session import from agents
├── git/                 # Git integration
│   ├── pr.rs            # PR operations
│   └── worktree.rs      # Worktree utilities
├── util/                # Utilities
│   ├── paths.rs         # Path helpers
│   └── names.rs         # Name generation
└── ui/                  # Terminal UI
    ├── app.rs           # Main event loop
    ├── action.rs        # Action definitions
    ├── events.rs        # Input mode handling
    ├── tab_manager.rs   # Tab orchestration
    ├── session.rs       # Per-tab state
    └── components/      # UI components
        ├── chat_view.rs
        ├── input_box.rs
        ├── sidebar.rs
        ├── status_bar.rs
        ├── tab_bar.rs
        └── ...

Supported Agents

Claude Code

Spawns the claude binary in headless mode with streaming JSON output:

• Real-time event streaming
• Tool execution (Read, Edit, Write, Bash, Glob, Grep)
• Session resumption

Codex CLI

Spawns the codex binary with structured JSON output:

• Full automation mode
• Session persistence
• Event-based communication

Configuration

Default settings in src/config/settings.rs:

Setting	Default
Default agent	Claude Code
Max tabs	10
Show token usage	Yes
Show cost	Yes

Pricing (Claude Sonnet)

• Input tokens: $3.00 / 1M tokens
• Output tokens: $15.00 / 1M tokens

Website

The landing page at getconduit.sh is built with Astro.

Development

cd website
npm install
npm run dev

The dev server runs at http://localhost:4321

Build

cd website
npm run build

Output is in website/dist/.

Deploy

The site is static and can be deployed to any hosting provider:

GitHub Pages:

cd website
npm run build
# Push dist/ to gh-pages branch or configure GitHub Actions

Netlify/Vercel:

• Connect repo and set build command to cd website && npm run build
• Set publish directory to website/dist

Manual:

cd website
npm run build
# Upload contents of dist/ to your server

License

MIT