GreyMatter Solo

Your AI has amnesia. Fix it.

Persistent memory modeled on the human brain. Security on every LLM call. Expert agents that carry context. All local. Nothing leaves your machine.

Get Started Free GitHub
curl -sSL https://greymatter.axiomworks.ai/install | bash click to copy

Every AI session starts at zero.

Your architecture decisions, your coding patterns, your preferences — gone. Every session, you re-explain. Every session, your AI starts as a stranger. Context windows aren't memory. They're a junk drawer that empties when you close the tab.

GreyMatter fixes this.

A Second Brain, Not a Context Window

Cognitive Memory — Modeled on the Human Brain

GreyMatter doesn't just store text in a database. It models memory the way your brain does.

Spaced repetition (FSRS-6): Important knowledge gets reinforced. Stale knowledge decays naturally — following the same power-law forgetting curves neuroscientist Hermann Ebbinghaus documented in 1885. Your AI's memories age like yours do. The important ones get stronger.

Five memory types: Observations (raw notes), patterns (recurring behaviors), expertise (domain knowledge), corrections (mistakes learned from), and gotchas (traps to avoid). Each type has different decay rates and promotion paths.

Cross-session consolidation: After each session, GreyMatter reviews what was observed, detects contradictions with existing knowledge, and promotes stable observations into permanent expertise. Like sleep consolidation for your AI.

Review it on your phone. The GreyMatter mobile app lets you browse your AI's knowledge graph, confirm what matters, correct what's wrong, and strengthen fading memories — like Anki flashcards, but for your AI's brain.

Semantic + Full-Text Search

Two search modes, both local. Full-text search (FTS5) finds anything by keyword, instantly. Semantic search (via local Ollama + nomic-embed-text) finds conceptually related knowledge even when the exact words don't match. Ask "how do we handle auth?" and find entries about JWT tokens, session cookies, and OAuth flows — even if those words never appear in your query.

Local-First

One SQLite database. On your machine. Nothing sent to any server, ever. EU AI Act compliant by architecture — data sovereignty solved at the design level.

Knowledge Graph

Observations become patterns. Patterns become expertise. Duplicates detected. Contradictions resolved. Your AI gets smarter the more you use it.

17 MCP Tools

Full Claude Code integration via Model Context Protocol. Memory, work queue, security, agents — all accessible through natural conversation. Type /mcp to see them.

BSL 1.1 Licensed

Source code is public. Read it, fork it, learn from it. Free for non-production use. Source converts to Apache 2.0 after the Change Date.

GreyMatter Security

Every. Single. LLM Call. Scanned.

Every line of code your AI writes passes through an LLM. What else passes through? Your API keys. Your database credentials. Your customers' PII. GreyMatter scans inline — before your data ever reaches a model endpoint.

PII Detection: SSNs, credit cards, API keys, AWS credentials, private keys, phone numbers — caught and redacted before the model sees them.

Prompt Injection Guard: Instruction override, system prompt extraction, role hijacking, delimiter attacks — blocked at the gate.

Append-Only Audit Trail: Every scan logged. Every block recorded. Full forensic history in your database.

This isn't a plugin you install later. Security runs on every LLM interaction by default. You can't use GreyMatter without it.

SecureLLM is also available as a standalone enterprise product with compliance reporting, multi-tenant policies, and provider-level proxy controls. Learn more

Expert Agent System

Not One Assistant — A Team

An agent without context is just a fancy autocomplete. GreyMatter agents carry "souls" — persistent identity documents with domain expertise, coding standards, common patterns, and failure modes.

When GreyMatter dispatches a work item, it matches the task to the right expert using vector similarity. A Rust memory safety issue gets the Rust Systems expert. A React component gets the TypeScript Frontend expert. The right brain for every job.

Autonomous work queue: Submit tasks, set priorities, walk away. Agents execute in parallel, run quality gates, and generate follow-up work items. Your pipeline runs 24/7.

Create your own experts by dropping a markdown file in ~/.greymatter/soul/experts/. Your team, your specializations, your rules.

Quick Start

1

Install GreyMatter

curl -sSL https://greymatter.axiomworks.ai/install | bash

Checks for Claude Code (installs it if missing), downloads GreyMatter, sets up your database, configures the MCP plugin, and verifies everything. Two minutes.

2

Log into Claude Code

With an Anthropic API key:

export ANTHROPIC_API_KEY=your-key-here

Or with a Claude Pro/Team subscription, start Claude and type:

/login
3

Open your project and start Claude

cd your-project-directory
claude

Claude starts with GreyMatter's 17 tools loaded. Type /mcp to see them.

Try these in your first session

"What GreyMatter tools do I have?"
See all 17 tools — memory, work queue, security, agents
"Remember that our API uses REST with JWT auth"
Saves to your knowledge graph — Claude remembers next session
"Create a work item to add unit tests for auth"
Queues a task for AI agents to pick up
"Scan this project for any hardcoded secrets"
GreyMatter Security scans for PII, API keys, credentials
"What patterns have you noticed in this codebase?"
Searches your accumulated observations and knowledge
4

Optional: Local LLM for Semantic Search

Ollama enables vector search — finding conceptually related knowledge. GreyMatter works without it (keyword search only).

curl -fsSL https://ollama.com/install.sh | sh
ollama serve
ollama pull nemotron-3-nano      # reasoning
ollama pull nomic-embed-text    # embeddings

Teams — Multiplayer AI

Solo First. Teams When You're Ready.

GreyMatter Solo works standalone. When you're ready to scale across machines or collaborate with other developers, toggle on Teams mode.

CRDT sync: Work offline. Changes merge automatically when you reconnect. No conflicts, ever. Built on conflict-free replicated data types — the same technology Linear and Figma use internally.

Multi-node orchestration: Distribute work across your MacBook, a server, a Linux box — all coordinated through a central control plane.

Privacy by design: Your personal observations never sync. Team knowledge is shared. You control the boundary. Up to 3 team connections per Solo instance.