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

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