Skip to content
Logo

CLI commands

pond <command> --help   # full flags for any command

Setup

  • pond init - guided setup-and-repair: storage, adapters, MCP + agent skill, schedule
  • pond adapters list|discover|enable|disable - manage which adapters sync ingests
  • pond storage check|use - probe a destination; switch the active store
  • pond creds add|list|delete - manage URL-scoped credential sets
  • pond schedule start|stop|status|logs - manage the automatic sync schedule (launchd on macOS, systemd user timers or a fenced crontab block on Linux, Task Scheduler on Windows)
  • pond config show|path|schema - inspect resolved configuration

Data

  • pond sync [<adapter>] - import and fold indexes (embedding inline when enabled); --dry-run preview, --no-wait skip if locked, --verify reconcile, --format json
  • pond optimize - fold the indexes, and embed the backlog when embeddings are enabled; --only / --skip <stage>
  • pond copy --from <x> --to <y> - move data between stores, .pond archives, JSONL; --verify-only
  • pond resume <ID> --to <adapter> - write a stored session back out as that client's own files so you can open it there. Restores the session with its child sessions; never overwrites (an existing target fails the whole operation and names it). --out-dir is the root the client's own layout is written under (~/.pi/agent for pi-coding-agent); --format json for the file list

Query

  • pond search <query> - search (--mode fts|vector, --sort-by relevance|recency, --from-date / --to-date bounds as YYYY-MM-DD); fts is the default and vector needs semantic search enabled; --explain for the query plan
  • pond get-session <ID> - fetch a session
  • pond get-message <ID> - fetch a message
  • pond sql <query> - one read-only SQL query over the corpus
  • pond status - health, row counts, index readiness, schedule state; --hosts fleet view, --include-subagents count subagents separately

pond status --format json

One machine-readable document for scripting. Top-level keys: initialized (whether the store has been set up), pond_version (the producing binary's version, so consumers can pin the format), storage, corpus, indexes, embedding (null-valued when semantic search is off), source_agents (count of distinct source agents in the store), local (this host's adapters + pending-sync counts, last sync, next scheduled run), hosts, and schedule ({active, backend, every}).

Serve

  • pond serve --transport http|stdio - run the API (HTTP default)
  • pond serve --host 0.0.0.0 --allowed-host <name> - serve on a reachable address; /mcp answers only to loopback plus the Host names listed here (repeat the flag, or set POND_ALLOWED_HOSTS), /v1/* is ungated
  • pond mcp - alias for pond serve --transport stdio
  • pond completions <shell> - shell completion scripts
  • pond skill - print the bundled agent-onboarding SKILL.md

Copy endpoints

local local default dir · @ configured store · *.pond archive · *.jsonl or - JSONL wire stream.