akritrim-colab 0.1.9

Three-party AI collaboration TUI for Codex, Claude, and the user

akritrim-colab

A three-pane collaboration TUI that puts you between Claude and Codex inside any repository. You direct, they implement and review.

Requires Claude CLI and Codex CLI installed and authenticated.

Install

pip install akritrim-colab

Or, for an isolated CLI install:

pipx install akritrim-colab

Quick Start

cd /path/to/your-repo
akritrim-colab

On first run, collaboration files are scaffolded into .collab/. Then the TUI launches.

Layout

Pane	Contents
Left	Shared session chat
Upper right	Claude
Lower right	Codex
Bottom	Master input

• Enter — send message
• Ctrl+Enter — insert newline

Commands

Route to an agent:

@claude propose a UI improvement
@codex review the current changes
@both compare these two approaches

Structured work flows:

/fix <bug>           bug-fix: Claude isolates → Codex patches → Claude reviews
/audit <target>      independent review + comparison round
/feature <desc>      design then implementation
/refactor <target>   maps call sites, verifies the refactor
/analyze <question>  Claude and Codex compare positions
/decide <text>       writes a decision to collaboration memory

Session commands:

/status        show current session state
/compare       run a comparison round between agents
/approve       approve a pending agent request
/deny          deny a pending agent request
/save          persist session state
/exit          exit the TUI

Diff Viewer

After each agent turn, ▶ [DIFF] <file> links appear inline for every file the agent changed. Each link is permanently bound to the exact patch from that turn — later edits to the same file do not overwrite earlier history.

• Click a link to open a full-screen diff overlay (color-coded: + green, - red, @@ cyan)
• Click ⎘ Copy to copy the raw diff to the clipboard
• Click X to close

Themes

/theme akritrim    (default)
/theme nord
/theme dracula
/theme solarized

The active theme is saved to settings.toml and restored on next launch.

Run Options

akritrim-colab run --codex-role reviewer --claude-role implementer
akritrim-colab run --claude-model claude-opus-4-5
akritrim-colab run --debug-log .collab/session/tui_debug.log