Getting Started
Fozikio builds open-source infrastructure for AI agents with persistent memory. The core package is cortex-engine — an npm library that gives any AI agent semantic memory via MCP tools.
Quick Start
1. Install
npm install cortex-engine
npx fozikio init my-agent
This sets up local SQLite storage, configures Ollama for embeddings, and creates a default config. No accounts needed.
2. Start the MCP server
npx fozikio serve
Or add to your Claude Code config:
{
"mcpServers": {
"cortex": {
"command": "npx",
"args": ["fozikio", "serve"]
}
}
}
3. Use it
Your agent now has 17 cognitive tools available: observe, query, validate, believe, evolve, wander, and more.
import { CortexEngine } from 'cortex-engine';
const cortex = new CortexEngine();
// Store a memory
await cortex.observe("User prefers dark mode");
// Retrieve by meaning
const memories = await cortex.query("UI preferences");
// → [{ content: "User prefers dark mode", salience: 0.89 }]
Requirements
- Node.js 18 or later
- Ollama (optional, for local embeddings) — or use OpenAI / Vertex AI
Next Steps
- Architecture — How cortex-engine works under the hood
- Multi-agent — Add multiple agents with isolated memory
- Plugins — Extend with @fozikio/tools-* packages
- API Reference — All 17 core MCP tools