๐Ÿ”ฅ persistent memory for AI sessions

Your AI can read your code.
infernoflow tells it everything your code doesn't say.

Persistent memory for AI coding sessions. Captures decisions, gotchas, and context โ€” the stuff that lives in your head, not your codebase.

$ npm install -g infernoflow
Get started free โ†’ View on GitHub โ†’

Works with your AI coding tools

๐Ÿค– GitHub Copilot
โšก Cursor
๐Ÿ”ถ Claude Code
๐ŸŒŠ Windsurf
๐Ÿ’ป VS Code

Everything your AI needs
to stay in context

infernoflow runs silently in the background, capturing what your AI can't infer from code alone. Local-first, zero network calls.

๐Ÿง 

Persistent session memory

Log decisions, gotchas, and in-progress work. When you start a new session, your AI loads the full context automatically.

๐Ÿช

Auto-capture via MCP

Your AI agent calls amp_write directly through MCP โ€” gotchas, decisions, and failed attempts get logged as you work, no copy-paste required. Optional git hook for commit messages too.

โšก

Instant context switching

Run infernoflow switch to generate a full handoff โ€” open threads, git activity, session duration, and next steps.

๐Ÿ”“

AMP โ€” open protocol

Memory stored in .ai-memory/sessions.jsonl using the AI Memory Protocol โ€” vendor-neutral, MIT-licensed. Any AMP-compatible tool can read it. No lock-in.

๐ŸŒฟ

Branch-aware memory

Memory routes into .ai-memory/branches/<branch>.jsonl โ€” travels with git. Switch branches, your AI sees the right context. Teammates inherit memory by checking out your branch.

๐Ÿ“ก

MCP server included

Ships with MCP tools your AI calls automatically: amp_write, amp_read, amp_search, amp_handoff, amp_health, plus four infernoflow_* helpers. Zero configuration.

Up and running in 60 seconds

Three commands and your AI has persistent memory for every project.

1

Install globally

Run npm install -g infernoflow once. Works on Node 18+.

2

Initialize your project

Run infernoflow init in your project root. Creates .ai-memory/, wires the MCP server into Claude Code / Cursor / VS Code Copilot in one command, and generates the rule files (CLAUDE.md / .cursorrules / copilot-instructions.md) your AI reads automatically.

3

Log as you work

Run infernoflow log "decided to use Zustand over Redux" to capture decisions. Git hooks capture commit context automatically. Your AI reads it all on the next session start.

4

Switch sessions cleanly

Run infernoflow switch to generate a rich handoff. Open threads, git activity, session duration, IDE โ€” everything the next session needs to hit the ground running.

Stop re-explaining your codebase
to your AI every morning.

One CLI, one VS Code extension, one open protocol. Free, MIT-licensed, alpha.

Install in 60 seconds โ†’ Star on GitHub โ†’
โœ“ Copied to clipboard