obsidian-foundry-sync/wiki/modules/cli.md

type: module path: "src/cli.ts" status: active language: typescript purpose: "Entry point (tsx). Commands: ui (dashboard), refresh, push. Env-driven via config." maintainer: Kaysser Kayyali last_updated: 2026-06-22 linked_issues: [] depends_on: server, batch, relay-client, push, config used_by: [] tags: [module] created: 2026-06-22 updated: 2026-06-22

cli

src/cli.ts — run via npx tsx src/cli.ts <cmd> or ./sync.sh <cmd> (which sources .env and injects --journal).

Commands (to document fully)

• ui → startServer (server). --vault, --cc (optional — auto-builds stubs), --out, --host (default 0.0.0.0), --apply (write real dirs; default dev/dry-run). Relay enabled when RELAY_API_KEY is set. Binds 0.0.0.0:7788.
• refresh → name-uuid.json via relay /search (refresh-flow). --full-index does the heavy docker-stop LevelDB read (CLI-only by design).
• push → push one note live.

Notes

• sync.sh loads .env (set -a; . ./.env) and injects --journal from $JOURNAL.
• This page is a stub — expand with exact flags + the cmdUi/cmdRefresh/cmdPush bodies.