Skip to main content

​
Overview

Codaph provides an interactive Terminal User Interface (TUI) for browsing agent sessions, inspecting prompts and thoughts, viewing file changes, and chatting with Mubit. Launch the TUI from your project directory: 
codaph tui
# or from source
bun run tui

​
Views

​
Browse View

The default view showing all captured sessions:
  • Session List: Chronological list of agent sessions with metadata
  • Grouping Modes:
    • session (default): Individual sessions
    • day: Sessions grouped by date
  • Status Indicators:
    • synced: Session has file changes
    • no_files: No file changes detected
Session Columns:
  • # - Session index
  • Timestamp - Session end time
  • Pmts - Prompt count
  • Files - Changed files count
  • Tokens - Estimated token usage
  • Agent - Provider (Codex/Claude/Gemini)
  • State - Sync status

​
Inspect View

Detailed view of a single session with multiple panes:

​
Three-Pane Mode (wide terminals)

Left to right:
  1. Prompts: List of prompts in the session
  2. Thoughts: Reasoning steps for selected prompt
  3. Diff: Code changes from selected thought

​
Split Mode (medium terminals)

Quadrant layout:
  • Top-left: Prompts
  • Top-right: Thoughts
  • Bottom-left: Files Changed
  • Bottom-right: Diff

​
Stacked Mode (narrow terminals)

Vertical layout:
  1. Prompts
  2. Thoughts
  3. Files Changed
  4. Diff

​
Keyboard Shortcuts

​
Global

​
Browse View

KeyAction
↑ / ↓Navigate sessions
EnterOpen session inspect view
gToggle grouping (session/day)
sSync now (local→cloud, then cloud→local)
rPull cloud (Mubit remote activity)

​
Inspect View

KeyAction
↑ / ↓Navigate prompts/thoughts or scroll pane
EnterFrom prompts pane → focus thoughts
TabCycle pane focus
← / →Move pane focus left/right
dToggle full diff overlay
mToggle Mubit chat
fCycle actor filter
cContributors overlay
EscBack to browse view

​
Mubit Chat

KeyAction
TypeEdit prompt
EnterSend question to Mubit
↑ / ↓Scroll chat history
EscClose chat

​
Overlays

Help Overlay (?)
  • Esc or ? to close
Settings Overlay (o)
  • Shows Mubit configuration, project settings, agent providers
  • 1 - Set Mubit API key
  • 2 - Set OpenAI API key
  • Esc or o to close
Contributors Overlay (c)
  • ↑ / ↓ - Select contributor
  • Enter - Filter prompts by selected contributor
  • Esc or c to close
Project Manager (P)
  • ↑ / ↓ - Select project
  • Enter - Switch to project
  • x - Remove project (shows confirmation)
  • 1 - Remove from registry only
  • 2 - Remove from registry + settings
  • a - Add new project
  • Esc or P to close
Project Picker (a)
  • ↑ / ↓ - Navigate directories
  • Enter - Open directory or add git repo
  • → - Open directory (without adding)
  • . - Add current directory
  • / - Type path directly
  • h - Toggle hidden files
  • Esc or a to close
Full Diff Overlay (d)
  • ↑ / ↓ - Scroll diff
  • Esc or d to close

​
Workflow Examples

1
Daily Review Workflow
2
  • Launch TUI: codaph tui
  • Press s to sync latest activity
  • Browse sessions with ↑/↓
  • Press g to group by day
  • Press Enter on a session to inspect
  • Use Tab to cycle through panes
  • Press d to view full diff
  • Press m to ask Mubit about changes
  • Press Esc to return to browse view
    • 1
    Multi-Contributor Review
    2
  • Open session in inspect view
  • Press c to open contributors overlay
  • Use ↑/↓ to select a contributor
  • Press Enter to filter prompts by that contributor
  • Review their specific prompts and thoughts
  • Press f to cycle through actor filters
  • Press c again to change filter
    • 1
    Semantic Query Workflow
    2
  • Inspect a session with interesting changes
  • Press m to open Mubit chat
  • Type your question (e.g., “what changed in auth?”)
  • Press Enter to send
  • Read Mubit’s response with context from the session
  • Continue conversation or press Esc to close

    • ​
    Status Bar

    The top status bar shows:
    • Left: Project name, Mubit status, sync automation status
    • Right: Current view hints and shortcuts
    The bottom status bar displays:
    • Sync progress during operations
    • Last sync summary (push/pull events)
    • Current view context

    ​
    Performance Tips

    Enable autoWarmTuiOnOpen to preload sessions on TUI startup:
    codaph init  # Enable during setup
# or manually in ~/.codaph/settings.json
    This triggers a background pull when TUI opens.
    Control sync automation via settings:
    • autoPullOnSync: Auto-pull cloud when syncing (default: true)
    • remotePullCooldownSec: Cooldown between auto-pulls (default: 600)
    • autoWarmTuiOnOpen: Pull on TUI startup (default: false)
    Check current settings: codaph status

    ​
    Color Scheme

    Codaph TUI uses a warm, terminal-friendly color palette:
    • Brand: Orange (#EB9752)
    • Active: Warm brown border
    • Inactive: Neutral gray
    • Selected: Highlighted background
    • Success: Green
    • Warning: Yellow
    • Error: Red
    • Info: Cyan
    Colors adapt to your terminal’s capability.

    Build docs developers (and LLMs) love

    Get started for freeTalk to us