@whittlelabs/sifter 0.1.3

package/README.md

@@ -0,0 +1,57 @@
+# @whittlelabs/sifter
+
+The Whittle Sifter is a paired AI reviewer for [Whittle Sift](https://sift.staging.whittlelabs.com). It runs on your machine, executes review prompts against your own AI credentials (Claude Code, Anthropic API key, etc.), and submits the results back to Sift. Token spend stays on your account.
+
+## Install
+
+`@whittlelabs/sifter` is published to the private Whittle Labs GitHub Packages registry. You'll need a GitHub personal access token with `read:packages` scope and access to the `whittlelabs` org.
+
+```bash
+# One-time: tell npm where to find @whittlelabs packages
+echo "@whittlelabs:registry=https://npm.pkg.github.com" >> ~/.npmrc
+echo "//npm.pkg.github.com/:_authToken=YOUR_GITHUB_TOKEN" >> ~/.npmrc
+
+npm install -g @whittlelabs/sifter
+```
+
+Requires Node 20+.
+
+## Pair
+
+Visit Sift's **Settings → Pair a Sifter**. Sift will display a pairing code and the command to run:
+
+```bash
+whittle-sifter init --pairing-code=ABCD-1234
+```
+
+The Sifter defaults to the staging Keep instance (`https://keep.staging.whittlelabs.com`). To pair against a different environment, pass `--keep-url`:
+
+```bash
+whittle-sifter init \
+  --keep-url=https://keep.testing.whittlelabs.com \
+  --pairing-code=ABCD-1234
+```
+
+Pairing writes credentials to `~/.sifter/config.json` (mode 0600).
+
+## Run
+
+```bash
+whittle-sifter run
+```
+
+The Sifter subscribes to your attention pool and waits for review jobs. Leave it running in a terminal or wrap it in your favorite process supervisor.
+
+## Other commands
+
+```bash
+whittle-sifter audit tail              # Tail the local audit log
+whittle-sifter caps                    # Show current spend caps
+whittle-sifter caps set --daily-tokens 1000000
+whittle-sifter list                    # List paired machines
+whittle-sifter revoke <nameOrId>       # Revoke a paired machine
+```
+
+## License
+
+UNLICENSED. Whittle Labs internal use.