Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

The corpus

toolrole in the box
quipugoverned knowledge-graph store
bobbinsemantic index · retrieval · RAG
camayocontology bootstrap, ingress discipline, knowledge packs
yupanacode-structure graph — impact, callers, verify
desire-pathhallucinations → feature requests
shantytowncrew harness (multi-agent, tmux-resident)
shuttleworkflow engine — signed runs, windowed export, frozen history
creelbrowser-native crew — tabs as workers
shantythe tmux the crew lives in
beads (br)issue tracking as agent memory — SQLite + JSONL

Extending the corpus with Quipu shares

Every profile includes Quipu and can stage git-native knowledge shares into an explicit local database:

caboodle plan --profile retrieval \
  --share ./team-knowledge \
  --share ./project-knowledge \
  --quipu-db ./knowledge.db
caboodle apply --skip-install

A share directory is the canonical output of quipu share: manifest.json, export.nt, and shapes.ttl. Caboodle does not parse, rewrite, unpack, or wrap those files. It invokes quipu import <directory> --db <database>, so Quipu owns payload-hash verification, identity candidates, local SHACL validation, and the staging/quarantine graph.

The returned share_id, graph, outcome, promotion eligibility, and blockers are retained under shares in .caboodle/state.json. A quarantined import is a successful safe consumption outcome that still needs review; Caboodle never runs quipu import promote. Promotion into ROOT remains a separate explicit operator decision using the share ID.