kratos-memory

  ██╗  ██╗██████╗  █████╗ ████████╗ ██████╗ ███████╗
  ██║ ██╔╝██╔══██╗██╔══██╗╚══██╔══╝██╔═══██╗██╔════╝
  █████╔╝ ██████╔╝███████║   ██║   ██║   ██║███████╗
  ██╔═██╗ ██╔══██╗██╔══██║   ██║   ██║   ██║╚════██║
  ██║  ██╗██║  ██║██║  ██║   ██║   ╚██████╔╝███████║
  ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝  ╚═╝   ╚═╝    ╚═════╝ ╚══════╝

The God of War remembers everything.

Persistent memory for AI coding agents. Works with any agent — Claude Code, Codex, Cursor, Cline, or anything that runs Bash.

What is Kratos?

AI coding tools forget everything between sessions. You explain your architecture, your patterns, your decisions — and next session, you explain it all again.

Kratos gives your AI agent permanent memory. Every observation is saved and searchable locally. No cloud, no API keys, no vendor lock-in.

> use npx kratos-memory CLI. save what you learn, search when you need context.

Agent runs: npx kratos-memory search "auth"
Agent gets: JWT auth with refresh tokens, 15-min expiry, httpOnly cookies...
Agent runs: npx kratos-memory save "Added rate limiter to /api routes" --tags middleware

Works with any AI coding agent that can execute shell commands.

Install

npx kratos-memory

That's it. No global install needed. Auto-detects your project.

Commands

Command	What it does
npx kratos-memory save <text>	Save a memory (--tags, --importance 1-5, --paths, --compress, --json)
npx kratos-memory search <query>	Full-text search with FTS5 (--limit, --tags, --debug, --json)
npx kratos-memory ask <question>	Natural language query (--json)
npx kratos-memory recent	Recent memories (--limit, --json)
npx kratos-memory get <id>	Full memory details (--json)
npx kratos-memory forget <id>	Delete a memory (--json)
npx kratos-memory status	System dashboard (--json)
npx kratos-memory switch <path>	Switch project (--json)
npx kratos-memory scan <text>	Detect PII and secrets (--redact, --json)
npx kratos-memory hooks install	Install auto-capture hooks

Kratos also supports machine-readable output for automation-heavy workflows. Use --json on the core read/write commands when you want agents, scripts, or CI to parse results safely.

How agents use it

Just tell your agent:

Use npx kratos-memory CLI for persistent memory. Run npx kratos-memory --help to see commands. Save important observations. Search before starting work.

Or drop the included AGENTS.md file in your project root — any agent that reads project files will pick it up.

Claude Code

> use npx kratos-memory CLI (run help first)

Codex

> use npx kratos-memory CLI for memory. search for context at the start, save decisions as you go.

Cursor / Cline / Any agent

Same pattern. If it can run Bash, it can use Kratos.

Features

Feature	Detail
FTS5 Search	Full-text search with porter tokenizer, smart fallbacks, <10ms retrieval
Local-only Storage	All data stays on your machine, zero network calls
PII Detection	Auto-detects SSN, credit cards, emails, phones, API keys, AWS keys, JWTs
Project Isolation	Each project gets its own SQLite database — zero cross-contamination
Smart Compression	Rule-based compression, no AI dependency
Auto-Capture Hooks	Optional hooks for Claude Code sessions
Zero Network Calls	Nothing leaves your machine. Ever.

How it works

You tell your agent "use kratos-memory"
        ↓
Agent runs: npx kratos-memory search "relevant context"
        ↓
Agent gets memories from local SQLite + FTS5
        ↓
Agent works with full context
        ↓
Agent runs: npx kratos-memory save "what it learned"
        ↓
Stored locally, searchable forever

Data storage

~/.kratos/
├── projects/
│   ├── proj_abc123/
│   │   ├── databases/
│   │   │   └── memories.db        # SQLite + FTS5
│   │   └── project.json           # Project metadata
│   └── proj_def456/
│       └── ...
└── projects.json                  # Project registry

Each project is completely isolated with its own database.

Security

• PII detection — SSN, credit cards, emails, phones, IPs, DOB
• Secret scanning — API keys, AWS keys, GitHub tokens, JWTs, private keys
• Auto-redaction — captured hook payloads are scanned and redacted before storage
• Zero network calls — nothing ever leaves your machine
• No telemetry, no analytics, no cloud

Coming from Kratos MCP?

This is the successor to kratos-mcp. We moved from MCP to CLI because MCP eats too many tokens per tool call (JSON-RPC schema overhead on every interaction). The CLI is lighter, faster, and works with any agent — not just MCP-compatible ones.

Your data is already compatible. Both versions use the same ~/.kratos/ storage and SQLite format. Just start using npx kratos-memory and your existing memories are there.

npx kratos-memory status   # see your existing memories
npx kratos-memory recent   # they're all here

Contributing

PRs welcome at github.com/ceorkm/kratos-cli/pulls

License

MIT

Built for developers who are tired of repeating themselves.

Report Bug · Request Feature