kiro-agent-team 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.kiro/README.md +228 -0
- package/.kiro/agents/backend-engineer.json +6 -0
- package/.kiro/agents/backend-engineer.md +643 -0
- package/.kiro/agents/database-specialist.json +6 -0
- package/.kiro/agents/database-specialist.md +390 -0
- package/.kiro/agents/development-logger.json +6 -0
- package/.kiro/agents/development-logger.md +265 -0
- package/.kiro/agents/devops-engineer.json +6 -0
- package/.kiro/agents/devops-engineer.md +287 -0
- package/.kiro/agents/frontend-architect.json +6 -0
- package/.kiro/agents/frontend-architect.md +1032 -0
- package/.kiro/agents/hooks/backend-engineer-hooks.yaml +540 -0
- package/.kiro/agents/hooks/database-specialist-hooks.yaml +488 -0
- package/.kiro/agents/hooks/development-logger-hooks.yaml +361 -0
- package/.kiro/agents/hooks/devops-engineer-hooks.yaml +345 -0
- package/.kiro/agents/hooks/frontend-architect-hooks.yaml +521 -0
- package/.kiro/agents/hooks/project-manager-hooks.yaml +513 -0
- package/.kiro/agents/hooks/security-specialist-hooks.yaml +358 -0
- package/.kiro/agents/hooks/test-orchestrator-hooks.yaml +380 -0
- package/.kiro/agents/hooks/ui-ux-designer-hooks.yaml +353 -0
- package/.kiro/agents/project-manager.json +6 -0
- package/.kiro/agents/project-manager.md +344 -0
- package/.kiro/agents/prompts/backend-engineer-system.md +815 -0
- package/.kiro/agents/prompts/database-specialist-system.md +332 -0
- package/.kiro/agents/prompts/development-logger-system.md +232 -0
- package/.kiro/agents/prompts/devops-engineer-system.md +260 -0
- package/.kiro/agents/prompts/frontend-architect-system.md +305 -0
- package/.kiro/agents/prompts/project-manager-system.md +285 -0
- package/.kiro/agents/prompts/security-specialist-system.md +231 -0
- package/.kiro/agents/prompts/test-orchestrator-system.md +214 -0
- package/.kiro/agents/prompts/ui-ux-designer-system.md +270 -0
- package/.kiro/agents/security-specialist.json +6 -0
- package/.kiro/agents/security-specialist.md +277 -0
- package/.kiro/agents/test-orchestrator.json +6 -0
- package/.kiro/agents/test-orchestrator.md +266 -0
- package/.kiro/agents/ui-ux-designer.json +6 -0
- package/.kiro/agents/ui-ux-designer.md +284 -0
- package/.kiro/devlog/00-START-HERE.md +444 -0
- package/.kiro/devlog/COMPLETE-WORKFLOW.md +553 -0
- package/.kiro/devlog/DEVLOG-INTEGRATION.md +413 -0
- package/.kiro/devlog/DEVLOG-PROCESS-FLOWS.md +484 -0
- package/.kiro/devlog/DEVLOG-QUICK-REF.md +299 -0
- package/.kiro/devlog/DEVLOG.md +22 -0
- package/.kiro/devlog/IMPLEMENTATION-COMPLETE.txt +434 -0
- package/.kiro/devlog/IMPLEMENTATION-SUMMARY.md +358 -0
- package/.kiro/devlog/README.md +363 -0
- package/.kiro/devlog/devlog-update.bat +136 -0
- package/.kiro/devlog/devlog-update.sh +275 -0
- package/.kiro/devlog/feature-completion-hook.bat +78 -0
- package/.kiro/devlog/feature-completion-hook.sh +84 -0
- package/.kiro/documentation/cli.md +31 -0
- package/.kiro/documentation/docs_cli.md +41 -0
- package/.kiro/documentation/docs_cli_authentication.md +43 -0
- package/.kiro/documentation/docs_cli_autocomplete.md +132 -0
- package/.kiro/documentation/docs_cli_billing.md +31 -0
- package/.kiro/documentation/docs_cli_billing_contact-support.md +43 -0
- package/.kiro/documentation/docs_cli_billing_managing-taxes.md +67 -0
- package/.kiro/documentation/docs_cli_billing_related-questions.md +49 -0
- package/.kiro/documentation/docs_cli_billing_subscription-portal.md +31 -0
- package/.kiro/documentation/docs_cli_chat.md +84 -0
- package/.kiro/documentation/docs_cli_chat_configuration.md +40 -0
- package/.kiro/documentation/docs_cli_chat_context.md +258 -0
- package/.kiro/documentation/docs_cli_chat_git-aware-selection.md +41 -0
- package/.kiro/documentation/docs_cli_chat_images.md +53 -0
- package/.kiro/documentation/docs_cli_chat_manage-prompts.md +216 -0
- package/.kiro/documentation/docs_cli_chat_model-selection.md +153 -0
- package/.kiro/documentation/docs_cli_chat_permissions.md +68 -0
- package/.kiro/documentation/docs_cli_chat_planning-agent.md +230 -0
- package/.kiro/documentation/docs_cli_chat_responding.md +123 -0
- package/.kiro/documentation/docs_cli_chat_security.md +87 -0
- package/.kiro/documentation/docs_cli_chat_subagents.md +77 -0
- package/.kiro/documentation/docs_cli_code-intelligence.md +251 -0
- package/.kiro/documentation/docs_cli_custom-agents.md +37 -0
- package/.kiro/documentation/docs_cli_custom-agents_configuration-reference.md +941 -0
- package/.kiro/documentation/docs_cli_custom-agents_creating.md +93 -0
- package/.kiro/documentation/docs_cli_custom-agents_examples.md +360 -0
- package/.kiro/documentation/docs_cli_custom-agents_troubleshooting.md +180 -0
- package/.kiro/documentation/docs_cli_enterprise_billing.md +33 -0
- package/.kiro/documentation/docs_cli_enterprise_concepts.md +34 -0
- package/.kiro/documentation/docs_cli_enterprise_getting-started.md +19 -0
- package/.kiro/documentation/docs_cli_enterprise_iam.md +251 -0
- package/.kiro/documentation/docs_cli_enterprise_monitor-and-track.md +15 -0
- package/.kiro/documentation/docs_cli_enterprise_monitor-and-track_dashboard.md +62 -0
- package/.kiro/documentation/docs_cli_enterprise_monitor-and-track_prompt-logging.md +165 -0
- package/.kiro/documentation/docs_cli_enterprise_monitor-and-track_user-activity.md +123 -0
- package/.kiro/documentation/docs_cli_enterprise_settings.md +15 -0
- package/.kiro/documentation/docs_cli_enterprise_subscribe.md +36 -0
- package/.kiro/documentation/docs_cli_enterprise_subscription-management.md +55 -0
- package/.kiro/documentation/docs_cli_enterprise_supported-regions.md +39 -0
- package/.kiro/documentation/docs_cli_experimental.md +282 -0
- package/.kiro/documentation/docs_cli_experimental_checkpointing.md +439 -0
- package/.kiro/documentation/docs_cli_experimental_delegate.md +422 -0
- package/.kiro/documentation/docs_cli_experimental_knowledge-management.md +449 -0
- package/.kiro/documentation/docs_cli_experimental_tangent-mode.md +357 -0
- package/.kiro/documentation/docs_cli_experimental_thinking.md +331 -0
- package/.kiro/documentation/docs_cli_experimental_todo-lists.md +385 -0
- package/.kiro/documentation/docs_cli_hooks.md +207 -0
- package/.kiro/documentation/docs_cli_installation.md +235 -0
- package/.kiro/documentation/docs_cli_mcp.md +106 -0
- package/.kiro/documentation/docs_cli_mcp_configuration.md +294 -0
- package/.kiro/documentation/docs_cli_mcp_examples.md +273 -0
- package/.kiro/documentation/docs_cli_mcp_governance.md +436 -0
- package/.kiro/documentation/docs_cli_mcp_security.md +77 -0
- package/.kiro/documentation/docs_cli_migrating-from-q.md +129 -0
- package/.kiro/documentation/docs_cli_privacy-and-security.md +83 -0
- package/.kiro/documentation/docs_cli_privacy-and-security_compliance-validation.md +17 -0
- package/.kiro/documentation/docs_cli_privacy-and-security_data-protection.md +104 -0
- package/.kiro/documentation/docs_cli_privacy-and-security_firewalls.md +26 -0
- package/.kiro/documentation/docs_cli_privacy-and-security_infrastructure-security.md +10 -0
- package/.kiro/documentation/docs_cli_privacy-and-security_vpc-endpoints.md +41 -0
- package/.kiro/documentation/docs_cli_reference_built-in-tools.md +624 -0
- package/.kiro/documentation/docs_cli_reference_cli-commands.md +689 -0
- package/.kiro/documentation/docs_cli_reference_settings.md +294 -0
- package/.kiro/documentation/docs_cli_reference_slash-commands.md +559 -0
- package/.kiro/documentation/docs_cli_steering.md +84 -0
- package/.kiro/guides/AGENT_WORKFLOW_GUIDE.md +294 -0
- package/.kiro/guides/DEVLOG.md +882 -0
- package/.kiro/guides/IMPLEMENTATION_EXAMPLES.md +611 -0
- package/.kiro/guides/PIV Loop.md +122 -0
- package/.kiro/guides/PIV Loop.png +0 -0
- package/.kiro/guides/PIVLoop.png +0 -0
- package/.kiro/guides/QUICK_REFERENCE.md +202 -0
- package/.kiro/guides/README.md +149 -0
- package/.kiro/guides/advanced-patterns.md +514 -0
- package/.kiro/guides/agent-coordination.md +434 -0
- package/.kiro/guides/core-workflows.md +409 -0
- package/.kiro/guides/emergency-procedures.md +414 -0
- package/.kiro/guides/project-evaluation.md +534 -0
- package/.kiro/guides/quality-assurance.md +431 -0
- package/.kiro/guides/quick-start.md +235 -0
- package/.kiro/guides/troubleshooting.md +575 -0
- package/.kiro/guides/walkthroughs.md +711 -0
- package/.kiro/prompts/add-to-devlog.md +263 -0
- package/.kiro/prompts/code-review-fix.md +18 -0
- package/.kiro/prompts/code-review-hackathon.md +167 -0
- package/.kiro/prompts/code-review-security.md +454 -0
- package/.kiro/prompts/code-review.md +113 -0
- package/.kiro/prompts/create-prd.md +151 -0
- package/.kiro/prompts/execute-backend.md +257 -0
- package/.kiro/prompts/execute-frontend.md +438 -0
- package/.kiro/prompts/execute-logging.md +491 -0
- package/.kiro/prompts/execute-security.md +482 -0
- package/.kiro/prompts/execute-testing.md +528 -0
- package/.kiro/prompts/execute.md +101 -0
- package/.kiro/prompts/execution-report.md +72 -0
- package/.kiro/prompts/implement-fix.md +228 -0
- package/.kiro/prompts/plan-feature.md +433 -0
- package/.kiro/prompts/prime.md +73 -0
- package/.kiro/prompts/quality-metrics.md +622 -0
- package/.kiro/prompts/quickstart.md +318 -0
- package/.kiro/prompts/rca.md +220 -0
- package/.kiro/prompts/system-review.md +189 -0
- package/README.md +32 -0
- package/bin/cli.js +97 -0
- package/package.json +33 -0
|
@@ -0,0 +1,258 @@
|
|
|
1
|
+
# Context management
|
|
2
|
+
## Choosing the right context approach[](https://kiro.dev/docs/cli/chat/context/#choosing-the-right-context-approach)
|
|
3
|
+
Kiro offers three ways to provide context, each optimized for different use cases:
|
|
4
|
+
Approach | Context Window Impact | Persistence | Best For
|
|
5
|
+
---|---|---|---
|
|
6
|
+
Agent Resources | Always active (consumes tokens) | Persistent across sessions | Essential project files, standards, configs
|
|
7
|
+
Session Context | Always active (consumes tokens) | Current session only | Temporary files, quick experiments
|
|
8
|
+
Knowledge Bases | Only when searched | Persistent across sessions | Large codebases, extensive documentation
|
|
9
|
+
## Decision flowchart[](https://kiro.dev/docs/cli/chat/context/#decision-flowchart)
|
|
10
|
+
1. Use this decision tree to choose the appropriate context approach:
|
|
11
|
+
* Is your content larger than 10MB or contains thousands of files?
|
|
12
|
+
* Yes → Use Knowledge Bases
|
|
13
|
+
* No → Continue to step 2
|
|
14
|
+
2. Do you need this context in every conversation?
|
|
15
|
+
* Yes → Use Agent Resources
|
|
16
|
+
* No → Use Session Context
|
|
17
|
+
|
|
18
|
+
|
|
19
|
+
### Quick reference[](https://kiro.dev/docs/cli/chat/context/#quick-reference)
|
|
20
|
+
* Essential project files (README, configs, standards) → Agent Resources
|
|
21
|
+
* Large codebases or documentation sets → Knowledge Bases
|
|
22
|
+
* Temporary files for current task → Session Context
|
|
23
|
+
|
|
24
|
+
|
|
25
|
+
## Understanding context window impact[](https://kiro.dev/docs/cli/chat/context/#understanding-context-window-impact)
|
|
26
|
+
* Context files and agent resources consume tokens from your context window on every request, whether referenced or not.
|
|
27
|
+
|
|
28
|
+
|
|
29
|
+
bash
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
> /context show
|
|
33
|
+
|
|
34
|
+
Agent
|
|
35
|
+
- .kiro/steering/**/*.md <project-root>/.kiro/steering/product.md
|
|
36
|
+
<project-root>/.kiro/steering/structure.md
|
|
37
|
+
<project-root>/.kiro/steering/tech.md
|
|
38
|
+
<project-root>/.kiro/steering/testing.md
|
|
39
|
+
- README.md <project-root>/snake/README.md
|
|
40
|
+
- ~/.kiro/steering/**/*.md (no matches)
|
|
41
|
+
|
|
42
|
+
Session (temporary)
|
|
43
|
+
<none>
|
|
44
|
+
|
|
45
|
+
5 matched files in use
|
|
46
|
+
- <project-root>/.kiro/steering/testing.md (0.1% of context window)
|
|
47
|
+
- <project-root>/snake/.kiro/steering/tech.md (0.1% of context window)
|
|
48
|
+
- <project-root>/snake/README.md (0.1% of context window)
|
|
49
|
+
- <project-root>/snake/.kiro/steering/structure.md (0.2% of context window)
|
|
50
|
+
- <project-root>/snake/.kiro/steering/product.md (0.1% of context window)
|
|
51
|
+
|
|
52
|
+
Context files total: 0.5% of context window
|
|
53
|
+
|
|
54
|
+
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
* The output shows:
|
|
58
|
+
* **Agent** : Persistent context from your agent's resources field
|
|
59
|
+
* **Session** : Temporary context added during the current session
|
|
60
|
+
* Context files are limited to 75% of your model's context window. Files exceeding this limit are automatically dropped.
|
|
61
|
+
* Knowledge bases don't consume context window space until searched, making them ideal for large reference materials. For more information, see Knowledge base context (for large datasets).
|
|
62
|
+
|
|
63
|
+
|
|
64
|
+
## Managing context[](https://kiro.dev/docs/cli/chat/context/#managing-context)
|
|
65
|
+
Context files contain information you want Kiro to consider during your conversations. These can include project requirements, coding standards, development rules, or any other information that helps Kiro provide more relevant responses.
|
|
66
|
+
### Configuring persistent context with agent resources[](https://kiro.dev/docs/cli/chat/context/#configuring-persistent-context-with-agent-resources)
|
|
67
|
+
The recommended way to configure context is through the resources field in your agent configuration file. This creates persistent context that is available every time you use the agent.
|
|
68
|
+
Add file paths or glob patterns to the resources array in your agent config:
|
|
69
|
+
json
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
{
|
|
73
|
+
"name": "my-agent",
|
|
74
|
+
"description": "My development agent",
|
|
75
|
+
"resources": [
|
|
76
|
+
"file://README.md",
|
|
77
|
+
"file://docs/**/*.md",
|
|
78
|
+
"file://src/config.py"
|
|
79
|
+
]
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
Resources must be prefixed with file:// to be included as context files. These files will be automatically available in all chat sessions using this agent.
|
|
86
|
+
### Adding temporary session context[](https://kiro.dev/docs/cli/chat/context/#adding-temporary-session-context)
|
|
87
|
+
You can temporarily add files to your current chat session using the /context add command. These additions are only available for the current session and will not persist when you start a new chat session.
|
|
88
|
+
bash
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
> /context add README.md
|
|
92
|
+
Added 1 path(s) to context.
|
|
93
|
+
|
|
94
|
+
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
**Note** : Context modifications via slash command is temporary.
|
|
98
|
+
You can also add multiple files at once using glob patterns:
|
|
99
|
+
bash
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
> /context add docs/*.md
|
|
103
|
+
Added 3 path(s) to context.
|
|
104
|
+
|
|
105
|
+
|
|
106
|
+
|
|
107
|
+
```
|
|
108
|
+
|
|
109
|
+
To make context changes permanent, add the files to your agent's resources field instead. For more information, see Configuring persistent context with agent resources.
|
|
110
|
+
### Knowledge base context (for large datasets)[](https://kiro.dev/docs/cli/chat/context/#knowledge-base-context-for-large-datasets)
|
|
111
|
+
For large codebases, documentation sets, or reference materials that would exceed context window limits, use knowledge bases. Knowledge bases provide semantic search capabilities without consuming context window space until searched.
|
|
112
|
+
Enable knowledge bases:
|
|
113
|
+
kiro-cli settings chat.enableKnowledge true
|
|
114
|
+
Add content to a knowledge base:
|
|
115
|
+
kiro-cli chat
|
|
116
|
+
> /knowledge add /path/to/large-codebase --include "**/*.py" --exclude "node_modules/** "
|
|
117
|
+
Knowledge bases are searched on-demand by Kiro when relevant information is needed, making them ideal for large reference materials.
|
|
118
|
+
### Viewing context usage[](https://kiro.dev/docs/cli/chat/context/#viewing-context-usage)
|
|
119
|
+
To view your current context, use the /context show command:
|
|
120
|
+
bash
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
> /context show
|
|
124
|
+
|
|
125
|
+
Current context window (5.9% used)
|
|
126
|
+
|||████████████████████████████████████████████████████████████████ 5.9%
|
|
127
|
+
|
|
128
|
+
█ Context files 0.9%
|
|
129
|
+
█ Tools 0.5%
|
|
130
|
+
█ Kiro responses 0.7%
|
|
131
|
+
█ Your prompts 3.8%
|
|
132
|
+
|
|
133
|
+
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
### Removing context[](https://kiro.dev/docs/cli/chat/context/#removing-context)
|
|
137
|
+
To remove files from your current session context:
|
|
138
|
+
bash
|
|
139
|
+
```
|
|
140
|
+
|
|
141
|
+
> /context remove src/temp-file.py
|
|
142
|
+
Removed 1 path(s) from context.
|
|
143
|
+
|
|
144
|
+
|
|
145
|
+
```
|
|
146
|
+
|
|
147
|
+
To clear all session context, use the /context clear command:
|
|
148
|
+
bash
|
|
149
|
+
```
|
|
150
|
+
|
|
151
|
+
> /context clear
|
|
152
|
+
Cleared context
|
|
153
|
+
Note: Context modifications via slash command is temporary.
|
|
154
|
+
|
|
155
|
+
|
|
156
|
+
```
|
|
157
|
+
|
|
158
|
+
Note: You cannot remove agent-defined context using /context commands. To permanently remove context, edit your agent's resources field.
|
|
159
|
+
## Context management actions[](https://kiro.dev/docs/cli/chat/context/#context-management-actions)
|
|
160
|
+
Here are some common reasons for actively managing your context window:
|
|
161
|
+
1. If you find yourself repeatedly adding the same context files using `/context add` commands, consider moving them to your agent's resources field for persistence:
|
|
162
|
+
|
|
163
|
+
|
|
164
|
+
bash
|
|
165
|
+
```
|
|
166
|
+
|
|
167
|
+
# Instead of running these commands every session:
|
|
168
|
+
> /context add README.md
|
|
169
|
+
> /context add docs/*.md
|
|
170
|
+
|
|
171
|
+
# Add them to your agent config once:
|
|
172
|
+
{
|
|
173
|
+
"resources": [
|
|
174
|
+
"file://README.md",
|
|
175
|
+
"file://docs/**/*.md"
|
|
176
|
+
]
|
|
177
|
+
}
|
|
178
|
+
|
|
179
|
+
|
|
180
|
+
```
|
|
181
|
+
|
|
182
|
+
You can configure a default agent that includes your preferred context files. This ensures your context is automatically available in new chat sessions without needing to specify the agent each time.
|
|
183
|
+
bash
|
|
184
|
+
```
|
|
185
|
+
|
|
186
|
+
>kiro-cli settings chat.defaultAgent my-project-agent
|
|
187
|
+
|
|
188
|
+
|
|
189
|
+
```
|
|
190
|
+
|
|
191
|
+
1. If you have large context files (consume significant part of context window) consider using knowledge base instead of including those files as is. Use cases to consider knowledge:
|
|
192
|
+
* You have large codebases or documentation sets
|
|
193
|
+
* You need semantic search across extensive materials
|
|
194
|
+
* You want to avoid constant context window consumption
|
|
195
|
+
* Example: Instead of adding a large codebase as context files:
|
|
196
|
+
|
|
197
|
+
|
|
198
|
+
bash
|
|
199
|
+
```
|
|
200
|
+
|
|
201
|
+
# This would consume too many tokens:
|
|
202
|
+
> /context add src/**/*.py
|
|
203
|
+
|
|
204
|
+
# Use knowledge base instead:
|
|
205
|
+
> /knowledge add src/ --include "**/*.py" --exclude "__pycache__/**"
|
|
206
|
+
|
|
207
|
+
|
|
208
|
+
```
|
|
209
|
+
|
|
210
|
+
## Best practices[](https://kiro.dev/docs/cli/chat/context/#best-practices)
|
|
211
|
+
### Context file organization[](https://kiro.dev/docs/cli/chat/context/#context-file-organization)
|
|
212
|
+
1. Keep context files focused and relevant to avoid token limits
|
|
213
|
+
2. Use descriptive filenames that indicate their purpose
|
|
214
|
+
3. Organize rules and documentation in logical directory structures
|
|
215
|
+
4. Consider file size - very large files may consume significant tokens
|
|
216
|
+
|
|
217
|
+
|
|
218
|
+
### Performance considerations[](https://kiro.dev/docs/cli/chat/context/#performance-considerations)
|
|
219
|
+
1. Monitor token usage with /context show to stay within limits
|
|
220
|
+
2. Use specific glob patterns rather than overly broad ones
|
|
221
|
+
3. Remove unused context files from agent configurations
|
|
222
|
+
4. Consider splitting large context files into smaller, focused files
|
|
223
|
+
5. Use knowledge bases for large datasets to avoid context window consumption
|
|
224
|
+
|
|
225
|
+
|
|
226
|
+
### Security considerations[](https://kiro.dev/docs/cli/chat/context/#security-considerations)
|
|
227
|
+
1. Avoid including sensitive information in context files
|
|
228
|
+
2. Use `.gitignore` to prevent accidental commits of sensitive context
|
|
229
|
+
3. Review context files regularly to ensure they don't contain outdated information
|
|
230
|
+
4. Be mindful of what information is shared when using context in conversations
|
|
231
|
+
|
|
232
|
+
|
|
233
|
+
## Related documentation[](https://kiro.dev/docs/cli/chat/context/#related-documentation)
|
|
234
|
+
* [Slash Commands](https://kiro.dev/docs/cli/reference/slash-commands) - In-chat context commands
|
|
235
|
+
* [CLI Commands](https://kiro.dev/docs/cli/reference/cli-commands) - Terminal context commands
|
|
236
|
+
* [Interactive Chat Mode](https://kiro.dev/docs/cli/chat/interactive-mode) - Using context in chat
|
|
237
|
+
|
|
238
|
+
|
|
239
|
+
Page updated: November 21, 2025
|
|
240
|
+
[Prompts](https://kiro.dev/docs/cli/chat/manage-prompts/)
|
|
241
|
+
[Responding to messages](https://kiro.dev/docs/cli/chat/responding/)
|
|
242
|
+
On this page
|
|
243
|
+
* [Choosing the right context approach](https://kiro.dev/docs/cli/chat/context/#choosing-the-right-context-approach)
|
|
244
|
+
* [Decision flowchart](https://kiro.dev/docs/cli/chat/context/#decision-flowchart)
|
|
245
|
+
* [Quick reference](https://kiro.dev/docs/cli/chat/context/#quick-reference)
|
|
246
|
+
* [Understanding context window impact](https://kiro.dev/docs/cli/chat/context/#understanding-context-window-impact)
|
|
247
|
+
* [Managing context](https://kiro.dev/docs/cli/chat/context/#managing-context)
|
|
248
|
+
* [Configuring persistent context with agent resources](https://kiro.dev/docs/cli/chat/context/#configuring-persistent-context-with-agent-resources)
|
|
249
|
+
* [Adding temporary session context](https://kiro.dev/docs/cli/chat/context/#adding-temporary-session-context)
|
|
250
|
+
* [Knowledge base context (for large datasets)](https://kiro.dev/docs/cli/chat/context/#knowledge-base-context-for-large-datasets)
|
|
251
|
+
* [Viewing context usage](https://kiro.dev/docs/cli/chat/context/#viewing-context-usage)
|
|
252
|
+
* [Removing context](https://kiro.dev/docs/cli/chat/context/#removing-context)
|
|
253
|
+
* [Context management actions](https://kiro.dev/docs/cli/chat/context/#context-management-actions)
|
|
254
|
+
* [Best practices](https://kiro.dev/docs/cli/chat/context/#best-practices)
|
|
255
|
+
* [Context file organization](https://kiro.dev/docs/cli/chat/context/#context-file-organization)
|
|
256
|
+
* [Performance considerations](https://kiro.dev/docs/cli/chat/context/#performance-considerations)
|
|
257
|
+
* [Security considerations](https://kiro.dev/docs/cli/chat/context/#security-considerations)
|
|
258
|
+
* [Related documentation](https://kiro.dev/docs/cli/chat/context/#related-documentation)
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
# Working with Git
|
|
2
|
+
When working with Git repositories, Kiro CLI's fuzzy finder is Git-aware, making it easier to select and add relevant files to your context. This feature helps you quickly identify and include files that are part of your Git repository.
|
|
3
|
+
## How Git-aware selection works[](https://kiro.dev/docs/cli/chat/git-aware-selection/#how-git-aware-selection-works)
|
|
4
|
+
The Git-aware fuzzy finder automatically integrates with your repository's Git information to provide enhanced file selection capabilities:
|
|
5
|
+
* Recognizes Git-tracked files in your repository
|
|
6
|
+
* Shows Git status indicators alongside files
|
|
7
|
+
* Prioritizes relevant files based on Git history
|
|
8
|
+
|
|
9
|
+
|
|
10
|
+
## Using Git-aware file selection[](https://kiro.dev/docs/cli/chat/git-aware-selection/#using-git-aware-file-selection)
|
|
11
|
+
###### To use git-aware file selection[](https://kiro.dev/docs/cli/chat/git-aware-selection/#to-use-git-aware-file-selection)
|
|
12
|
+
1. Navigate to your Git repository in the terminal.
|
|
13
|
+
2. Run the context add command:
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
/context add
|
|
17
|
+
|
|
18
|
+
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
3. In the fuzzy finder interface, you'll see files from your repository with Git status indicators:
|
|
22
|
+
* `M` – Modified files
|
|
23
|
+
* `A` – Added files
|
|
24
|
+
* `?` – Untracked files
|
|
25
|
+
4. Type to filter files, using Git status as part of your search criteria.
|
|
26
|
+
5. Use the arrow keys to navigate and press Enter to select files to add to your context.
|
|
27
|
+
|
|
28
|
+
|
|
29
|
+
## Tips for Git-aware selection[](https://kiro.dev/docs/cli/chat/git-aware-selection/#tips-for-git-aware-selection)
|
|
30
|
+
* Use Git status indicators in your search to quickly find modified or untracked files
|
|
31
|
+
* The fuzzy finder prioritizes recently modified files in Git history
|
|
32
|
+
* Files ignored by Git (via .gitignore) are still available but deprioritized in the results
|
|
33
|
+
|
|
34
|
+
|
|
35
|
+
Page updated: November 17, 2025
|
|
36
|
+
[Permissions](https://kiro.dev/docs/cli/chat/permissions/)
|
|
37
|
+
[Images](https://kiro.dev/docs/cli/chat/images/)
|
|
38
|
+
On this page
|
|
39
|
+
* [How Git-aware selection works](https://kiro.dev/docs/cli/chat/git-aware-selection/#how-git-aware-selection-works)
|
|
40
|
+
* [Using Git-aware file selection](https://kiro.dev/docs/cli/chat/git-aware-selection/#using-git-aware-file-selection)
|
|
41
|
+
* [Tips for Git-aware selection](https://kiro.dev/docs/cli/chat/git-aware-selection/#tips-for-git-aware-selection)
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
# Working with images
|
|
2
|
+
Kiro can analyze and discuss images directly in your chat session. You can share images with Kiro by dragging and dropping them into your terminal window or by using the `read` tool with the Image mode.
|
|
3
|
+
## Drag and drop images[](https://kiro.dev/docs/cli/chat/images/#drag-and-drop-images)
|
|
4
|
+
The simplest way to share images with Kiro is to drag and drop them directly into your terminal window. When you drag an image into the terminal:
|
|
5
|
+
1. The image path is automatically inserted into your prompt
|
|
6
|
+
2. You can then add text to provide context about what you want Kiro to do with the image
|
|
7
|
+
3. Kiro will process the image and respond based on its content
|
|
8
|
+
|
|
9
|
+
|
|
10
|
+
Example:
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
Kiro> /path/to/architecture-diagram.png Can you explain this architecture and generate sample code for implementing it?
|
|
14
|
+
|
|
15
|
+
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
## Using fs_read with images[](https://kiro.dev/docs/cli/chat/images/#using-fs_read-with-images)
|
|
19
|
+
You can also explicitly use the `read` tool to share images:
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
Kiro> Can you analyze this screenshot at /path/to/screenshot.png?
|
|
23
|
+
|
|
24
|
+
|
|
25
|
+
```
|
|
26
|
+
|
|
27
|
+
Kiro will automatically suggest using fs_read with Image mode when you mention image files.
|
|
28
|
+
## Image use cases[](https://kiro.dev/docs/cli/chat/images/#image-use-cases)
|
|
29
|
+
Common use cases for sharing images with Kiro include:
|
|
30
|
+
* Analyzing screenshots of error messages for troubleshooting
|
|
31
|
+
* Converting architecture diagrams into code implementations
|
|
32
|
+
* Discussing UI/UX designs and generating corresponding HTML/CSS
|
|
33
|
+
* Understanding flowcharts and translating them into algorithms
|
|
34
|
+
* Reviewing code snippets shared as images
|
|
35
|
+
* Interpreting technical diagrams for documentation
|
|
36
|
+
|
|
37
|
+
|
|
38
|
+
## Supported formats and limitations[](https://kiro.dev/docs/cli/chat/images/#supported-formats-and-limitations)
|
|
39
|
+
Supported image formats include JPEG/JPG, PNG, GIF, and WebP. Images must be under 10MB in size, and you can share up to 10 images in a single request.
|
|
40
|
+
For best results:
|
|
41
|
+
* Use high-resolution images with clear text
|
|
42
|
+
* Provide specific instructions about what you want Kiro to do with the image
|
|
43
|
+
* For complex diagrams, consider providing additional context
|
|
44
|
+
|
|
45
|
+
|
|
46
|
+
Page updated: November 25, 2025
|
|
47
|
+
[Working with Git](https://kiro.dev/docs/cli/chat/git-aware-selection/)
|
|
48
|
+
[Security considerations](https://kiro.dev/docs/cli/chat/security/)
|
|
49
|
+
On this page
|
|
50
|
+
* [Drag and drop images](https://kiro.dev/docs/cli/chat/images/#drag-and-drop-images)
|
|
51
|
+
* [Using fs_read with images](https://kiro.dev/docs/cli/chat/images/#using-fs_read-with-images)
|
|
52
|
+
* [Image use cases](https://kiro.dev/docs/cli/chat/images/#image-use-cases)
|
|
53
|
+
* [Supported formats and limitations](https://kiro.dev/docs/cli/chat/images/#supported-formats-and-limitations)
|
|
@@ -0,0 +1,216 @@
|
|
|
1
|
+
# Manage prompts
|
|
2
|
+
The Kiro CLI provides comprehensive prompt management capabilities for both local prompts and Model Context Protocol (MCP) prompts. This system allows you to create, edit, organize, and use reusable prompts across your development workflow.
|
|
3
|
+
## About prompt types[](https://kiro.dev/docs/cli/chat/manage-prompts/#about-prompt-types)
|
|
4
|
+
The prompt system supports three types of prompts:
|
|
5
|
+
* **Local prompts** : Project-specific prompts stored in your workspace
|
|
6
|
+
* **Global prompts** : User-wide prompts available across all projects
|
|
7
|
+
* **MCP prompts** : Prompts provided by MCP servers with enhanced functionality
|
|
8
|
+
|
|
9
|
+
|
|
10
|
+
## Commands[](https://kiro.dev/docs/cli/chat/manage-prompts/#commands)
|
|
11
|
+
All prompt management is accessed through the `/prompts` command with various subcommands.
|
|
12
|
+
### List prompts[](https://kiro.dev/docs/cli/chat/manage-prompts/#list-prompts)
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
/prompts list
|
|
16
|
+
|
|
17
|
+
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
Displays all available prompts in a three-column layout showing names, descriptions, and sources. Shows prompt counts and indicates which prompts come from local storage, global storage, or MCP servers.
|
|
21
|
+
### Create prompts[](https://kiro.dev/docs/cli/chat/manage-prompts/#create-prompts)
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
/prompts create --name name [--content content]
|
|
25
|
+
|
|
26
|
+
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
Creates a new local prompt in the current workspace.
|
|
30
|
+
###### Parameters[](https://kiro.dev/docs/cli/chat/manage-prompts/#parameters)
|
|
31
|
+
`name` (required) : Prompt name (maximum 50 characters)
|
|
32
|
+
`--content content` (optional) : Direct content specification
|
|
33
|
+
**Behavior:**
|
|
34
|
+
* If `--content` is provided, creates prompt with specified content
|
|
35
|
+
* If no content provided, opens your default editor for content creation
|
|
36
|
+
* Prompts are saved to `.kiro/prompts/` in the current workspace
|
|
37
|
+
|
|
38
|
+
|
|
39
|
+
### Edit prompts[](https://kiro.dev/docs/cli/chat/manage-prompts/#edit-prompts)
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
/prompts edit name
|
|
43
|
+
|
|
44
|
+
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
Opens an existing prompt in your default editor for modification.
|
|
48
|
+
**Supported prompts:**
|
|
49
|
+
* Local workspace prompts
|
|
50
|
+
* Global user prompts
|
|
51
|
+
* MCP prompts (where supported by the server)
|
|
52
|
+
|
|
53
|
+
|
|
54
|
+
### View prompt details[](https://kiro.dev/docs/cli/chat/manage-prompts/#view-prompt-details)
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
/prompts details name
|
|
58
|
+
|
|
59
|
+
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
Shows comprehensive information about a prompt including:
|
|
63
|
+
* Metadata and argument details
|
|
64
|
+
* Complete prompt content before AI processing
|
|
65
|
+
* Parameter requirements and examples
|
|
66
|
+
* Source information (local, global, or MCP server)
|
|
67
|
+
|
|
68
|
+
|
|
69
|
+
## Using prompts[](https://kiro.dev/docs/cli/chat/manage-prompts/#using-prompts)
|
|
70
|
+
Once you've created prompts, invoke them in chat using the @ prefix:
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
@prompt-name
|
|
74
|
+
|
|
75
|
+
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
### Examples[](https://kiro.dev/docs/cli/chat/manage-prompts/#examples)
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
@code-review
|
|
82
|
+
# Uses your local code-review prompt
|
|
83
|
+
|
|
84
|
+
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
@team-standup
|
|
90
|
+
# Uses your team-standup prompt
|
|
91
|
+
|
|
92
|
+
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
## Passing arguments to MCP prompts[](https://kiro.dev/docs/cli/chat/manage-prompts/#passing-arguments-to-mcp-prompts)
|
|
96
|
+
MCP server prompts can accept arguments to customize their behavior. File-based prompts (local and global) do not support arguments.
|
|
97
|
+
### MCP prompt argument syntax[](https://kiro.dev/docs/cli/chat/manage-prompts/#mcp-prompt-argument-syntax)
|
|
98
|
+
```
|
|
99
|
+
|
|
100
|
+
@server-name/prompt-name <required-arg> [optional-arg]
|
|
101
|
+
|
|
102
|
+
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
Use `/prompts details prompt-name` to discover what arguments an MCP prompt accepts.
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
# Example: Using MCP prompt with arguments
|
|
109
|
+
@dev-tools/analyze "performance issue" "detailed"
|
|
110
|
+
@security-tools/scan "web-app" "high-severity"
|
|
111
|
+
|
|
112
|
+
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
## Storage locations[](https://kiro.dev/docs/cli/chat/manage-prompts/#storage-locations)
|
|
116
|
+
### Local prompts (workspace-specific)[](https://kiro.dev/docs/cli/chat/manage-prompts/#local-prompts-workspace-specific)
|
|
117
|
+
* **Location** : `project/.kiro/prompts/`
|
|
118
|
+
* **Scope** : Available only within the current project
|
|
119
|
+
* **Priority** : Highest (overrides global and MCP prompts with same name)
|
|
120
|
+
|
|
121
|
+
|
|
122
|
+
### Global prompts (user-wide)[](https://kiro.dev/docs/cli/chat/manage-prompts/#global-prompts-user-wide)
|
|
123
|
+
* **Location** : `~/.kiro/prompts/`
|
|
124
|
+
* **Scope** : Available across all projects
|
|
125
|
+
* **Priority** : Medium (overrides MCP prompts with same name)
|
|
126
|
+
|
|
127
|
+
|
|
128
|
+
### MCP prompts[](https://kiro.dev/docs/cli/chat/manage-prompts/#mcp-prompts)
|
|
129
|
+
* **Source** : Provided by configured MCP servers
|
|
130
|
+
* **Scope** : Depends on server configuration
|
|
131
|
+
* **Priority** : Lowest (overridden by local and global prompts)
|
|
132
|
+
|
|
133
|
+
|
|
134
|
+
## Priority system[](https://kiro.dev/docs/cli/chat/manage-prompts/#priority-system)
|
|
135
|
+
When multiple prompts have the same name, the system uses this priority order:
|
|
136
|
+
1. **Local prompts** (highest priority)
|
|
137
|
+
2. **Global prompts**
|
|
138
|
+
3. **MCP prompts** (lowest priority)
|
|
139
|
+
|
|
140
|
+
|
|
141
|
+
This allows you to override MCP or global prompts with project-specific versions when needed.
|
|
142
|
+
## Enhanced features[](https://kiro.dev/docs/cli/chat/manage-prompts/#enhanced-features)
|
|
143
|
+
### Content preview[](https://kiro.dev/docs/cli/chat/manage-prompts/#content-preview)
|
|
144
|
+
The system displays the complete prompt content before sending it to the AI model, eliminating confusion about what information was actually processed.
|
|
145
|
+
### Improved error handling[](https://kiro.dev/docs/cli/chat/manage-prompts/#improved-error-handling)
|
|
146
|
+
* MCP server errors are converted to user-friendly messages
|
|
147
|
+
* Helpful usage examples are generated from prompt metadata
|
|
148
|
+
* Clear guidance for invalid parameters or missing requirements
|
|
149
|
+
|
|
150
|
+
|
|
151
|
+
### Visual formatting[](https://kiro.dev/docs/cli/chat/manage-prompts/#visual-formatting)
|
|
152
|
+
* Consistent terminal styling across all prompt operations
|
|
153
|
+
* Proper content display for all prompt message types
|
|
154
|
+
* Three-column layout for improved readability in listings
|
|
155
|
+
|
|
156
|
+
|
|
157
|
+
## MCP integration[](https://kiro.dev/docs/cli/chat/manage-prompts/#mcp-integration)
|
|
158
|
+
The prompt system seamlessly integrates with MCP servers:
|
|
159
|
+
* **Automatic discovery** : MCP prompts are automatically discovered from configured servers
|
|
160
|
+
* **Enhanced UX** : Improved user experience for MCP prompt management
|
|
161
|
+
* **Error translation** : Raw JSON errors are converted to actionable messages
|
|
162
|
+
* **Content preview** : Full content preview for MCP prompts before execution
|
|
163
|
+
|
|
164
|
+
|
|
165
|
+
## Examples[](https://kiro.dev/docs/cli/chat/manage-prompts/#examples-1)
|
|
166
|
+
These examples demonstrate file-based prompt creation and MCP prompt usage.
|
|
167
|
+
### Basic file-based prompt creation and usage[](https://kiro.dev/docs/cli/chat/manage-prompts/#basic-file-based-prompt-creation-and-usage)
|
|
168
|
+
```
|
|
169
|
+
|
|
170
|
+
# Create a simple prompt without arguments
|
|
171
|
+
/prompts create --name code-review --content "Please review this code for best practices, security issues, and potential improvements:"
|
|
172
|
+
|
|
173
|
+
# Use the prompt (no arguments supported for file-based prompts)
|
|
174
|
+
@code-review
|
|
175
|
+
|
|
176
|
+
|
|
177
|
+
```
|
|
178
|
+
|
|
179
|
+
### MCP prompt usage with arguments[](https://kiro.dev/docs/cli/chat/manage-prompts/#mcp-prompt-usage-with-arguments)
|
|
180
|
+
```
|
|
181
|
+
|
|
182
|
+
# Using MCP prompts with arguments
|
|
183
|
+
@dev-tools/analyze "performance bottleneck" "cpu usage"
|
|
184
|
+
@security-tools/scan "web-app" "high-severity"
|
|
185
|
+
@aws-tools/deploy "my-service" "production" "us-west-2"
|
|
186
|
+
|
|
187
|
+
|
|
188
|
+
```
|
|
189
|
+
|
|
190
|
+
Page updated: November 16, 2025
|
|
191
|
+
[Planning Agent](https://kiro.dev/docs/cli/chat/planning-agent/)
|
|
192
|
+
[Context management](https://kiro.dev/docs/cli/chat/context/)
|
|
193
|
+
On this page
|
|
194
|
+
* [About prompt types](https://kiro.dev/docs/cli/chat/manage-prompts/#about-prompt-types)
|
|
195
|
+
* [Commands](https://kiro.dev/docs/cli/chat/manage-prompts/#commands)
|
|
196
|
+
* [List prompts](https://kiro.dev/docs/cli/chat/manage-prompts/#list-prompts)
|
|
197
|
+
* [Create prompts](https://kiro.dev/docs/cli/chat/manage-prompts/#create-prompts)
|
|
198
|
+
* [Edit prompts](https://kiro.dev/docs/cli/chat/manage-prompts/#edit-prompts)
|
|
199
|
+
* [View prompt details](https://kiro.dev/docs/cli/chat/manage-prompts/#view-prompt-details)
|
|
200
|
+
* [Using prompts](https://kiro.dev/docs/cli/chat/manage-prompts/#using-prompts)
|
|
201
|
+
* [Examples](https://kiro.dev/docs/cli/chat/manage-prompts/#examples)
|
|
202
|
+
* [Passing arguments to MCP prompts](https://kiro.dev/docs/cli/chat/manage-prompts/#passing-arguments-to-mcp-prompts)
|
|
203
|
+
* [MCP prompt argument syntax](https://kiro.dev/docs/cli/chat/manage-prompts/#mcp-prompt-argument-syntax)
|
|
204
|
+
* [Storage locations](https://kiro.dev/docs/cli/chat/manage-prompts/#storage-locations)
|
|
205
|
+
* [Local prompts (workspace-specific)](https://kiro.dev/docs/cli/chat/manage-prompts/#local-prompts-workspace-specific)
|
|
206
|
+
* [Global prompts (user-wide)](https://kiro.dev/docs/cli/chat/manage-prompts/#global-prompts-user-wide)
|
|
207
|
+
* [MCP prompts](https://kiro.dev/docs/cli/chat/manage-prompts/#mcp-prompts)
|
|
208
|
+
* [Priority system](https://kiro.dev/docs/cli/chat/manage-prompts/#priority-system)
|
|
209
|
+
* [Enhanced features](https://kiro.dev/docs/cli/chat/manage-prompts/#enhanced-features)
|
|
210
|
+
* [Content preview](https://kiro.dev/docs/cli/chat/manage-prompts/#content-preview)
|
|
211
|
+
* [Improved error handling](https://kiro.dev/docs/cli/chat/manage-prompts/#improved-error-handling)
|
|
212
|
+
* [Visual formatting](https://kiro.dev/docs/cli/chat/manage-prompts/#visual-formatting)
|
|
213
|
+
* [MCP integration](https://kiro.dev/docs/cli/chat/manage-prompts/#mcp-integration)
|
|
214
|
+
* [Examples](https://kiro.dev/docs/cli/chat/manage-prompts/#examples-1)
|
|
215
|
+
* [Basic file-based prompt creation and usage](https://kiro.dev/docs/cli/chat/manage-prompts/#basic-file-based-prompt-creation-and-usage)
|
|
216
|
+
* [MCP prompt usage with arguments](https://kiro.dev/docs/cli/chat/manage-prompts/#mcp-prompt-usage-with-arguments)
|