CLI Reference

Global Options

Commands

init

Initialize a new workspace with XDG directory structure.

akh-medu init
akh-medu -w my-project init

workspace

Manage workspaces.

akh-medu workspace list
akh-medu workspace create <NAME>
akh-medu workspace delete <NAME>
akh-medu workspace info <NAME>

seed

Manage seed packs.

akh-medu seed list              # List available packs
akh-medu seed apply <PACK>      # Apply a seed pack
akh-medu seed status            # Show applied seeds

ingest

Load triples from files.

akh-medu ingest --file <PATH>
akh-medu ingest --file <PATH> --format csv --csv-format spo
akh-medu ingest --file <PATH> --format csv --csv-format entity
akh-medu ingest --file <PATH> --format text --max-sentences 100

bootstrap

Load bundled skills, run grounding, and run inference.

akh-medu bootstrap

query

Spreading-activation inference.

akh-medu query --seeds "Dog,Cat" --depth 2 --top-k 10

traverse

BFS graph traversal.

akh-medu traverse --seeds Dog --max-depth 2
akh-medu traverse --seeds Dog --predicates is-a --format json

sparql

Run SPARQL queries.

akh-medu sparql "SELECT ?s ?p ?o WHERE { ?s ?p ?o } LIMIT 10"
akh-medu sparql --file query.sparql

reason

Simplify expressions via e-graph rewriting.

akh-medu reason --expr "unbind(bind(Dog, is-a), is-a)"
akh-medu reason --expr "..." --verbose

search

Find similar symbols via VSA.

akh-medu search --symbol Dog --top-k 5

analogy

A:B :: C:? analogical reasoning.

akh-medu analogy --a King --b Man --c Queen --top-k 5

filler

Recover role-filler for (subject, predicate) pairs.

akh-medu filler --subject Dog --predicate is-a --top-k 5

info

Show engine statistics.

akh-medu info

symbols

List and inspect symbols.

akh-medu symbols list
akh-medu symbols show Dog
akh-medu symbols show 42

export

Export engine data.

akh-medu export symbols
akh-medu export triples
akh-medu export provenance --symbol Dog

skill

Manage skill packs.

akh-medu skill list
akh-medu skill load <NAME>
akh-medu skill unload <NAME>
akh-medu skill info <NAME>
akh-medu skill scaffold <NAME>     # Create a new skill template

pipeline

Run processing pipelines.

akh-medu pipeline query --seeds "Dog"
akh-medu pipeline run --stages retrieve,infer,reason --infer-depth 3

analytics

Graph analytics.

akh-medu analytics degree --top-k 10
akh-medu analytics pagerank --top-k 10
akh-medu analytics components
akh-medu analytics path --from Dog --to Cat

render

Hieroglyphic notation rendering.

akh-medu render --entity Dog
akh-medu render --entity Dog --depth 3
akh-medu render --all
akh-medu render --legend
akh-medu render --no-color

grammar

Bidirectional grammar system.

akh-medu grammar list
akh-medu grammar parse "Dogs are mammals"
akh-medu grammar parse "Dogs are mammals" --ingest
akh-medu grammar linearize --subject Dog --predicate is-a --object mammal
akh-medu grammar compare --subject Dog --predicate is-a --object mammal
akh-medu grammar load --file grammar.toml
akh-medu grammar render --entity Dog

chat

Interactive TUI.

akh-medu chat
akh-medu chat --skill my-skill
akh-medu chat --headless         # No TUI, plain text

preprocess

Pre-process text for the Eleutherios pipeline.

cat chunks.jsonl | akh-medu preprocess --format jsonl
cat chunks.json  | akh-medu preprocess --format json
cat chunks.jsonl | akh-medu preprocess --format jsonl --language ru
cat chunks.jsonl | akh-medu preprocess --format jsonl --library-context

equivalences

Cross-lingual equivalence mappings.

akh-medu equivalences list
akh-medu equivalences stats
akh-medu equivalences learn
akh-medu equivalences export > equivs.json
akh-medu equivalences import < equivs.json

library

Manage the shared content library. See Shared Content Library.

akh-medu library add paper.pdf
akh-medu library add https://example.com/article --title "My Article" --tags "physics"
akh-medu library list
akh-medu library search --query "quantum entanglement" --top-k 10
akh-medu library info <ID>
akh-medu library remove <ID>
akh-medu library watch --dir /path/to/papers/

code-ingest

Ingest Rust source code.

akh-medu code-ingest --path src/
akh-medu code-ingest --path src/ --recursive --run-rules --enrich
akh-medu code-ingest --path src/main.rs --max-files 50

enrich

Semantic enrichment on existing code knowledge.

akh-medu enrich

docgen

Generate documentation from code.

akh-medu docgen --target Engine --format markdown --output docs/
akh-medu docgen --target Engine --format json --polish

Agent Commands

All agent commands are subcommands of akh-medu agent.

agent cycle

Run one OODA cycle.

akh-medu agent cycle --goal "Find mammals"
akh-medu agent cycle --goal "..." --priority 200

agent run

Run until completion or max cycles.

akh-medu agent run --goals "Discover planets" --max-cycles 20
akh-medu agent run --goals "..." --fresh    # Ignore persisted session

agent repl

Interactive agent REPL.

akh-medu agent repl
akh-medu agent repl --goals "Initial goal"
akh-medu agent repl --headless

REPL commands: p/plan, r/reflect, q/quit.

agent resume

Resume a persisted session.

akh-medu agent resume
akh-medu agent resume --max-cycles 50

agent chat

Agent chat mode.

akh-medu agent chat
akh-medu agent chat --max-cycles 10 --fresh --headless

agent tools

List registered tools.

akh-medu agent tools

agent consolidate

Trigger memory consolidation.

akh-medu agent consolidate

agent recall

Recall episodic memories.

akh-medu agent recall --query "mammals" --top-k 5

agent plan

Generate and display a goal plan.

akh-medu agent plan

agent reflect

Trigger reflection.

akh-medu agent reflect

agent infer

Run forward-chaining rules.

akh-medu agent infer --max-iterations 10 --min-confidence 0.5

agent gaps

Analyze knowledge gaps.

akh-medu agent gaps --goal "Explore biology" --max-gaps 10

agent schema

Discover schema patterns.

akh-medu agent schema

agent daemon

Run the agent as a background daemon with scheduled learning tasks. Requires --features daemon (or --features server which implies it).

The daemon periodically runs: equivalence learning, reflection, memory consolidation, schema discovery, rule inference, gap analysis, and idle OODA cycles. It persists the session at a configurable interval and shuts down cleanly on Ctrl+C.

akh-medu agent daemon
akh-medu agent daemon --equiv-interval 600 --reflect-interval 300
akh-medu agent daemon --fresh --max-cycles 100
akh-medu agent daemon --persist-interval 120 --rules-interval 900

Background Learning

The agent supports two forms of autonomous background learning:

TUI Idle Learning

When using the TUI (akh-medu agent chat or akh-medu agent repl), the agent automatically runs background tasks during idle time (when you are not typing). No setup is required — it works out of the box.

Tasks and default intervals:

• Memory consolidation: every 2 minutes (if WM pressure is high)
• Reflection: every 5 minutes
• Equivalence learning: every 10 minutes
• Rule inference: every 15 minutes

Daemon Mode

For headless long-running operation, agent daemon runs a dedicated tokio event loop scheduling all background tasks at configurable intervals. This is useful for overnight knowledge base building or continuous ingestion workflows.