@eddacraft/kindling-cli

Command-line interface for Kindling - inspect, search, and manage your local AI memory.

Installation

# Install globally
npm install -g @eddacraft/kindling-cli

# Or run via npx
npx @eddacraft/kindling-cli status

Commands

Status

Show database status and statistics:

kindling status
kindling status --db ./custom-path.db

Output:

Database: /home/user/.kindling/memory.db
Size: 2.4 MB

Observations: 1,247
Capsules: 23 (5 open, 18 closed)
Pins: 8 (3 expired)
Summaries: 18

Search

Search for context across observations and summaries:

# Basic search
kindling search "authentication error"

# Filter by session
kindling search "auth" --session session-123

# Filter by repository
kindling search "auth" --repo /home/user/my-project

# Limit results
kindling search "auth" --limit 20

# Include redacted observations
kindling search "auth" --include-redacted

List

List entities in the database:

# List capsules
kindling list capsules
kindling list capsules --status open
kindling list capsules --type session

# List pins
kindling list pins
kindling list pins --active  # Only non-expired

# List observations
kindling list observations
kindling list observations --kind error
kindling list observations --capsule cap-123

Pin

Pin important observations or summaries:

# Pin an observation
kindling pin observation obs_abc123 --note "Root cause identified"

# Pin with TTL (expires in 7 days)
kindling pin observation obs_abc123 --ttl 7d

# Pin a summary
kindling pin summary sum_xyz789 --note "Key architecture decision"

Unpin

Remove a pin:

kindling unpin pin_xyz789

Inspect

View details of an entity:

kindling inspect observation obs_abc123
kindling inspect capsule cap_xyz789
kindling inspect summary sum_123

Export

Export data for backup or transfer:

# Export all data
kindling export ./backup.json

# Export scoped data
kindling export ./backup.json --repo /home/user/my-project
kindling export ./backup.json --session session-123

Import

Import data from a backup:

kindling import ./backup.json

Configuration

The CLI uses these default paths:

| Item | Default Path | | -------- | ------------------------- | | Database | ~/.kindling/memory.db | | Config | ~/.kindling/config.json |

Override with environment variables:

export KINDLING_DB_PATH=/custom/path/memory.db
kindling status

Or use the --db flag:

kindling status --db ./my-memory.db

Output Formats

# Default (human-readable)
kindling list capsules

# JSON output
kindling list capsules --json

# Quiet (IDs only)
kindling list capsules --quiet

Related Packages

• @eddacraft/kindling-core - Domain types
• @eddacraft/kindling-store-sqlite - SQLite persistence

License

Apache-2.0