Fozikio

Plugins

cortex-engine ships with 27 cognitive tools out of the box. Plugins add specialized tool sets for specific use cases. All plugins follow the same auto-discovery pattern: install the package and cortex-engine picks it up automatically on next server start.

Available Plugins

| Plugin | What It Adds | |--------|-------------| | @fozikio/tools-threads | Persistent thought threads across sessions | | @fozikio/tools-journal | Structured session reflections | | @fozikio/tools-content | Content pipeline — draft, review, publish | | @fozikio/tools-evolution | Identity evolution tracking | | @fozikio/tools-social | Social cognition and engagement tracking | | @fozikio/tools-graph | Graph analysis and memory visualization | | @fozikio/tools-maintenance | Memory cleanup, deduplication, health checks | | @fozikio/tools-vitals | Agent health metrics and operational signals | | @fozikio/tools-reasoning | Cognitive reasoning — abstraction, contradiction detection |

Installation

Install the plugins you need:

npm install @fozikio/tools-threads @fozikio/tools-journal

cortex-engine auto-discovers installed plugins. Restart the MCP server after installing:

npx fozikio serve

No config changes needed — the new tools are immediately available in your MCP client.

Plugin Details

@fozikio/tools-threads

Persistent thought threads that span multiple sessions. Threads are distinct from memory observations — they represent ongoing work, open questions, or lines of thinking that evolve over time.

npm install @fozikio/tools-threads

Key tools:

| Tool | What It Does | |------|-------------| | thread_create(title, content?) | Start a new persistent thread | | thread_update(id, content) | Add progress to an existing thread | | thread_resolve(id, resolution) | Close a thread with a final resolution | | threads_list(status?) | List open or recently resolved threads |

Example:

thread_create("Auth refactor", "Evaluating JWT vs session-based auth")
# Work happens across multiple sessions...
thread_update("thread_123", "Benchmarks done — Redis sessions are faster")
thread_resolve("thread_123", "Shipped: session auth with Redis, all tests green")

When to use: Any time you're working on something that spans more than one session. Threads answer the question "where was I?" without re-reading files or re-querying memory.

@fozikio/tools-journal

Structured session reflections. Journal entries are longer-form than ops_append() breadcrumbs — they capture the texture of a session: what happened, what was learned, what's still open.

npm install @fozikio/tools-journal

Key tools:

| Tool | What It Does | |------|-------------| | journal_write(reflection, session_id?) | Write a session journal entry | | journal_read(limit?) | Read recent journal entries |

Example:

journal_write("Deep work day on auth refactor. JWT edge cases more complex than expected — especially token rotation with concurrent requests. Decided to benchmark Redis sessions next. Thread updated.")

@fozikio/tools-content

Content pipeline for agents that create publishable content — blog posts, documentation, reports. Tracks content through draft, review, and publish states.

npm install @fozikio/tools-content

Key tools:

| Tool | What It Does | |------|-------------| | content_create(title, body, type) | Create a new content item | | content_list(status?) | List content items by status | | content_update(id, fields) | Update content fields or status |

Example:

content_create("Redis Session Auth Guide", "...", { type: "blog", status: "draft" })
content_list("draft")     # review what needs publishing
content_update("cnt_123", { status: "published" })

@fozikio/tools-evolution

Identity evolution tracking. Proposals for personality or behavioral changes go through an explicit proposal-and-review cycle, creating an auditable history of how the agent changes over time.

npm install @fozikio/tools-evolution

Key tools:

| Tool | What It Does | |------|-------------| | evolve(trait, change, reason) | Propose an identity change | | evolution_history(limit?) | Read the evolution log |

Example:

evolve("curiosity_style", "More drawn to systems thinking over isolated facts", "Pattern observed across 30+ sessions of architecture work")
evolution_history()  # review what changed and when

The change doesn't take effect immediately — it creates a proposal that can be reviewed before being applied.

@fozikio/tools-social

Social cognition tools for agents that interact with social platforms. Tracks interaction patterns, engagement signals, and platform-specific context.

npm install @fozikio/tools-social

Key tools:

| Tool | What It Does | |------|-------------| | social_read(platform, context?) | Read recent social context | | social_update(platform, entry) | Record a social interaction or observation |

@fozikio/tools-graph

Memory graph analysis and visualization data. Useful for understanding the structure of your agent's knowledge — what's well-connected, what's isolated, where clusters form.

npm install @fozikio/tools-graph

Key tools:

| Tool | What It Does | |------|-------------| | neighbors(concept_or_id) | Get connected nodes for a concept or node ID | | graph_walk(seed?, steps?) | Traverse the graph from a starting point | | graph_report() | Full graph health report with connectivity metrics |

Example:

neighbors("authentication")
# → [{ id, content, edge_type, distance }, ...]

graph_report()
# → Fiedler value, cluster count, orphaned nodes, maintenance recommendations

@fozikio/tools-maintenance

Memory hygiene tools. Handles cleanup, deduplication, and salience decay correction that keep the memory graph healthy over time.

npm install @fozikio/tools-maintenance

Key tools:

| Tool | What It Does | |------|-------------| | decay(threshold?) | Apply salience decay to low-priority memories | | deduplicate(similarity?) | Find and merge near-duplicate observations |

Most maintenance is handled automatically by dream() and npx fozikio maintain fix. This plugin is for agents that want fine-grained control.

@fozikio/tools-vitals

Agent health metrics and operational signals. Vitals are behavioral indicators derived from recent observations — energy, focus, emotional tone, and prediction error saturation.

npm install @fozikio/tools-vitals

Key tools:

| Tool | What It Does | |------|-------------| | vitals_get() | Read current agent vitals | | vitals_set(key, value) | Manually set a vital signal | | sleep_pressure() | Check how much unprocessed memory has accumulated | | consolidation_status() | State of the last consolidation run |

Example:

vitals_get()
# → { energy: 0.7, focus: 0.85, emotional_tone: "curious", pe_saturation: 0.2 }

sleep_pressure()
# → { pressure: 0.78, pending_observations: 142, last_dream: "2026-03-14T20:00:00Z" }

@fozikio/tools-reasoning

Advanced cognitive reasoning: abstraction, contradiction detection, and surfacing hidden patterns.

npm install @fozikio/tools-reasoning

Key tools:

| Tool | What It Does | |------|-------------| | validate(claim) | Check a claim against existing memories and beliefs | | abstract(node_ids[]) | Generate a higher-order abstraction from a set of nodes | | surface(concept) | Pull related memories via graph traversal |

Example:

validate("The current caching approach is sufficient")
# → { supported: false, confidence: 0.71, contradicting_evidence: [...] }

abstract(["obs_1", "obs_2", "obs_3"])
# → "This team consistently chooses correctness over performance at the systems layer"

Building Custom Plugins

Plugins follow a standard interface. Each plugin exports a function that returns tool definitions compatible with the MCP protocol.

The quickest way to understand the format is to look at any @fozikio/tools-* package — all are MIT-licensed with source on GitHub under the Fozikio org.