Ironhide

A native desktop application for analyzing Claude Code sessions with deep insights, metrics, and recommendations.

Features

Performance

• Sub-second cold start: Dashboard loads instantly via SQL aggregate queries -- no JSONL parsing on startup
• Non-blocking startup: Session scan runs in a background thread; the window appears immediately
• Parallel preload: 8-permit semaphore for concurrent session cache population
• Two-phase preload: Phase 1 loads the 500 most recent sessions for an instant dashboard; Phase 2 backfills all remaining sessions in the background

Dashboard

• Session Overview: View all your Claude Code sessions at a glance
• Key Metrics: Track token usage, costs, conversation patterns, and tool interactions
• Time-based Analysis: Filter sessions by date range (7d/30d/90d/All) and see trends over time
• Efficiency Gauge: Global Cache Efficiency Ratio (CER) weighted by actual cache usage, with educational description

Session & User Analytics

• User vs Subagent Sessions: Separate tracking and charting for user-initiated and subagent sessions
• Dual-axis Trends: Sessions Per Day chart with user session bars (left axis) and subagent session line (right axis)
• Consistent Numbers: Dashboard and Timeline summary cards use the same backend aggregates
• Sticky Headers: All pages feature a sticky header for easy navigation

Session Analysis

• Conversation Timeline: Visualize the flow of your coding sessions
• Tool Usage Breakdown: See which tools Claude used most frequently
• Token Analytics: Understand input/output token distribution
• Cost Tracking: Monitor API usage costs per session

Deep Insights

• Behavior Patterns: Identify common interaction patterns
• Performance Metrics: Track response times and session efficiency
• Recommendation Engine: Get actionable suggestions to improve your workflow

CI/CD

• Automated CI pipeline: Lint, typecheck, Rust tests, and frontend build jobs on every push
• Release workflow: Automated cross-platform builds with test gates

Data Export

• Export session data to CSV for further analysis
• Generate reports for team sharing

Installation

Pre-built Binaries

Download the latest release for your platform:

Platform	Download
macOS (Apple Silicon)	Ironhide_*.dmg (arm64)
macOS (Intel)	Ironhide_*.dmg (x64)
Windows	Ironhide_*-setup.exe
Linux (AppImage)	Ironhide_*.AppImage
Linux (Debian)	Ironhide_*.deb
Linux (Fedora)	Ironhide_*.rpm

macOS Users: After installing, macOS Gatekeeper may block the app since it's not code-signed. To fix:

1. Easiest: Right-click the app → Open → click Open in the dialog
2. Or via terminal: xattr -cr /Applications/Ironhide.app

You only need to do this once.

Build from Source

Prerequisites

• Bun (v1.0 or later)
• Rust (stable)
• Platform-specific dependencies:
  • macOS: Xcode Command Line Tools
  • Windows: Visual Studio Build Tools, WebView2
  • Linux: libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev patchelf

Steps

# Clone the repository
git clone https://github.com/barkain/ironhide.git
cd ironhide

# Install dependencies
bun install

# Run in development mode
bun run tauri:dev

# Build for production
bun run tauri:build

The built application will be in src-tauri/target/release/bundle/.

Usage

1. Launch the app - The dashboard will automatically detect your Claude Code sessions
2. Select a session - Click on any session to view detailed analytics
3. Explore insights - Navigate through different views using the sidebar
4. Export data - Use the export feature to save data for external analysis

Configuration

The app automatically reads Claude Code session data from:

• macOS: ~/.claude/projects/
• Linux: ~/.claude/projects/
• Windows: %USERPROFILE%\.claude\projects\

Screenshots

Screenshots coming soon

Development

Project Structure

ironhide/
├── src/                    # React frontend
│   ├── components/         # UI components
│   ├── pages/             # Page components
│   ├── hooks/             # Custom React hooks
│   ├── stores/            # Zustand state stores
│   └── lib/               # Utility functions
├── src-tauri/             # Rust backend
│   ├── src/
│   │   ├── commands/      # Tauri commands
│   │   ├── analysis/      # Analytics engine
│   │   └── lib.rs         # Main library
│   └── tauri.conf.json    # Tauri configuration
├── docs/                   # Documentation
└── package.json

Tech Stack

• Frontend: React 19, TypeScript, Tailwind CSS, Recharts
• Backend: Rust, Tauri 2
• State Management: Zustand, TanStack Query
• Build: Vite, Bun

Available Scripts

# Development
bun run dev           # Start Vite dev server
bun run tauri:dev     # Start Tauri in dev mode

# Building
bun run build         # Build frontend only
bun run tauri:build   # Build complete app
bun run tauri:build:debug  # Build with debug symbols

# Testing & Quality
bun run typecheck     # TypeScript type checking
bun run test:e2e      # Run Playwright E2E tests
bun run test:rust     # Run Rust backend tests

# Other
bun run preview       # Preview built frontend

Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Auto-Update

The app includes auto-update functionality. When a new version is available, you'll be prompted to update.

To enable auto-updates for your own builds:

1. Generate a key pair:

   bun tauri signer generate -w ~/.tauri/ironhide.key

2. Set the public key in tauri.conf.json under plugins.updater.pubkey

3. Add secrets to your GitHub repository:

   • TAURI_SIGNING_PRIVATE_KEY: Contents of the private key file
   • TAURI_SIGNING_PRIVATE_KEY_PASSWORD: Password for the private key

License

MIT License - see LICENSE for details.

Acknowledgments

• Built with Tauri
• UI components inspired by shadcn/ui
• Charts powered by Recharts