Skip to main content

​
What is Codaph?

Codaph is a terminal-first CLI/TUI for inspecting coding-agent activity with shared Mubit-backed memory. When you’re working with AI coding agents like Codex, Claude Code, or Gemini CLI, Codaph helps you understand the story behind your code changes.

The Problem

With agentic coding tools, teams ship faster than ever but lose track of the story. Who prompted this? Why did the agent make that change? Without context, onboarding new engineers or understanding past decisions becomes difficult.

The Solution

Codaph bridges the gap by capturing agent sessions, prompts, thoughts, and diffs in a local mirror and syncing them to Mubit for shared collaborative memory. Your team gets a VCS for the code story while agents handle the implementation.

​
Key Features

Multi-Agent Support

Works with Codex (OpenAI), Claude Code (Anthropic), and Gemini CLI (Google). Detect and sync multiple agents automatically.

Terminal UI

Browse sessions, prompts, thoughts, and file diffs in a powerful TUI. No browser required - stay in your terminal workflow.

Mubit Memory

Shared cloud memory and semantic query powered by Mubit. Query across sessions with codaph mubit query "what changed in auth?"

Automatic Sync

Git hooks and agent-complete hooks trigger automatic syncs. Push to Mubit on commit, pull cloud activity on sync.

Local-First

Append-only JSONL mirror under .codaph/ for deterministic timeline rendering. Works offline, syncs when ready.

MCP Integration

Expose Codaph data to Claude Code via MCP. Agents can inspect sessions, timelines, and diffs programmatically.

​
Architecture Overview

Codaph uses a dual-store architecture:
1

Local JSONL Mirror

Append-only event store under .codaph/ for deterministic timeline/diff rendering. Always available, works offline.
2

Mubit Cloud Memory

Shared collaborative backend for cross-contributor context and semantic query. Enables team collaboration and AI-powered insights.
3

Query & Visualization

QueryService reads the local mirror for sessions, timelines, and diffs. TUI/CLI render from mirror; Mubit handles semantic Q&A.
Core Pipeline Flow: Agent Events → IngestPipeline → MirrorAppend + MubitMemoryWrite → QueryService/TUI

​
Supported Agent Providers

  • Live SDK streaming via adapter-codex-sdk.ts
  • JSON exec output via adapter-codex-exec.ts
  • History import from .codex/ directory
  • Marker directory: .codex/

​
Use Cases

When multiple engineers work in parallel with various coding agents, Codaph provides a shared view of who prompted what and why. Everyone syncs to the same Mubit project for unified context.
New team members can query Mubit to understand past decisions: codaph mubit query "why did we refactor auth?"The semantic layer helps avoid cold-start problems when joining a project mid-development.
Browse agent sessions in the TUI to see prompts, reasoning, and diffs. Understand not just what changed, but why the agent made those choices.
Backfill local agent history with codaph import to analyze patterns across months of development. Track how agents evolved your codebase over time.

​
Why Mubit?

Semantic Layer for Your Code

Mubit provides the semantic memory layer that makes Codaph collaborative:
  • Shared context across team members
  • Semantic query beyond grep/text search
  • Project-scoped runs for unified team memory
  • Actor tracking to attribute changes
  • Timeline sync for distributed teams
Without Mubit, Codaph works as a local-only inspector. With Mubit, it becomes a team collaboration platform.
Get your Mubit API key from console.mubit.ai to enable cloud sync and shared memory.

​
Getting Started

Installation

Install Codaph via npm, npx, or from source with bun.

Quickstart Guide

Get from zero to your first working sync and TUI session in minutes.

CLI Reference

Complete command reference for all Codaph CLI operations.

TUI Guide

Learn keyboard shortcuts and navigation in the terminal UI.

​
System Requirements

  • Node.js 18 or higher
  • Git (for auto-detection of project metadata)
  • Mubit API key (for cloud sync and shared memory)
  • Coding agent CLI (Codex, Claude Code, or Gemini CLI)
  • OpenAI API key (optional, for enhanced query/chat)
Codaph is in beta and can break. Be mindful when using in production environments.

​
Community & Support

GitHub Repository

Star the repo, report issues, and contribute code.

Mubit Console

Create your Mubit API key and manage projects.

​
Next Steps

1

Install Codaph

Choose your installation method: npm, npx, or from source.Installation Guide →
2

Follow the Quickstart

Get your Mubit API key, run codaph init, and open the TUI.Quickstart →
3

Set up MCP (Optional)

Connect Claude Code via MCP for programmatic access to Codaph data.MCP Setup →

Build docs developers (and LLMs) love

Get started for freeTalk to us