Utility Commands

Commands for managing memory state, searching, analysis, and maintenance.

load

Load and display working memory at session start.

kernle -a <agent> load [--json] [--sync] [--no-sync]

Option	Description
`-j, --json`	Output as JSON
`-s, --sync`	Force sync (pull) before loading
`--no-sync`	Skip sync even if auto-sync enabled

# Standard load
kernle -a claire load

# Force sync from cloud first
kernle -a claire load --sync

checkpoint

Save and restore session state.

checkpoint save

kernle -a <agent> checkpoint save TASK [options]

Option	Description
`-p, --pending PENDING`	Pending item (repeatable)
`-c, --context CONTEXT`	Additional context
`-s, --sync`	Force sync after saving
`--no-sync`	Skip sync

Basic
With Pending Items
With Context

kernle -a claire checkpoint save "Working on user authentication"

kernle -a claire checkpoint save "Refactoring database layer" \
  --pending "finish migration script" \
  --pending "update tests"

kernle -a claire checkpoint save "Debugging API issue" \
  --context "Error occurs when token expires after 1 hour"

checkpoint load

kernle -a <agent> checkpoint load [--json]

checkpoint clear

kernle -a <agent> checkpoint clear

search

Search memory using vector similarity.

kernle -a <agent> search QUERY [--limit LIMIT]

Option	Description
`-l, --limit LIMIT`	Maximum results (default: 10)

kernle -a claire search "authentication"
kernle -a claire search "database performance" --limit 5

status

Show memory status overview.

kernle -a <agent> status

Example output:

Memory Status for claire
========================================
Values:     3
Beliefs:    12
Goals:      2 active
Episodes:   45
Raw:        8 (5 unprocessed)
Notes:      23
Checkpoint: Yes (2 hours ago)

when

Query memories by time period.

kernle -a <agent> when [PERIOD]

Period	Description
`today`	Today’s memories (default)
`yesterday`	Yesterday’s memories
`this week`	This week’s memories
`last hour`	Last hour’s memories

kernle -a claire when yesterday
kernle -a claire when "this week"

anxiety

Memory anxiety tracking and management.

kernle -a <agent> anxiety [options]

Option	Description
`-d, --detailed`	Show detailed breakdown
`-a, --actions`	Show recommended actions
`--auto`	Execute recommended actions
`-c, --context TOKENS`	Current context token usage
`-l, --limit LIMIT`	Context window limit (default: 200000)
`-e, --emergency`	Run emergency save immediately
`-s, --summary`	Summary for emergency save
`-j, --json`	Output as JSON

Quick Check
Detailed
Auto-Fix
Emergency

kernle -a claire anxiety
# Output: Memory Anxiety: 45/100 (Aware)

kernle -a claire anxiety --detailed --actions

kernle -a claire anxiety --auto

kernle -a claire anxiety --emergency --summary "Context compaction triggered"

consolidate

Run memory consolidation (episodes → beliefs).

kernle -a <agent> consolidate [--min-episodes MIN]

Option	Description
`-m, --min-episodes MIN`	Minimum episodes to consolidate (default: 3)

kernle -a claire consolidate
kernle -a claire consolidate --min-episodes 5

identity

Identity synthesis operations.

identity show

Generate a coherent identity narrative.

kernle -a <agent> identity show [--json]
# or just:
kernle -a <agent> identity

identity confidence

Check identity coherence score.

kernle -a <agent> identity confidence [--json]

identity drift

Detect identity drift over time.

kernle -a <agent> identity drift [--days DAYS] [--json]

Option	Description
`-d, --days DAYS`	Days to look back (default: 30)

emotion

Emotional memory operations.

emotion summary

kernle -a <agent> emotion summary [--days DAYS] [--json]

emotion search

Search by emotional characteristics.

kernle -a <agent> emotion search [options]

Option	Description
`--positive`	Find positive episodes
`--negative`	Find negative episodes
`--calm`	Find low-arousal episodes
`--intense`	Find high-arousal episodes
`-t, --tag TAG`	Emotion tag to match
`-l, --limit LIMIT`	Maximum results (default: 10)

kernle -a claire emotion search --positive --limit 5
kernle -a claire emotion search --negative --intense

emotion tag

Add emotional tags to an episode.

kernle -a <agent> emotion tag EPISODE_ID [--valence V] [--arousal A] [--tag TAG]...

emotion mood

Get mood-relevant memories.

kernle -a <agent> emotion mood --valence V --arousal A [--limit LIMIT]

forget

Controlled forgetting operations.

forget candidates

Show forgetting candidates.

kernle -a <agent> forget candidates [--threshold T] [--limit L]

forget run

Run forgetting cycle.

kernle -a <agent> forget run [--dry-run] [--threshold T] [--limit L]

# Preview
kernle -a claire forget run --dry-run

# Actually forget
kernle -a claire forget run --threshold 0.2 --limit 5

forget protect

Protect a memory from forgetting.

kernle -a <agent> forget protect TYPE ID [--unprotect]

forget recover

Recover a forgotten memory.

kernle -a <agent> forget recover TYPE ID

forget list

List forgotten memories.

kernle -a <agent> forget list [--limit L]

dump

Dump all memory to stdout.

kernle -a <agent> dump [--format {markdown,json}] [--include-raw] [--no-raw]

Option	Description
`-f, --format`	Output format (default: markdown)
`-r, --include-raw`	Include raw entries (default: true)
`--no-raw`	Exclude raw entries

kernle -a claire dump | less
kernle -a claire dump --format json

export

Export memory to a file.

kernle -a <agent> export PATH [--format {markdown,json}]

Format is auto-detected from file extension if not specified.

kernle -a claire export backup.md
kernle -a claire export memory-snapshot.json --format json

init

Initialize Kernle with interactive setup.

kernle -a <agent> init [options]

Option	Description
`-y, --non-interactive`	Use defaults
`--env {claude-code,clawdbot,cline,cursor,desktop}`	Target environment
`--seed-values`	Seed initial values (default: true)
`--no-seed-values`	Skip seeding values

# Interactive
kernle -a my-project init

# Non-interactive for Claude Code
kernle -a my-project init -y --env claude-code

mcp

Start MCP server (stdio transport).

kernle -a <agent> mcp

Used for integration with MCP-compatible tools. See MCP Integration.

Getting Started

Core Concepts

CLI Reference

Integration

​Utility Commands

​load

​checkpoint

​checkpoint save

​checkpoint load

​checkpoint clear

​search

​status

​when

​anxiety

​consolidate

​identity

​identity show

​identity confidence

​identity drift

​emotion

​emotion summary

​emotion search

​emotion tag

​emotion mood

​meta

​meta confidence

​meta verify

​meta lineage

​meta uncertain

​meta knowledge

​meta gaps

​meta boundaries

​meta learn

​forget

​forget candidates

​forget run

​forget protect

​forget recover

​forget list

​dump

​export

​init

​mcp