@rulestacks/cli
v0.1.0
Published
Rulestacks CLI — manage rules, stacks, captures, and adoptions from the terminal
Downloads
90
Readme
@rulestacks/cli
The rulestacks command — manage rules, stacks, captures, adoptions,
and conflicts from the terminal. Talks to the same L1 API that the web
app and MCP server use, so anything you do here shows up everywhere.
Install
npm install -g @rulestacks/cliA Homebrew tap is planned but not yet published.
Authenticate
rulestacks auth loginThe CLI runs an OAuth device flow against api.rulestacks.com. The
returned token is stored in your OS keychain when available (keytar),
otherwise in a mode-0600 file at
~/.config/rulestacks/credentials.json.
Use
rulestacks --help # top-level command tree
rulestacks rules list # human-friendly when on a TTY
rulestacks rules list --json # structured envelope for agents
rulestacks commands --json # discover the full surface
rulestacks setup claude # install the Claude Code skillFor agents: always pass --json. Every command emits
{ ok, data, summary, meta?, breadcrumbs } on stdout; errors emit
{ ok: false, error: { kind, message, status } }. Exit codes are in
the 1–8 range.
Links
- Web app: https://rulestacks.com
- API docs: https://api.rulestacks.com
- Source: https://github.com/lukebrooker/rulestacks
