Skip to main content
The codaph sync command is a legacy/compatibility command that combines push and pull operations.
For new workflows, use:
  • codaph pull for cloud → local sync (daily workflow)
  • codaph push for local agent history import (one-time backfill)

​
Usage

codaph sync [subcommand] [options]

​
Description

The sync command provides compatibility with older Codaph workflows. It has evolved into separate pull and push commands for clarity.

​
Default Behavior

When run without arguments:
  • Checks for queued local uploads (fast path)
  • Pulls cloud activity → local mirror
  • Skips full agent history replay (use codaph push for backfill)

​
Subcommands

​
codaph sync

Run sync workflow (push queue + pull): 
codaph sync [--cwd <path>] [--json]
Equivalent to codaph pull in most cases.

​
codaph sync pull

codaph sync pull [--cwd <path>] [--json]
Alias for: codaph pull Syncs cloud activity to local mirror.

​
codaph sync push

codaph sync push [--cwd <path>] [--json] [--local-only] [--providers <csv>]
Alias for: codaph push Imports local agent history (Codex/Claude/Gemini) to Codaph + Mubit.

​
codaph sync status

codaph sync status [--cwd <path>] [--json]
Alias for: codaph status Displays sync and automation status.

​
codaph sync setup

codaph sync setup [--cwd <path>] [--yes] [--force]
Installs or reinstalls sync automation hooks (post-commit, agent-complete).

​
codaph sync all

codaph sync all [--cwd <path>] [--json]
Runs both push (history mode) and pull.

​
Flags

​
--cwd
string
Working directory (defaults to current directory)
​
--json
boolean
default:"false"
Output JSON for programmatic use
​
--local-only
boolean
default:"false"
Disable Mubit cloud sync (local mirror only)Deprecated: Use codaph push --local-only instead
​
--providers
string
Comma-separated agent providers for push: codex,claude-code,gemini
​
--no-worktrees
boolean
default:"false"
Skip scanning git worktrees during push
​
--enable-auto
boolean
default:"false"
Enable sync automation hooks
​
--yes
boolean
default:"false"
Accept defaults without prompting (for sync setup)
​
--force
boolean
default:"false"
Reinstall hooks even if already enabled (for sync setup)

​
Migration Guide

​
Old Workflow

# Legacy pattern
codaph sync

​
New Workflow

# Modern pattern (recommended)
codaph pull      # Daily: cloud → local
codaph push      # One-time: backfill history

​
Automation Setup

# Old
codaph sync setup

# New (equivalent)
codaph init      # During project init
# OR
codaph sync setup  # Still works for existing projects

​
Examples

​
Basic Sync

codaph sync
Output: 
Push (local->cloud): no queued local uploads (fast path)
Pull (cloud->local): snapshot received=150/1200, imported=12, dedup=138, skipped=0
Automation: enabled (post-commit:on, agent-complete:on)
Fast sync: Mubit-first remote pull + repo-local queue (no global agent history replay).
Backfill history: run `codaph push` (one-time/occasional).

​
Push Agent History

# Old
codaph sync push --providers codex,claude-code

# New (recommended)
codaph push --providers codex,claude-code

​
Pull Only

# Old
codaph sync pull

# New (recommended)
codaph pull

Build docs developers (and LLMs) love

Get started for freeTalk to us