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