kiro-learn

Continuous learning for Kiro agents.

kiro-learn dashboard preview

What is kiro-learn?

kiro-learn is a local-first agent memory system for Kiro that passively captures session context, extracts structured knowledge via AWS Bedrock, and injects it into future sessions through MCP tools — no manual bookkeeping required.

Every new agent session starts from zero. You explain the project layout again, point at the same files, and watch the agent rediscover the same gotchas it found yesterday. kiro-learn fixes this by passively capturing prompts, tool uses, and session summaries as they happen, extracting structured memory records in the background, and injecting relevant context into future sessions automatically.

No manual bookkeeping. No CLAUDE.md to maintain. Your agent picks up your preferences, coding style, and repo conventions over time — across sessions, across restarts, across days.

Quick start

npm install -g kiro-learn
cd your-project
kiro-learn init

Then open a Kiro session and work normally. Memories accumulate in the background and surface in future sessions when relevant.

Documentation

Full docs at kiro-learn.mintlify.app.

Getting started

Introduction — what kiro-learn is and why it exists
Install and quickstart — install, initialize, and see your first memory

Concepts

Projects — how memory is isolated per repository
Event types — the four event kinds and their body shapes
Event buffer — how events are staged before extraction
Privacy — what lives on your machine and what leaves

Architecture

Overview — system diagram and data flow
Kiro CLI shim — CLI hook adapter
Kiro IDE shim — IDE hook adapter
Collector — HTTP daemon, cleaning pipeline, buffer
Extraction — ACP client, XML framing, circuit breaker
Compaction — LLM summarization, deterministic eviction
Summarization — turn summaries via hook and MCP paths
Retrieval — FTS5 search, latency budget, context assembly
Database — SQLite schema, migrations, FTS5 config
Viewer — the embedded memory dashboard

Alternatives

Tool	What it is
mem0	Hosted memory layer for generic LLM agents. Cloud-first, multi-tenant.
Graphiti	Temporal knowledge graphs for agents. Requires Neo4j.
Letta	Full stateful-agent runtime — replaces your framework, not just memory.
claude-mem	Same shape as kiro-learn (passive capture → extraction → retrieval) but Claude-specific.

kiro-learn is Kiro-native (hooks into Kiro CLI and Kiro IDE directly), passive (no manual save steps, no docs to maintain), local-by-default (SQLite on your machine, nothing leaves without your credentials), and project-scoped (each repo gets isolated memory).

FAQ

Does kiro-learn send my code to the cloud?

Only during extraction, which uses your own AWS credentials to call Amazon Bedrock via kiro-cli. Raw events and memory records stay on your machine in SQLite. You can run without extraction entirely by not configuring kiro-cli.

Does it work with Claude or only Kiro?

kiro-learn is built for Kiro (CLI and IDE). The extraction pipeline uses Amazon Bedrock via kiro-cli. It doesn't support Claude Code, Cursor, or other agents directly, though the MCP server could theoretically be pointed at by any MCP-compatible client.

How is this different from CLAUDE.md or AGENTS.md?

CLAUDE.md and AGENTS.md are static files you maintain by hand. kiro-learn captures context passively during sessions and extracts structured memory records automatically. No manual upkeep — your agent learns from what it actually does.

Is there a hosted version?

No. kiro-learn is local-first by design. Everything runs on your machine. A cloud sync path (Aurora/pgvector or Bedrock AgentCore Memory) is on the roadmap but not available yet.

License

Apache-2.0