https://github.com/pajaydev/kiro-history
Web app to browse kiro conversation history
https://github.com/pajaydev/kiro-history
history kiro kiro-ai kiro-cli kiro-dev kiro-history
Last synced: about 2 months ago
JSON representation
Web app to browse kiro conversation history
- Host: GitHub
- URL: https://github.com/pajaydev/kiro-history
- Owner: pajaydev
- Created: 2026-02-08T19:58:57.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-04-21T21:34:54.000Z (about 2 months ago)
- Last Synced: 2026-04-21T23:30:26.577Z (about 2 months ago)
- Topics: history, kiro, kiro-ai, kiro-cli, kiro-dev, kiro-history
- Language: TypeScript
- Homepage:
- Size: 105 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# kiro-history
[](https://www.npmjs.com/package/kiro-history)
[](https://www.npmjs.com/package/kiro-history)
[](https://opensource.org/licenses/MIT)
> 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
```bash
# 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
```bash
# Install globally for repeated use
npm install -g kiro-history
# Then run anytime
kiro-history
```
## 🎯 Usage
### Basic Usage
```bash
# 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
```bash
# 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
```bash
# 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 ` | Source type: `cli`, `ide`, or `auto` | `auto` |
| `-p, --port ` | 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](https://github.com/pajaydev)
## 🔗 Links
- [GitHub Repository](https://github.com/pajaydev/kiro-history)
- [npm Package](https://www.npmjs.com/package/kiro-history)
- [Report Issues](https://github.com/pajaydev/kiro-history/issues)