akritrim-colab 0.1.7

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

akritrim-colab

akritrim-colab is a Textual-based collaboration TUI for running a User / Codex / Claude workflow inside any repository.

Requires Claude CLI and Codex CLI to be installed and authenticated before use.

Install

cd akritrim-colab
pipx install .

or

cd akritrim-colab
uv tool install .

Use In Any Repo

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

Default behavior:

• if collaboration files are missing, scaffold them into .collab/
• then launch the TUI

Explicit commands are still available:

akritrim-colab init
akritrim-colab run

Useful run options:

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

How To Use The TUI

When the TUI starts:

• the left pane is the shared session chat
• the upper-right pane is Claude
• the lower-right pane is Codex
• the bottom box is the Master input

Input behavior:

• Enter sends the current Master message
• Ctrl+Enter inserts a newline

Master can route a message directly:

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

The built-in work commands are:

/fix <bug>
/audit <target>
/feature <description>
/refactor <target>
/analyze <question>
/decide <text>

Other useful commands:

/approve
/deny
/compare
/status
/save
/exit
/theme <name>

What the built-in commands do:

• /fix runs a bug-fix flow
• /audit runs an independent review/comparison flow
• /feature drives design then implementation
• /refactor maps call sites and verifies the refactor
• /analyze compares Codex and Claude positions
• /decide writes a decision to collaboration memory

Approval flow:

• if an agent needs Master input, the app pauses and surfaces the request
• reply with /approve or /deny

Diff viewer:

• after each agent turn, ▶ [DIFF] <file> links appear inline in that agent's pane for every file the agent changed during that turn
• only files that actually changed in the turn are shown — not all uncommitted changes
• each diff link is permanently bound to the exact patch from its own turn — even if the same file is edited again later, the old link still opens the old diff
• click a diff link to open a full-screen overlay with the complete patch, color-coded (+ green, - red, @@ cyan)
• click ⎘ Copy in the overlay to copy the raw diff text to the clipboard
• click X to close the overlay
• diff links accumulate in the scrollback, so you can review any previous turn's changes

Themes:

/theme akritrim    # default
/theme nord
/theme dracula
/theme solarized

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

Legacy layout support:

akritrim-colab --legacy
akritrim-colab run --legacy

Publish To PyPI

cd akritrim-colab
python -m build
python -m twine upload dist/*