plinth-cli

Plinth capstone sync daemon and CLI. Mirrors your Plinth workspace to ~/Plinth/<workspace>/ and keeps it bidirectionally synced. AI-native: pair with Claude Code or any LLM agent for context-aware artist management.

Status: early access. login and sync (pull-only, documents) are implemented; the watcher and other entity types land in subsequent PRs. See V1_SPEC §5 M3 in the plinth monorepo for the full milestone plan.

Commands

Implemented today:

• plinth login --workspace <slug> — issue a PAT in the browser, paste it back, store in the OS keychain (macOS Keychain / Linux Secret Service / Windows Credential Manager).
• plinth sync [--workspace <slug>] — one-shot pull of documents into ~/Plinth/<workspace>/. Defaults to the active workspace if --workspace is omitted.

Planned (not yet implemented):

• plinth start — run the sync daemon (file watcher + cloud subscription).
• plinth status — print last-synced-at per entity type and pending changes.
• plinth refresh-context — regenerate CLAUDE.md from the current Plinth schema + workspace.
• plinth export workspace — generate an export bundle.
• plinth update — detect install method (brew vs npm-global) and upgrade in place.
• plinth logout --workspace <slug> — revoke local PAT reference, retain mirror files.

Install (once published)

Neither path is published yet.

# npm (cross-platform)
npm i -g @plinth-music/cli

# Homebrew (macOS, signed + notarised)
brew install plinth-music/tap/plinth-cli

Develop

Requires Bun (latest).

bun install
bun run build      # produces dist/cli.js
bun test           # builds, then runs the smoke test
bun run typecheck  # strict tsc, no emit

The built CLI is a standard Node-compatible ESM bundle with a #!/usr/bin/env node shebang. Run it directly:

./dist/cli.js --version
./dist/cli.js --help

License

MIT — see LICENSE.