Skip to content
Learn Kiro.

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

SurfaceStatus
Kiro IDESince 1.4 (19 October 2026). Off by default since 1.4.10
Kiro CLISince 2.29.0 (9 October 2026), local V3 sessions only
Kiro WebKiro’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

  1. Select the Memories icon in the activity bar to open the Memory view.
  2. Select the settings gear. Settings opens on Kiro Agent: Memory.
  3. Choose a level.
LevelWhat it does
Use and learnUses memories, changes them when you ask, and creates and refines them automatically
Use but don’t learnUses memories and changes them when you ask, but never on its own
Use onlyUses existing memories and never creates, updates, or deletes them, even when you ask
OffDoes 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:

  1. Type /memories and select config.
  2. Choose read & write, read only, or off. Access changes apply to your next session.
  3. 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?

SteeringMemory
Who writes itYouKiro, from your work
When it appliesEvery time its inclusion rule matchesWhen Kiro judges it relevant
Where it lives.kiro/steering/, committed with the codeKiro’s memory store, per user
Shared with the teamYes, through the repositoryNo
Good forRules, stack, structure, standardsSmall 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.

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.

Was this chapter helpful?