@slipbox/cli
v0.1.1
Published
Slipbox — a Zettelkasten harness for Pi. Build and grow a flat-markdown slipbox from any source.
Maintainers
Readme
@slipbox/cli
The Slipbox command — a standalone Pi-powered harness for
building and growing a flat-markdown Zettelkasten. Run slipbox in any directory
to open the agent preloaded with the slipbox tools and skill.
It's a thin branded launcher over the Pi SDK: it starts Pi's interactive TUI with
@slipbox/core injected, and reuses your existing Pi login, models, and
settings (from ~/.pi/agent). Log in once with Pi and slipbox just works.
Install (planned, once published)
npm install -g @slipbox/cli
slipbox # in any folderUse
cd ~/my-knowledge-base
slipbox
> /init # scaffold this folder into a slipbox (.slipbox + folders)
> ingest ~/reading/some-essay.md
> write a literature note for each cluster, then a reference note
> what's in the slipbox now?/initturns the current folder into a slipbox (creates.slipboxand the note-type folders). Idempotent.- Everything else is a normal conversation; the agent uses the
slipbox_*tools.
Requirements
- Node ≥ 22
- QMD:
npm i -g @tobilu/qmdthenqmd pull - A Pi login. If you've run
piand logged in, you're set. Otherwise run/logininsideslipbox(it's the same interactive session), or setANTHROPIC_API_KEY.
Local development (unpublished)
From the repo root, build the workspace, then either run the bin directly or link
a global slipbox command:
pnpm build
# Option A — run the built bin directly (no global install):
cd ~/some-folder
node /ABSOLUTE/PATH/TO/slipbox-harness/packages/cli/dist/bin.js
# Option B — a real `slipbox` command on your PATH:
pnpm --filter @slipbox/cli link --global
cd ~/some-folder && slipboxThe launcher reuses ~/.pi/agent, so your Pi credentials and model choice carry
over automatically.
Troubleshooting
/loginhangs on "Waiting for authentication…". Known issue with the embedded login flow: the OAuth device flow does complete and your credentials are saved to~/.pi/agent/auth.json, but the TUI can fail to return from the waiting screen. Pressesc/ctrl+c(or close the tab), then relaunchslipbox— you'll already be authenticated. Alternatively, log in once with thepiCLI (pi→/login);slipboxreuses that login.zsh: command not found: slipbox. Open a new terminal (orsource ~/.zshrc) so~/Library/pnpm/binis on your PATH.- The harness thinks a parent folder is the slipbox. Slipbox discovery walks
up to the nearest
.slipbox. Runslipboxin a clean folder (not nested under an existing slipbox) and use/init.
