Recipes · Chapter 30 of 63
Recipes
Twenty-one short, verified how-to guides for Kiro: steering files, hooks, MCP, agents, skills, permissions, checkpoints, CI, cloud sessions, and Kiro Crew.
All levels 2 min read last reviewed 2026-09-04
◎ Learning objective
Find the recipe that matches the job in front of you, and know which concept chapter to read if the recipe assumes something you have not met yet.
Recipes are the short way to get one thing done in Kiro. Each one is a single task with numbered steps, a check, and the problems people usually hit.
If a recipe assumes a term you do not know, the linked concept chapter explains it in plain language. The cheat sheet condenses the same commands and files on one page.
Set up your project
| Recipe | What you get |
|---|---|
| Create your first steering file | product, tech, and structure rules the agent reads every time |
| Use AGENTS.md as steering | one file that other tools also read |
| Add an MCP server | external tools and data for the agent |
| Add a Power | a one-click bundle for a whole technology |
| Create a custom agent | a scoped assistant with its own tools |
| Build a read-only reviewer agent | an agent that can read but never write |
| Write a skill | reusable instructions the agent loads on demand |
Automate the chores
| Recipe | What you get |
|---|---|
| Run tests on save with a hook | tests that run themselves |
| Keep docs in sync with a hook | documentation that follows the code |
| Fix a bug with a bugfix spec | a written analysis and a regression test before the fix |
| Run Kiro CLI headless in CI | the agent inside a pipeline |
| Schedule a Web automation | recurring work that lands as pull requests |
| Start a cloud session from the CLI | an agent that keeps running when your laptop closes |
| Run Kiro Crew 24/7 | an always-on agent on your own hardware |
Stay safe and in control
| Recipe | What you get |
|---|---|
| Set up permissions.yaml | deny, ask, and allow rules for every capability |
| Keep secrets out with .kiroignore | files the agent never reads |
| Undo with checkpoints and rewind | a way back when a turn goes wrong |
| Compact a long session | room to keep going before the context fills |
Tune the model
| Recipe | What you get |
|---|---|
| Change the default model | the right model for the job, and what Auto does |
| Set the reasoning effort | faster and cheaper, or deeper, per session |
| Use Kiro CLI in JetBrains or Zed | Kiro’s agent inside another editor over ACP |
Frequently asked questions
How long does a recipe take?
Most take five to fifteen minutes. The Kiro Crew and CI recipes take longer because they involve another system.
Do recipes work in the IDE, the CLI, or both?
Each recipe says which surface it applies to. Steering, MCP, agents, skills, permissions, and .kiroignore work across surfaces. /compact, rewind, and ACP are CLI-only. Checkpoints are IDE-first.
What if a command in a recipe does not exist in my version?
Update Kiro first. Each recipe notes the version a feature arrived in when the docs state one, and links to the official page.
☰ Chapter summary
- A recipe is one task in one page: when to use it, the steps, how to check it worked, and the usual problems.
- Setup recipes cover steering, AGENTS.md, hooks, MCP servers, Powers, agents, and skills.
- Safety recipes cover permissions.yaml, .kiroignore, checkpoints and rewind, and compaction.
- Automation recipes cover headless CI, Web automations, cloud sessions, and running Kiro Crew 24/7.
- Every command and file path in a recipe is verified against the official docs; anything not verified is described in prose and linked to the docs.
All chapter summaries are collected on the revision page.
Related chapters
- Core knowledgeCore ConceptsThe twelve ideas that make up Kiro, each in one paragraph with a link to its full page, plus permissions, checkpoints, compaction, and a surface matrix.
- ReferenceCheat SheetKiro on one page: file paths, CLI commands, slash commands, permissions, the five surfaces, and the mistakes that bite, in scannable card form.
- Hands-onAdvanced TutorialA production-shaped workflow that combines specs, steering, hooks, MCP, custom agents, and skills, written for engineers who already know the basics.
- Hands-onKiro CLI GuideInstall kiro-cli, drive sessions with slash commands, manage agents and context, and take the agent into scripts and CI.