Metadata-Version: 2.4
Name: akritrim-colab
Version: 0.1.9
Summary: Three-party AI collaboration TUI for Codex, Claude, and the user
Project-URL: Homepage, https://github.com/akritrim/akritrim-colab
Project-URL: Issues, https://github.com/akritrim/akritrim-colab/issues
Author: Chandan Ranjan
License: MIT
Keywords: ai,claude,codex,collaboration,tui
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Software Development :: User Interfaces
Requires-Python: >=3.11
Requires-Dist: rich>=13.0.0
Requires-Dist: textual>=1.0.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Description-Content-Type: text/markdown

# 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](https://docs.anthropic.com/en/docs/claude-code) and [Codex CLI](https://github.com/openai/codex) installed and authenticated.

## Install

```bash
pip install akritrim-colab
```

Or, for an isolated CLI install:

```bash
pipx install akritrim-colab
```

## Quick Start

```bash
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

```bash
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
```
