🗂️ Kiro History

Browse your Kiro conversations in a beautiful web UI — supports both Kiro CLI and Kiro IDE.

npx kiro-history

✨ Features

• 🔍 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
• 💰 Credit Cost & Model — Per-turn credit cost and model name displayed on each assistant response, with a session-level summary bar
• 🔧 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-id command 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

🚀 Quick Start

# Run directly with npx (no install needed)
npx kiro-history

That's it! The tool will auto-detect your Kiro data and open a browser window.

📦 Installation

# Install globally for repeated use
npm install -g kiro-history

# Then run anytime
kiro-history

🎯 Usage

Basic Usage

# Auto-detect and open browser
kiro-history

# Use a specific port
kiro-history -p 3000

# Don't open browser automatically
kiro-history --no-open

Source Selection

# 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

Custom Paths

# 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

📋 Options

| 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 | - |

🔧 How It Works

Kiro CLI saves conversations to a local SQLite database (and newer flat-file sessions). Kiro IDE stores them as JSON files — both the original pre-v1.0 format and the current v1.0 JSONL format. This tool reads from all sources and displays your chat history in a clean, browsable format.

Default Paths

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

Source Detection

When using --source auto (the default):

1. Checks for both CLI and IDE data sources
2. If both exist, defaults to CLI
3. If only one exists, uses that source
4. Shows a switch button in the UI when both sources are available

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

MIT © Ajaykumar Prathap

🔗 Links

• GitHub Repository
• npm Package
• Report Issues