CLI Reference

The digital-me CLI installs, diagnoses, and orchestrates the ecosystem. Run any command with --help for this text — it is extracted verbatim from the CLI source on every release, so it cannot go stale.

Commands

Full usage

digital-me — install, doctor, and orchestrate the digital-me ecosystem.

Usage:
  digital-me setup [--wiki-root <path>] [--minimal] [--skip-openclaw-check]
    One-shot: detect CLIs, init wiki dir, install runtimes, link the
    `digital-me` command onto PATH, doctor. Requires openclaw (the
    mandatory foundation) — hard-stops with install guidance if it's
    missing. --minimal skips the heavy optional services (dream-cycle
    Python venv + dashboard build); --skip-openclaw-check bypasses the
    prerequisite gate (advanced / CI).

  digital-me init [--wiki-root <path>]
    Scaffold wiki/, inbox/, .cache/, config.example.yaml.

  digital-me doctor [--runtime <id>...]
    Diagnose the environment.

  digital-me install --runtime <id> [--runtime <id>...] [--no-service]
    Install a specific runtime adapter. For --runtime dashboard, also
    sets up an always-on service (launchd/systemd) so the dashboard
    survives closing the terminal + reboot; --no-service skips that.

  digital-me service dashboard <install|uninstall|status>
    Manage the always-on dashboard service (cross-platform: launchd on
    macOS, systemd --user on Linux). 'install' generates + loads the unit
    anchored at the stable install symlink and verifies it serves.

  digital-me update --runtime openclaw [--dry-run] [--skip-restart]
                    [--repo-dir <path>] [--tag-maturity-hours <n>] [--pnpm-spec <spec>]
    Update openclaw to the latest mature stable upstream tag and
    re-materialize the digital-me plugin overlay (stock + overlay model:
    no fork, no rebase). --dry-run prints the plan without writing;
    --skip-restart leaves the gateway untouched.

  digital-me deploy [--runtime openclaw|dashboard ...] [--dry-run]
    Turn 'merged in git' into 'verified live' in one safe step: refuse if
    the source checkout is dirty/ahead, fast-forward main, rebuild, reinstall
    to the canonical loaded location, restart the service, and self-verify the
    live fingerprint matches. No --runtime → every deployable runtime detected.

  digital-me migrate [--from <path>] [--to <path>]
    One-shot copy from upstream task-orchestrator.db to brain.db.
    Idempotent — re-runs skip already-migrated rows.

  digital-me dream-cycle [args...]
    Run the dream-cycle knowledge distillation pipeline. All args
    after `dream-cycle` pass through to `python3 -m dream_cycle.run`.

  digital-me dream-cycle import-workflow <path>
    Import a workflow.json into the openclaw brain via the gateway.

  digital-me dream-cycle --via-agents [args...]
    Run dream-cycle via brain-orchestrator spawn-dispatch instead of
    inline-Python LLM. Requires an imported workflow + a running gateway.

Runtimes:
  claude-code   5 hooks + digital-me skill into ~/.claude/
  codex         CODEX.md + openclaw-brain MCP into ~/.codex/
  hermes        SOUL.md digital-me protocol into ~/.hermes/
  openclaw      see @digital-me/runtime-openclaw README
  dream-cycle   creates ~/.venvs/dream-cycle/ + pip install -e the Python service
  dashboard     builds the dashboard + installs the always-on service (see --no-service)