Browse your Kiro conversations in a beautiful web UI — supports both Kiro CLI and Kiro IDE.
npx kiro-history- 🔍 Search — Find conversations instantly across all your history, with highlighted matches and auto-scroll within the selected session
- 📝 Markdown Support — Rendered markdown with syntax-highlighted code blocks and tables
- 🔧 Tool Details — Collapsible tool usage information for each assistant response
- 🔄 Live Updates — Automatically refreshes when new conversations are added
- 🚀 Resume Sessions — Copy a ready-to-run
kiro-cli chat --resume-idcommand for any CLI conversation - 🔀 Source Switching — Segmented toggle to flip between CLI and IDE conversations
- 🖥️ Fullscreen & Collapsible Sidebar — Focus on a single conversation or reclaim screen space
- 🎨 Clean UI — Modern, responsive interface with a dark theme
# Run directly with npx (no install needed)
npx kiro-historyThat's it! The tool will auto-detect your Kiro data and open a browser window.
# Install globally for repeated use
npm install -g kiro-history
# Then run anytime
kiro-history# Auto-detect and open browser
kiro-history
# Use a specific port
kiro-history -p 3000
# Don't open browser automatically
kiro-history --no-open# Explicitly use Kiro IDE conversations
kiro-history --source ide
# Explicitly use Kiro CLI conversations
kiro-history --source cli
# Auto-detect (default - prefers CLI if both exist)
kiro-history --source auto# Use a custom database path (CLI mode)
kiro-history ~/path/to/data.sqlite3
# Use a custom sessions directory (IDE mode)
kiro-history --source ide ~/path/to/kiro.kiroagent| Option | Description | Default |
|---|---|---|
path |
Custom path to database file (CLI) or sessions directory (IDE) | Auto-detected |
-s, --source <type> |
Source type: cli, ide, or auto |
auto |
-p, --port <number> |
Port to run the server on | Random available port |
--no-open |
Don't open browser automatically | Opens browser |
-V, --version |
Show version number | - |
-h, --help |
Show help | - |
Kiro CLI saves conversations to a local SQLite database, while Kiro IDE stores them as JSON files in its global storage directory. This tool reads from either source and displays your chat history in a clean, browsable format.
macOS:
- CLI:
~/Library/Application Support/kiro-cli/data.sqlite3 - IDE:
~/Library/Application Support/Kiro/User/globalStorage/kiro.kiroagent
Linux:
- CLI:
~/.local/share/kiro-cli/data.sqlite3 - IDE:
~/.config/Kiro/User/globalStorage/kiro.kiroagent
Windows:
- CLI:
%USERPROFILE%\.local\share\kiro-cli\data.sqlite3 - IDE:
%APPDATA%\Kiro\User\globalStorage\kiro.kiroagent
When using --source auto (the default):
- Checks for both CLI and IDE data sources
- If both exist, defaults to CLI
- If only one exists, uses that source
- Shows a switch button in the UI when both sources are available
Contributions are welcome! Please feel free to submit a Pull Request.
MIT © Ajaykumar Prathap