Tool Reference

Tool Reference

Complete list of tools available in cortex-engine v0.9.0 and official plugins.

Core Tools (27)

Write — record knowledge

Tool	What it does
observe	Record a fact — something learned, confirmed, or noticed
wonder	Record an open question or curiosity (stored separately from facts)
speculate	Record a hypothesis or untested idea
believe	Update what you believe about an existing concept
reflect	Synthesize what you know about a topic into a grounded reflection
digest	Ingest a document — extracts facts and generates reflections

Read — retrieve knowledge

Tool	What it does
query	Semantic search over memories (spreading activation, not just cosine similarity)
recall	List recent observations chronologically
predict	Anticipate what memories might be relevant next
validate	Confirm or deny a prediction — strengthens or weakens the memory
neighbors	Explore memories connected to a specific concept
wander	Random walk through the memory graph for serendipitous discovery

Threads — ongoing work

Tool	What it does
thread_create	Start tracking an ongoing question, project, or exploration
thread_update	Add progress, change status, link related memories
thread_resolve	Close a thread with a resolution
threads_list	See open threads (check at session start)

Ops — session tracking

Tool	What it does
ops_append	Log a session breadcrumb, milestone, or decision
ops_query	Search the operational log
ops_update	Update an ops entry status or content

Identity

Tool	What it does
evolve	Propose a change to values, preferences, or patterns
evolution_list	View pending or applied identity proposals
journal_write	Write a daily reflective entry
journal_read	Read past journal entries

System

Tool	What it does
stats	Memory counts and namespace health
dream	Consolidate observations into long-term memories (compress, abstract, prune)
agent_invoke	Dispatch a task to a cortex-backed agent using the configured LLM
goal_set	Set a desired future state — generates forward prediction error to bias consolidation and exploration

---

Plugin Tools

Install any plugin and cortex auto-discovers the new tools. No config changes needed.

@fozikio/tools-threads

Tool	What it does
thread_create	Start a new thought thread
thread_update	Add to or modify a thread
thread_resolve	Close a thread with resolution
threads_list	List active threads

@fozikio/tools-journal

Tool	What it does
journal_write	Write a session reflection
journal_read	Read past journal entries

@fozikio/tools-content

Tool	What it does
content_create	Create content pipeline item
content_list	List content items
content_update	Update content status

@fozikio/tools-evolution

Tool	What it does
evolve	Propose identity change
evolution_list	List past evolutions

@fozikio/tools-social

Tool	What it does
social_read	Read social post history
social_update	Update social tracking

@fozikio/tools-graph

Tool	What it does
suggest_links	Find potential connections between memories
suggest_tags	Recommend tags for content
find_duplicates	Detect duplicate memories
query_explain	Explain retrieval results with per-result relevance

@fozikio/tools-maintenance

Tool	What it does
retrieval_audit	Analyze retrieval quality
resolve	Resolve conflicting memories

@fozikio/tools-vitals

Tool	What it does
vitals_get	Read agent vitals (curiosity, confidence, etc.)
vitals_set	Update agent vitals

@fozikio/tools-reasoning

Tool	What it does
intention	Declare intent before action
notice	Record something noteworthy
contradict	Detect contradictions between statements using NLI
abstract	Create abstraction from a cluster of related memories
surface	Get memories due for review (FSRS scheduling)

---

CLI Commands

These are available via npx fozikio <command>, not through MCP:

fozikio init <name>         # scaffold a workspace
fozikio serve                # start the MCP server
fozikio config               # view or edit configuration
fozikio health               # memory health report
fozikio vitals               # behavioral vitals and prediction error
fozikio wander               # walk through the memory graph
fozikio anomalies            # detect anomalous sessions
fozikio report               # weekly quality report
fozikio maintain fix         # scan and repair data issues
fozikio maintain re-embed    # re-embed memories with current provider
fozikio digest <file>        # process documents through cortex
fozikio agent add <name>     # register a new agent
fozikio agent list            # list registered agents
fozikio agent generate-mcp   # write multi-agent .mcp.json