Command Reference

All commands and options

Learning Commands

learnings

Search and retrieve learnings with FTS5 full-text search

disclose learnings [OPTIONS]
Option Description
--query Keyword search query
--domains Filter by domains (comma-separated)
--types Filter by learning types (pattern, problem-solution, mistake, insight)
--min-confidence Minimum confidence threshold (0.0-1.0)
--limit Maximum results to return (default: 10)
--sort-by Sort by: relevance, date, confidence
--sort-order Sort order: asc, desc
--format Output format: markdown, json
--db-path Path to learnings database

session-context

Generate learning bundles for session start injection

disclose session-context [OPTIONS]
Option Description
--token-budget Maximum tokens for bundle (default: 800)
--domains Filter by domains (comma-separated)
--types Filter by learning types
--min-confidence Minimum confidence (default: 0.7)
--strategy Ranking strategy: confidence_recency
--format Output format: markdown, json
--db-path Path to learnings database

Context Commands

Create token-budgeted context packs from multiple sources

pack

Create context bundle (preferred command)

disclose pack --query  [OPTIONS]
Option Description
--query Search query for context discovery (required)
--scope Scope: context, history, skills, all (default: all)
--token-budget Maximum tokens for bundle (default: 2000)
--max-files Maximum files to include (default: 6)
--include-history Include recent history entries in bundle
--history-limit Max history entries to include (default: 10)
--out Output path (use "-" for stdout)

bundle

Alias for pack command (same options)

Discovery Commands

File and skill discovery

locate

Return file locator plan

disclose locate --query  [OPTIONS]
Option Description
--query Search query (required)
--scope Scope: context, history, skills, all
--token-budget Token budget for ranking (default: 2000)
--max-files Maximum files to return (default: 6)
--no-index-build Skip building catalog index

skill-search

Find matching skill directories

disclose skill-search --query  [OPTIONS]
Option Description
--query Search query (required)
--max-results Maximum results (default: 5)
--skills-root Override skills directory root

Index Commands

Manage catalog indexes for domains

ensure-index

Ensure catalog indexes exist for domains

disclose ensure-index --type  [OPTIONS]
Option Description
--type Domain: context, history, skills, or home
--input-root Input directory to index
--output-index Output directory for index files
--force Force rebuild even if index exists
--no-validate Skip validation of generated index
--no-silent Show catalog output

index

Build catalog index (wrapper for ensure-index)

Global Options

Option Short Description
--config -c Load config from specified path
--no-config Skip config file loading
--json Output structured JSON envelope
--quiet -q Suppress non-essential output
--no-color Disable ANSI colors
--verbose Show debug information
--print-config Print effective merged configuration
--dry-run Show what would be done without writing
--help -h Show help message
--version -v Print version and exit

Root Overrides

Override configured root directories

Option Description
--context-root Override context documents root
--history-root Override history documents root
--skills-root Override skills directory root

Output Formats

Markdown and JSON output options

Markdown Results

# Learning Search Results

- Query: authentication
- Domains: security
- Minimum Confidence: 0.7
- Results: 5 of 12
- Search Time: 15ms
---

## JWT token validation pattern

**ID:** learning_abc123
**Type:** pattern
**Confidence:** 0.85
**Status:** active
**Domains:** security, authentication
**Tools:** jwt, jsonwebtoken
**Created:** 2025-01-15T10:30:00Z

Always validate JWT tokens on server side...
---

JSON Results

{
  "query": "authentication",
  "filters": {
    "domains": ["security"],
    "types": null,
    "minConfidence": 0.7
  },
  "results": [
    {
      "id": "learning_abc123",
      "type": "pattern",
      "summary": "JWT token validation pattern",
      "content": "Always validate JWT tokens...",
      "confidence": 0.85,
      "status": "active",
      "domains": ["security", "authentication"],
      "tools": ["jwt", "jsonwebtoken"],
      "created_at": "2025-01-15T10:30:00Z"
    }
  ],
  "total": 12,
  "took": 15
}