kiro-history

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

✨ Features

• 🔍 Search - Find conversations instantly across all your history
• 📝 Markdown Support - Properly 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
• 🎨 Clean UI - Modern, responsive interface with dark theme
• 🚀 Source Switching - Toggle between CLI and IDE conversations when both are available

🚀 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, 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.

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