@claude-transcripts/cli 0.0.12

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 vredchenko
+
+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,120 @@
+# @claude-transcripts/cli
+
+**Self-hosted history for your [Claude Code](https://claude.com/claude-code)
+sessions** — the command-line interface.
+
+[Claude Transcripts](https://github.com/vredchenko/claude-transcripts) records every
+Claude Code session — events, an end-of-session summary (counts, tool usage, token
+usage), and the full transcript — to **your own** CouchDB + S3-compatible storage. A
+web API serves it back; a web UI, this CLI, and AI agents read it. Everything runs on
+your own infrastructure and nothing leaves your network.
+
+This CLI sets the whole system up, controls it, and reads the history back.
+
+> ### ⚠️ Early — a preview, not something to depend on
+>
+> Breaking changes land without notice, and stored data may still have to be discarded
+> between revisions. There is **no auth and no security model** — it assumes a single
+> user on a single trusted machine, so don't expose it to a network or point it at
+> anything you can't afford to lose. Issues and feedback are welcome.
+
+## Requires Bun
+
+This package is a [Bun](https://bun.sh)-runnable bundle and **needs `bun` on your
+`PATH` at runtime** — it uses Bun's file, hashing, and subprocess APIs. It does not run
+on Node.
+
+| | |
+|---|---|
+| `bunx @claude-transcripts/cli` | ✅ |
+| `bun add -g @claude-transcripts/cli` | ✅ |
+| `npx` / `npm i -g` | ⚠️ works only if Bun is already installed |
+| Node | ❌ |
+
+**If you don't have Bun, don't use this package** — use the standalone binaries below
+instead. They embed their own runtime and need nothing installed.
+
+## Install
+
+### The easy way — no Bun, no clone
+
+One command. It fetches the release binary for your platform, verifies its checksum,
+and hands over to `claude-transcripts install`, which generates this instance's secrets
+and ports, starts the backing services, provisions the stores, starts the app, sets up
+search, and registers the hook with Claude Code:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/vredchenko/claude-transcripts/main/install.sh | sh
+```
+
+Needs **Docker** and **Claude Code**. Standalone binaries for Linux and macOS (x64 and
+arm64), with SHA-256 sums, are attached to
+[every release](https://github.com/vredchenko/claude-transcripts/releases/latest) if
+you'd rather fetch one yourself.
+
+### With Bun
+
+```bash
+bunx @claude-transcripts/cli install     # one-off
+bun add -g @claude-transcripts/cli       # or install it globally
+```
+
+## Quick start
+
+```bash
+claude-transcripts install     # set up stores, app, and the Claude Code hook
+claude-transcripts doctor      # smoke-test write → read → search, end to end
+claude-transcripts sessions    # what's been recorded
+```
+
+The web UI is at `http://127.0.0.1:<WEBAPI_PORT>/app` — `install` prints the address,
+and picks a free port block per instance rather than assuming one. Re-running `install`
+upgrades in place: it's idempotent and keeps your history.
+
+## Commands
+
+| Command | What it does |
+|---|---|
+| `install` | Set up everything: stores, app, and the Claude Code hook |
+| `uninstall` | Remove the instance (history is kept unless `--purge`) |
+| `stack <up\|down\|restart\|logs\|ps>` | Control the container stack |
+| `provision` | Create the CouchDB databases and the S3 bucket + key |
+| `hook <run\|install\|uninstall\|status>` | The Claude Code hook, and its registration |
+| `sessions [id]` | List sessions, or show one in detail |
+| `setup` | Register the hook + generate runtime config |
+| `export <dir>` | Export session data to a portable bundle |
+| `import <dir>` | Restore session data from a portable bundle |
+| `backfill` | Adopt on-disk `~/.claude` transcripts as first-class history |
+| `migrate <up\|down\|status>` | Run CouchDB migrations |
+| `reindex` | Rebuild the search indexes from CouchDB |
+| `doctor` | Smoke-test the write/read/search path end to end |
+
+Run `claude-transcripts` with no arguments for the full help, including every flag.
+Full reference:
+[docs/reference/cli.md](https://github.com/vredchenko/claude-transcripts/blob/main/docs/reference/cli.md).
+
+## This is a CLI, not a library
+
+The package exposes a `bin` and nothing else — there's no `main`, no `exports`, and no
+type declarations, so it can't be imported. That's deliberate: the supported
+programmatic interface is the **web API**, whose OpenAPI spec is the contract clients
+are generated from. See
+[docs/reference/webapi.md](https://github.com/vredchenko/claude-transcripts/blob/main/docs/reference/webapi.md).
+
+## Links
+
+- **Project site** — https://vredchenko.github.io/claude-transcripts/
+- **Source** — https://github.com/vredchenko/claude-transcripts
+- **Installation guide** —
+  [docs/start/installation.md](https://github.com/vredchenko/claude-transcripts/blob/main/docs/start/installation.md)
+- **Changelog** —
+  [CHANGELOG.md](https://github.com/vredchenko/claude-transcripts/blob/main/CHANGELOG.md)
+- **Issues** — https://github.com/vredchenko/claude-transcripts/issues
+
+Every component is lockstep-versioned: one `vMAJOR.MINOR.PATCH` release versions the
+hook, web API, web UI, and CLI as a set — so this package's version is also the version
+of the instance it expects to talk to.
+
+## License
+
+MIT © vredchenko