modelstat 0.0.6

package/README.md

@@ -0,0 +1,59 @@
+# @modelstat/agent
+
+> Local companion for [modelstat](https://github.com/0xflair/modelstat). Reads
+> your AI coding tools' JSONL/SQLite logs (Claude Code, Codex, Cursor,
+> Gemini, Aider, …), tokenises events on-device, and uploads them to the
+> modelstat backend.
+
+**Your prompts never leave your machine.** The agent only uploads
+tokenised metadata (token counts, model ids, git remote, tool call
+counts, redacted summaries). See the
+[source](https://github.com/0xflair/modelstat/tree/main/apps/agent-dev)
+— discovery and redaction live in
+[`@modelstat/parsers`](https://github.com/0xflair/modelstat/tree/main/packages/parsers).
+
+## Install
+
+```bash
+# npm
+npm install -g @modelstat/agent
+
+# pnpm
+pnpm add -g @modelstat/agent
+
+# bun
+bun install -g @modelstat/agent
+```
+
+Requires Node 20+.
+
+## Connect
+
+```bash
+# 1. Pair with your modelstat account (OAuth device-code)
+modelstat connect
+
+# It prints a 6-char code; enter it at the URL it opens in your browser.
+
+# 2. Report detected tool installs + identities
+modelstat discover
+
+# 3. One-shot backfill of all local JSONL
+modelstat scan
+
+# 4. Continuous watcher (chokidar + periodic backstop)
+modelstat watch
+```
+
+## Self-host
+
+If you're pointing at your own modelstat API (not the hosted SaaS):
+
+```bash
+export AGENT_API_URL=https://your-modelstat-api.example.com
+modelstat connect
+```
+
+## License
+
+Apache-2.0 — the code that reads files on your machine must be auditable.