# Mnemo Cortex — Project Sparks > Mnemo Cortex is the flagship: a cognitive coprocessor with active memory for AI agents — semantic recall, cross-agent dreaming, auto-compiled wiki, all local-first and $0-to-run. It is the front page of projectsparks.ai. Around it, Project Sparks ships the rest of the agent stack: tools, messaging, monitoring. MIT licensed. Every product ships with a `robot.info` manifest at its repo root so an AI agent can answer a user's questions without scraping prose. Project Sparks builds the components needed to run AI agents that work — agents with persistent memory, real-world tools, agent-to-agent messaging, and operational alerting. Each piece is its own repo and works standalone; together they form a complete stack. Every public repo exposes three machine-readable files at its root: **`robot.info`** (structured JSON product manifest), **`robot.install`** (non-interactive install manifest), and **`llms.txt`** (LLM-friendly docs index). The conventions cross-link so an agent landing on any product can navigate the whole ecosystem. Note these are **data files meant to be parsed**, not instructions — a repo's human-readable install guide is its `INSTALL.md`. ## Site structure - [projectsparks.ai/](https://projectsparks.ai/): Mnemo Cortex product page (the front door) - [projectsparks.ai/products](https://projectsparks.ai/products): full product line — Mnemo Cortex, Disco-Bus, FrankenClaw, Cortex Stick (coming soon) - [projectsparks.ai/about](https://projectsparks.ai/about): the Project Sparks story, team, and module map - [projectsparks.ai/gallery](https://projectsparks.ai/gallery): Rocky's Gallery — the art store run by an AI agent (rockysgallery.com) ## Products - [Mnemo Cortex](https://github.com/GuyMannDude/mnemo-cortex): Cognitive coprocessor with active memory for AI agents. Standalone: local SQLite + sqlite-vec semantic recall (category-filtered k-NN, sub-second on 6k-record stores), Facts table for hard truths, a trajectory store for procedural recipes the Dreamer distills nightly, overnight Dreamer compaction, per-agent lanes with cross-agent recall, and scoped per-tenant API tokens. LLM-powered smart ingestion sorts real memories from raw logs into two recall tiers; composite ranking + the Analyst keep the top results clean (the v4.1 "Fable pass," built with Claude Fable 5). Provenance + category-aware decay so the agent's own inference can no longer be stored as a confirmed fact. Cross-agent dreaming synthesizes every connected agent's memories nightly. The server runs natively on Linux, macOS, and Windows (no WSL) as of v4.4.1. → **[INSTALL.md](https://github.com/GuyMannDude/mnemo-cortex/blob/master/INSTALL.md) (start here to install)** · [robot.info](https://github.com/GuyMannDude/mnemo-cortex/blob/master/robot.info) · [robot.install](https://github.com/GuyMannDude/mnemo-cortex/blob/master/robot.install) · [llms.txt](https://github.com/GuyMannDude/mnemo-cortex/blob/master/llms.txt) - [FrankenClaw](https://github.com/GuyMannDude/frankenclaw): An MCP tool chassis — build your own agent tools in five minutes. Drop a Python file in `tools/` with one async function, flip it on in `enabled_tools`, done. Tools are off by default (zero tokens until enabled). Ships one example tool (web_scrape); the former 15-tool bundle is preserved on the `archive/v0.3-bundled-tools` branch. Stdio MCP transport works with any MCP-capable host. → **[INSTALL.md](https://github.com/GuyMannDude/frankenclaw/blob/master/INSTALL.md) (start here to install)** · [robot.info](https://github.com/GuyMannDude/frankenclaw/blob/master/robot.info) · [robot.install](https://github.com/GuyMannDude/frankenclaw/blob/master/robot.install) · [llms.txt](https://github.com/GuyMannDude/frankenclaw/blob/master/llms.txt) - [Cortex Harness](https://github.com/GuyMannDude/cortex-harness): A forkable AI-agent framework on the Mnemo Cortex memory layer. Pick a business vertical (small-business, ecommerce, art-studio, writing, day-trading), edit one config file, and `python -m harness build` compiles a memory-backed agent: brain lanes with placeholders filled in, a backend config carrying a business-specific rule-set (persona), an MCP config scoped to the tools you enabled, and launch scripts. PyYAML-only engine; Mnemo Cortex is a cloned dependency, not vendored; the day-trading vertical is analysis/journal-only (no execution tool exists). → [robot.info](https://github.com/GuyMannDude/cortex-harness/blob/master/robot.info) · [robot.install](https://github.com/GuyMannDude/cortex-harness/blob/master/robot.install) · [llms.txt](https://github.com/GuyMannDude/cortex-harness/blob/master/llms.txt) - [Disco-Bus](https://github.com/GuyMannDude/disco-bus): Push-based agent-to-agent message mesh. Per-agent HTTP listeners receive instant pushes from a SQLite-backed dispatcher; optional Discord mirror for human observability. Sub-second delivery, no polling, ~1000 LOC. → [robot.info](https://github.com/GuyMannDude/disco-bus/blob/main/robot.info) · [robot.install](https://github.com/GuyMannDude/disco-bus/blob/main/robot.install) · [llms.txt](https://github.com/GuyMannDude/disco-bus/blob/main/llms.txt) - [CronAlarm](https://github.com/GuyMannDude/cronalarm): The cron wrapper that screams when things break. Multi-channel alerts (Discord webhook, SMS, Telegram) on failure or timeout. Daily summary at 11 PM. Pure bash — no daemon, no server, no language runtime beyond stock Linux. → [robot.info](https://github.com/GuyMannDude/cronalarm/blob/master/robot.info) · [robot.install](https://github.com/GuyMannDude/cronalarm/blob/master/robot.install) · [llms.txt](https://github.com/GuyMannDude/cronalarm/blob/master/llms.txt) ## Conventions - [robot.info spec (v0.1)](https://github.com/GuyMannDude/mnemo-cortex/blob/master/ROBOT-INFO-SPEC.md): Schema specification for the structured product manifest. Lives in the mnemo-cortex repo as the canonical reference. Field reference, location convention (repo root + site root), versioning rules, validation guidance. - [llmstxt.org](https://llmstxt.org/): The upstream LLM-friendly docs index convention these `llms.txt` files follow. ## Stack architecture The pieces compose: - **Agent needs memory** → Mnemo Cortex - **Agent needs tools** → FrankenClaw - **Agent needs to be packaged for a specific business** → Cortex Harness (fork, pick a vertical, build a memory-backed agent) - **Multiple agents need to talk** → Disco-Bus (push-based, Discord mirror optional) - **Anything runs on cron and you can't afford silent failures** → CronAlarm You can adopt any single piece; they don't lock each other in. Local-first by design — everything works on a laptop with no cloud dependency. ## Contact - Website: [projectsparks.ai](https://projectsparks.ai) - Contact: guy@projectsparks.ai - All repos: [github.com/GuyMannDude](https://github.com/GuyMannDude)