Concepts · Chapter 16 of 69
Memory
Kiro Memory lets the agent learn repository conventions and corrections in one session and recall them in the next. How to turn it on in the IDE and CLI, the access levels, and how it differs from steering.
All levels 5 min read last reviewed 2026-10-21
◎ Learning objective
Explain what Kiro Memory stores and when it is used, turn it on at the right access level in the IDE or CLI, and decide what belongs in memory and what belongs in steering.
Every chat used to start from zero, apart from what you had written into steering. Memory changes that. Kiro can now notice something useful while it works, write it down, and recall it in a later session without being told again.
Kiro’s documentation uses a good example. While debugging, Kiro learns that a repository’s integration tests fail until the local database is seeded. With Memory on, a later session can seed the database first instead of rediscovering the cause.
What Memory is
Memory adds two steps to the context Kiro already uses:
- Learn from the work. As a session goes, the agent can identify something worth keeping and create or refine a memory.
- Recall when relevant. In a later session, Kiro can retrieve a matching memory while it works on your request.
What gets stored is the kind of thing you would otherwise repeat: repository conventions and commands, corrections you made, and approaches already ruled out. In the IDE most memories show the type Preference or Fact, and each one applies either globally or to one repository.
Memory Context Kiro learns from your work in one session and can recall in a later one. It sits alongside steering, session history, compaction summaries, and (in the CLI) knowledge bases. is one form of context among several, and it does not replace any of them.
Where it works
| Surface | Status |
|---|---|
| Kiro IDE | Since 1.4 (19 October 2026). Off by default since 1.4.10 |
| Kiro CLI | Since 2.29.0 (9 October 2026), local V3 sessions only |
| Kiro Web | Kiro’s Memory docs say support is coming soon |
Kiro Web has a separate, older feature also called memory: it learns from the pull request feedback given by whoever created a task. That is covered on the Kiro Web page. Kiro Crew keeps its own memory too.
Turn it on in the IDE
- Select the Memories icon in the activity bar to open the Memory view.
- Select the settings gear. Settings opens on Kiro Agent: Memory.
- Choose a level.
| Level | What it does |
|---|---|
| Use and learn | Uses memories, changes them when you ask, and creates and refines them automatically |
| Use but don’t learn | Uses memories and changes them when you ask, but never on its own |
| Use only | Uses existing memories and never creates, updates, or deletes them, even when you ask |
| Off | Does not use or change memories. The default |
Turning Memory on or off, or switching to or from Use only, applies to new sessions; the IDE offers a Start new session action. Switching between the two “Use” levels takes effect immediately. Memory is a user setting, so putting it in workspace settings does nothing.
The Memory view lists global memories and those for the repositories open in the window. You can search, filter by type or location, open a memory in a tab, and delete one (Kiro asks you to confirm). In chat, Kiro groups memory activity into entries such as Memory accessed (1) or Memory created (1), and recalled memories appear as their own row in Context Usage, after steering files.
Turn it on in the CLI
Memory in Kiro CLI needs V3, which becomes the default with CLI 3.0 at the end of October 2026 (see the CLI Guide). In a local V3 session:
- Type
/memoriesand selectconfig. - Choose
read & write,read only, oroff. Access changes apply to your next session. - With
read & write, choose whether to turn on Automatic memory updates, which lets Kiro “create and refine memories, including after a session ends”. That setting applies immediately.
Select list under /memories to search and preview what is stored. The list is read-only: to fix or delete a memory, ask Kiro in the chat. When Kiro uses a memory mid-turn, the chat shows a Memory entry with command=get and the memory’s title.
Trust and safety
In a workspace you have not trusted, Kiro can read memories but cannot add, change, or delete them from the chat, whatever level you chose. That stops a cloned repository from planting instructions that follow you into other projects.
Memories also cost context. A recalled memory is text the model reads, so it uses part of the window like steering does.
Memory or steering?
| Steering | Memory | |
|---|---|---|
| Who writes it | You | Kiro, from your work |
| When it applies | Every time its inclusion rule matches | When Kiro judges it relevant |
| Where it lives | .kiro/steering/, committed with the code | Kiro’s memory store, per user |
| Shared with the team | Yes, through the repository | No |
| Good for | Rules, stack, structure, standards | Small facts you keep repeating |
Kiro’s own advice is direct: if a rule must apply consistently, write it in steering. Memory is learned, so it can be incomplete or wrong, and nobody reviews it in a pull request.
Related
- Steering is the context you write yourself.
- Compact a long session covers the other way Kiro keeps context manageable.
- What’s New in Kiro tracks Memory as it reaches more surfaces.
Frequently asked questions
What is memory in Kiro?
Memory lets Kiro carry useful context from one chat session to the next: a repository's commands and conventions, corrections you made, and approaches already ruled out. Kiro learns it from your work and recalls a matching memory when a later session needs it. It arrived in Kiro CLI 2.29.0 for local V3 sessions on 9 October 2026 and in Kiro IDE 1.4 on 19 October 2026.
How do I turn on memory in the Kiro IDE?
Select the Memories icon in the activity bar, then the settings gear, which opens the Kiro Agent: Memory setting. Choose Use and learn, Use but don't learn, or Use only. It defaults to Off since IDE 1.4.10. Turning Memory on or off applies to new sessions, and it is a user setting, so a value in workspace settings has no effect.
How do I manage memory in Kiro CLI?
Memory needs a local V3 session. Type /memories and select config to choose read & write, read only, or off; access changes apply to your next session. With read & write you can also turn on Automatic memory updates. Select list to search and preview stored memories. The list is read-only, so to fix or delete a memory you ask Kiro in the chat.
What is the difference between Kiro memory and steering?
Steering is guidance you write yourself in .kiro/steering/ and the agent follows it every time. Memory is context Kiro learns from your work and recalls when it seems relevant. Kiro's own documentation says that if a rule must apply consistently, write it in steering. Use memory for the small facts you would otherwise keep repeating.
Can I delete what Kiro remembers?
Yes. In the IDE, right-click a memory in the Memory view and choose Delete, or use Delete in its tab; Kiro asks you to confirm, and this works even with Use only. In the CLI, ask Kiro in the chat to delete it, which needs read & write access in a trusted workspace.
☰ Chapter summary
- Memory lets Kiro learn useful context from your work, such as repository commands, conventions, and corrections, and recall it in a later session.
- It arrived in Kiro CLI 2.29.0 (9 October 2026, local V3 sessions only) and Kiro IDE 1.4 (19 October 2026). Kiro Web's docs say Memory support is coming soon.
- IDE: the Kiro Agent: Memory setting defaults to Off since 1.4.10; levels are Use and learn, Use but don't learn, Use only, and Off.
- CLI: /memories → config chooses read & write, read only, or off; Automatic memory updates lets Kiro create and refine memories on its own.
- In a workspace you have not trusted, Kiro can read memories but cannot add, change, or delete them.
- Memory is learned and may be wrong; anything that must always apply belongs in steering, which you write yourself.
All chapter summaries are collected on the revision page.
Related chapters
- ConceptsSteeringSteering files give Kiro permanent project knowledge. Where they live, the four inclusion modes, how scopes merge, and how AGENTS.md fits in.
- ConceptsKiro IDEThe Kiro IDE is a VS Code-style desktop editor with the agent built in. Platform support, autonomy modes, checkpoints, and context providers.
- ConceptsKiro CLIkiro-cli brings the Kiro agent to your terminal. Install, slash commands, the V3 switch in CLI 3.0, /memories, /sandbox, headless CI runs, and ACP for JetBrains and Zed.
- ConceptsKiro WebKiro Web runs the Kiro agent in your browser at app.kiro.dev on GitHub and GitLab repos. Which plans include it, autonomous mode, Automations, Workflows, effort, and Memory.
- RecipesCompact a Long SessionUse /compact in Kiro CLI, understand what automatic compaction keeps and summarises, and tune compaction.excludeMessages before you hit a context limit.