A Zettelkasten-inspired knowledge management CLI for capturing and navigating research

Usage: qipu [OPTIONS] [COMMAND]

Commands:
  init        Initialize a new qipu store
  create      Create a new note
  new         Alias for create
  list        List notes
  show        Show a note
  inbox       List unprocessed notes (fleeting/literature)
  capture     Create a new note from stdin
  index       Build or refresh derived indexes
  search      Search notes by title and body
  edit        Open a note in $EDITOR and update the index upon completion
  update      Update a note's metadata or content non-interactively. Reads replacement body text from stdin when piped (e.g., `echo "new content" | qipu update <id>`)
  context     Build context bundle for LLM integration
  dump        Dump notes to a pack file
  export      Export notes to a single document
  load        Load notes from a pack file
  prime       Output session-start primer for LLM agents
  quickstart  Quick start guide for common workflows
  verify      Toggle verification status of a note
  value       Manage note value (quality/importance score)
  tags        Manage and query tags
  link        Manage and traverse note links
  onboard     Display minimal AGENTS.md snippet for agent integration
  setup       Install qipu integration instructions for agent tools
  doctor      Validate store invariants and optionally repair issues
  sync        Sync store: update indexes and optionally validate
  compact     Manage note compaction (digest-first navigation)
  workspace   Manage and navigate isolated workspaces
  merge       Merge note id1 into id2
  store       Manage the qipu store
  ontology    Manage and display ontology configuration
  telemetry   Manage anonymous usage analytics
  hooks       Manage git hooks for automatic store sync
  help        Print this message or the help of the given subcommand(s)

Options:
      --root <ROOT>
          Base directory for resolving the store
      --store <STORE>
          Explicit store root path [env: QIPU_STORE=]
      --format <FORMAT>
          Output format [default: human]
  -q, --quiet
          Suppress non-essential output
  -v, --verbose
          Report timing for major phases
      --log-level <LEVEL>
          Set log level (error, warn, info, debug, trace)
      --log-json
          Output logs in JSON format
      --no-resolve-compaction
          Disable compaction resolution (show raw compacted notes)
      --with-compaction-ids
          Include compacted note IDs in output
      --compaction-depth <COMPACTION_DEPTH>
          Compaction traversal depth (requires --with-compaction-ids)
      --compaction-max-nodes <COMPACTION_MAX_NODES>
          Maximum compacted notes to include in output
      --expand-compaction
          Expand compacted notes to include full content (context command only)
      --workspace <WORKSPACE>
          Target workspace name
      --no-semantic-inversion
          Disable semantic inversion for link listing/traversal
  -h, --help
          Print help
  -V, --version
          Print version
