Experimental - CLI - Docs - Kiro
https://kiro.dev/docs/cli/experimental/ • 276 KB fetched Open original page
Experimental - CLI - Docs - Kiro
Loading image... Product
* About Kiro
* IDE
* CLI
* Web
* Mobile
* Crew
* Pricing
* Downloads
For
* Enterprise
* Startups
* Students
Community
* Overview
* Ambassadors
* Discord
* Events
* Powers
* Shop
* Showcase
Resources
* Docs
* Blog
* Changelog
* FAQs
* Report a bug
* Suggest an idea
* Billing support
Social
*
*
*
*
*
*
*
English
Site Terms License Responsible AI Policy Legal Privacy Policy Cookie Preferences English
Loading image...
* Apps
* CLI
* Web
* Enterprise
* Pricing
* Docs
* Community
* Resources
SIGN IN DOWNLOADS
Loading image...
Get Started
Installation Authentication Your first project
Models
Overview Available models Reasoning effort
Features
How Kiro works Specs
Steering Hooks
MCP
Permissions Custom agents
Agent Skills Powers
Cloud sessions Compaction Kiroignore Checkpoints and rewind Built-in tools
Configuration scopes
IDE 1.x
What's new in 1.0
Setup & First Run Editor
Chat
Experimental
Troubleshooting 0.x reference
CLI
What's new in 3.0
Setup & First Run Terminal UI
Chat
Voice mode Headless mode ACP Auto complete Experimental
Knowledge management
Tangent mode
TODO lists
Thinking tool
Delegate
2.x reference
Crew
Quick start Installation Running 24/7 Chat
Agent Capabilities
Features
Interfaces
Apps
System & storage Configuration Security Troubleshooting
Web
Setup & First Run Identity Center Connect your repositories
Working with the agent
Autonomous mode Automations Memory Configuration Sync Sandbox
Mobile - Preview
Overview
Commands and Reference
CLI commands Slash commands Built-in tools Exit codes Settings
Billing
Overview Managing your subscription Upgrading your plan Downgrading your plan Cancelling your plan Purchasing add-on credits Managing your payments Managing usage notifications Managing your taxes Contacting billing support Deleting your account Related questions
Enterprise
Concepts Onboarding quickstart Connecting your identity provider
Deployment options Subscribe your team Manage subscriptions Governance
Monitor and track
Settings Managed updates Billing IAM Supported regions
Privacy and Security
Overview Data protection Code references Compliance validation Infrastructure security IAM permissions Firewalls, proxies, and data perimeters VPC endpoints (AWS PrivateLink)
Guides
Overview Language support
Learn by playing
Migration
Migrating from Q Developer Migrating from VSCode Upgrading from Q CLI
* Docs
*
* CLI
*
* Experimental
Copy page View as Markdown
Experimental features
Copy page View as Markdown
Kiro CLI includes experimental features that provide advanced functionality. These features are in active development and can be toggled on/off using the /experiment command.
Warning
These features may change or be removed at any time. The experience might not be perfect. Use at your own discretion in production workflows.
These features are provided to gather feedback and test new capabilities. Please report issues through the kiro issue command.
Managing experiments
Use the /experiment command to toggle experimental features:
bash
/experiment
This shows an interactive menu where you can:
* See current status of each experiment (ON/OFF)
* Toggle experiments by selecting them
* View descriptions of what each experiment does
Available experiments
Knowledge management
Command: /knowledge
Enables persistent context storage and retrieval across chat sessions with semantic search capabilities.
Features:
* Store and search through files, directories, and text content
* Semantic search for better context retrieval
* Persistent knowledge base across sessions
* Agent-specific knowledge isolation
Enable:
bash
kiro-cli settings chat.enableKnowledge true
Learn more about Knowledge Management →
Tangent mode
Command: /tangent or Ctrl+T
Create conversation checkpoints to explore side topics without disrupting your main conversation flow.
Features:
* Create conversation checkpoints
* Explore tangential topics
* Return to main conversation thread
* Preserve conversation context
Enable:
bash
kiro-cli settings chat.enableTangentMode true
Learn more about Tangent Mode →
TODO lists
Tool: todo | Command: /todo
Enables Kiro to create and modify TODO lists automatically, with commands for you to view and manage them.
Features:
* Kiro automatically creates TODO lists when appropriate
* View, manage, and delete TODOs
* Resume existing TODO lists
* Persisted across chat sessions
Enable:
bash
kiro-cli settings chat.enableTodoList true
Learn more about TODO Lists →
Thinking tool
Shows AI reasoning process for complex problems with step-by-step thought processes.
Features:
* Transparent decision-making process
* Step-by-step reasoning display
* Useful for debugging and learning
* Better understanding of conclusions
Enable:
bash
kiro-cli settings chat.enableThinking true
Learn more about Thinking Tool →
Checkpointing
Command: /checkpoint
Enables session-scoped checkpoints for tracking file changes using Git-like commands.
Features:
* Snapshots file changes into shadow git repo
* List, expand, diff, and restore checkpoints
* Conversation history unwinds when restoring
* Auto-enables in git repositories
* Manual initialization for non-git directories
Enable:
bash
kiro-cli settings chat.enableCheckpoint true
Basic Usage:
bash
/checkpoint list # Show checkpoints
/checkpoint expand < tag > # Show detailed checkpoint info
/checkpoint diff < tag 1 > [ tag2 ] # Compare checkpoints
/checkpoint restore [ < tag > ] # Restore to checkpoint
/checkpoint clean # Delete session shadow repo
Learn more about Checkpointing →
Context usage percentage
Shows context window usage as a percentage in the chat prompt with color-coded indicators.
Features:
* Displays percentage in prompt (e.g., "[rust-agent] 6% >")
* Color-coded indicators:
* Green: Less than 50% usage
* Yellow: 50-89% usage
* Red: 90-100% usage
* Helps monitor context consumption
Enable:
bash
kiro-cli settings chat.enableContextUsageIndicator true
Delegate
Launch and manage asynchronous task processes, running Kiro chat sessions with specific agents in parallel.
Features:
* Launch background tasks using natural language
* Run parallel chat sessions with specific agents
* Monitor task progress independently
* Agent approval flow for security
Enable:
bash
kiro-cli settings chat.enableDelegate true
Usage:
Use natural language to ask Kiro to launch a background task:
Can you create a background task to analyze the performance of our API endpoints?
Then check on results:
Check the status of my API analysis task
Show me the results from the background analysis
Learn more about Delegate →
Settings integration
Experiments are stored as settings and persist across sessions:
bash
# View all experimental settings
kiro-cli settings list | grep -i enable
# Enable/disable specific experiments
kiro-cli settings chat.enableKnowledge true
kiro-cli settings chat.enableTangentMode true
kiro-cli settings chat.enableTodoList true
kiro-cli settings chat.enableThinking true
kiro-cli settings chat.enableCheckpoint true
kiro-cli settings chat.enableContextUsageIndicator true
kiro-cli settings chat.enableDelegate true
Fuzzy search support
All experimental commands are available in fuzzy search (Ctrl+S):
* /experiment - Manage experimental features
* /knowledge - Knowledge base commands (when enabled)
* /todo - TODO list commands (when enabled)
* /tangent - Tangent mode toggle (when enabled)
* /checkpoint - Checkpoint commands (when enabled)
Best practices
* Test in safe environments : Try experimental features on non-critical projects first
* Provide feedback : Report issues and suggestions using kiro issue
* Stay updated : Check release notes for changes to experimental features
* Understand limitations : Read individual feature documentation for known issues
* Have backups : Some features modify files (checkpointing, TODO lists)
Troubleshooting
Feature not working
*
Verify feature is enabled:
bash
kiro-cli settings list | grep -i enable
*
Check for error messages in chat
*
Try disabling and re-enabling:
bash
kiro-cli settings chat.enableFeatureName false
kiro-cli settings chat.enableFeatureName true
*
Restart Kiro CLI
Commands not available
Ensure the feature is enabled before using its commands. For example, /knowledge only works when knowledge management is enabled.
Next steps
* Knowledge Management
* Tangent Mode
* TODO Lists
* Settings Configuration
Page updated: August 4, 2026
Auto complete
Knowledge management
Links found on this page
- About Kiro [direct]
- IDE [direct]
- CLI [direct]
- Web [direct]
- Mobile [direct]
- Crew [direct]
- Pricing [direct]
- Downloads [direct]
- Enterprise [direct]
- Startups [direct]
- Students [direct]
- Overview [direct]
- Ambassadors [direct]
- Discord [direct]
- Events [direct]
- Powers [direct]
- Shop [direct]
- Showcase [direct]
- Docs [direct]
- Blog [direct]
- Changelog [direct]
- FAQs [direct]
- Report a bug [direct]
- Suggest an idea [direct]
- Billing support [direct]
- Site Terms [direct]
- License [direct]
- Responsible AI Policy [direct]
- Legal [direct]
- Privacy Policy [direct]
- Cookie Preferences [direct]
- Loading image... [direct]
- SIGN IN [direct]
- Installation [direct]
- Authentication [direct]
- Your first project [direct]
- Overview [direct]
- Available models [direct]
- Reasoning effort [direct]
- How Kiro works [direct]
- Specs [direct]
- Steering [direct]
- Hooks [direct]
- MCP [direct]
- Permissions [direct]
- Custom agents [direct]
- Agent Skills [direct]
- Powers [direct]
- Cloud sessions [direct]
- Compaction [direct]
- Kiroignore [direct]
- Checkpoints and rewind [direct]
- Built-in tools [direct]
- Configuration scopes [direct]
- What's new in 1.0 [direct]
- Setup & First Run [direct]
- Editor [direct]
- Chat [direct]
- Experimental [direct]
- Troubleshooting [direct]
- 0.x reference [direct]
- What's new in 3.0 [direct]
- Setup & First Run [direct]
- Terminal UI [direct]
- Chat [direct]
- Voice mode [direct]
- Headless mode [direct]
- ACP [direct]
- Auto complete [direct]
- Knowledge management [direct]
- Tangent mode [direct]
- TODO lists [direct]
- Thinking tool [direct]
- Delegate [direct]
- 2.x reference [direct]
- Quick start [direct]
- Installation [direct]
- Running 24/7 [direct]
- Chat [direct]
- Agent Capabilities [direct]
|
|