📊 Kiro Pulse

Track and analyze your Kiro coding sessions with detailed analytics on tokens, costs, and IDE health.

Works with Kiro IDE and Kiro CLI - This extension reads session data from Kiro's shared local storage.

⚠️ Disclaimer

This is an unofficial, community-built extension. Kiro Pulse is not affiliated with, endorsed by, or officially connected to Kiro, Amazon Web Services (AWS), or any of their subsidiaries. All trademarks belong to their respective owners.

Features

📈 Dashboard Analytics

• Token Usage - Track input/output tokens across all sessions
• Daily Trends - Configurable chart (7d, 14d, 30d, 90d, All)
• Input Token Breakdown - System prompts, user messages, file context, tool results
• Output Token Breakdown - Code blocks, shell commands, explanatory text
• Kiro Subscription Estimate - Credit usage estimates for vibe and spec tasks

🏥 Kiro Health Stats

• Crashes - Extension host crashes with process details
• Errors - Categorized errors with full message details
• Updates - Track Kiro IDE updates with changelog links
• Storage Usage - Total size, sessions vs logs breakdown, top workspaces by size

📊 Workspace Comparison

• Token Usage by Workspace - Horizontal bar chart comparing input/output tokens
• Smart Workspace Detection - Extracts actual project names from session context
• Session Counts - See which projects have the most activity

🧭 Steering Documents Viewer

• Global & Workspace Steering - View all steering files from ~/.kiro/steering/ and .kiro/steering/
• Inclusion Mode Badges - Shows Always, File Match, or Manual inclusion type
• Content Preview - Expandable preview of each steering document

🤖 Model Usage

• Track Claude models used (Opus 4.5, Sonnet 4, etc.)
• Session counts and token usage per model

📜 Understanding the System Prompt

• Full breakdown of Kiro's system prompt sections
• Descriptions explaining what each section does
• Token count per section (Identity, Capabilities, Rules, etc.)

🔌 MCP Server Status

• View connected MCP servers from user and workspace configs
• Real-time connection status indicators

🔒 Security Insights Beta

• Pattern-based detection of potential security risks
• Click to navigate to flagged messages

⚠️ Security detection is experimental and may produce false positives.

Installation

Install in Kiro IDE from VSIX

1. Download kiro-pulse-0.1.0.vsix from the releases
2. Open Kiro IDE
3. Press Cmd+Shift+P to open Command Palette
4. Type Extensions: Install from VSIX... and select it
5. Navigate to the downloaded .vsix file and select it
6. Click Reload when prompted

Build and Package from Source

git clone https://github.com/vdanniel/kiro-pulse
cd kiro-pulse
npm install
npm run compile
npx @vscode/vsce package
# This creates kiro-pulse-0.1.0.vsix

Then install the generated .vsix file using the steps above.

Usage

1. Click the Kiro Pulse icon in the activity bar (ghost with pulse)
2. Click 📊 Open Dashboard to view analytics

Or use Command Palette: Kiro Pulse: Show Dashboard

Beta Features

These features are experimental and under active development:

⚠️ All data is based on locally stored session files—no API or billing data is accessed. Estimates can vary ±20-30% from actual usage.

Data Sources

Kiro Pulse reads from:

~/Library/Application Support/Kiro/
├── User/globalStorage/kiro.kiroagent/  # Sessions
└── logs/*/main.log                      # Health stats

~/.kiro/steering/                        # Global steering docs
.kiro/steering/                          # Workspace steering docs
~/.kiro/settings/mcp.json                # User MCP config
.kiro/settings/mcp.json                  # Workspace MCP config

Requirements

• Kiro IDE or CLI - Sessions from both are supported
• macOS - Currently macOS only (Windows/Linux paths differ)

Privacy

All data is read locally. Nothing is sent to external servers.

License

MIT