Skip to main content
The Codaph CLI provides a comprehensive set of commands for managing project memory, syncing agent activity, and viewing session timelines.

​
Command Categories

​
Onboarding

Initialize and configure Codaph for your projects:
  • codaph setup - Global configuration (API keys, actor ID)
  • codaph init - Per-project initialization

​
Daily Use

Core workflow commands for regular development:
  • codaph pull - Sync cloud activity to local (daily workflow)
  • codaph sync - Compatibility alias for codaph pull
  • codaph status - View repo sync and automation status
  • codaph tui - Interactive TUI for browsing sessions

​
Push / Backfill

Import local agent history into Codaph:
  • codaph push - Import agent history (Codex/Claude/Gemini) to Mubit
  • codaph import - Compatibility alias for codaph push
  • codaph repair cloud - Repair missing cloud sync

​
Advanced

Legacy compatibility and advanced workflows:
  • codaph sync all|pull|status|setup - Advanced sync modes
  • codaph sync push - Compatibility alias for codaph push
  • codaph run|exec - Codex capture wrappers
  • codaph mcp - MCP stdio server for agents/tools
  • codaph sessions|timeline|diff|inspect - Query and inspect sessions
  • codaph doctor - Diagnostic information
  • codaph hooks run - Hook automation triggers

​
Common Patterns

​
Basic Workflow

# One-time setup
codaph setup --mubit-api-key <key>
codaph init

# Daily use
codaph pull      # Sync cloud -> local
codaph tui       # Browse sessions

​
First-time Backfill

# After init, optionally import historical agent sessions
codaph push

​
Hook-triggered Automation

# Runs automatically after git commit (if enabled during init)
codaph hooks run post-commit --quiet

# Runs automatically after agent completion (if configured)
codaph hooks run agent-complete --provider codex --quiet

​
Global Flags

Most commands support these flags:
​
--cwd
string
Working directory (defaults to current directory)
​
--json
boolean
default:"false"
Output JSON for programmatic use
​
--mubit-api-key
string
Override Mubit API key (or use MUBIT_API_KEY env var)
​
--mubit-project-id
string
Override Mubit project ID
​
--mubit-actor-id
string
Override Mubit actor ID
​
--openai-api-key
string
OpenAI API key for agent-assisted queries (or use OPENAI_API_KEY env var)

​
Exit Codes

  • 0 - Success
  • 1 - Error (command failed, invalid arguments, or sync error)
  • Non-zero - System error or exception

​
Version

codaph --version
Displays the installed Codaph CLI version.

​
Help

codaph --help
codaph <command> --help
Shows command-specific help text.

Build docs developers (and LLMs) love

Get started for freeTalk to us