@plinth-music/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Plinth Music Ltd
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,55 @@
+# 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.
+
+```sh
+# npm (cross-platform)
+npm i -g @plinth-music/cli
+
+# Homebrew (macOS, signed + notarised)
+brew install plinth-music/tap/plinth-cli
+```
+
+## Develop
+
+Requires [Bun](https://bun.sh/) (latest).
+
+```sh
+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:
+
+```sh
+./dist/cli.js --version
+./dist/cli.js --help
+```
+
+## License
+
+MIT — see `LICENSE`.