Daedux

Analytics dashboard for Claude Code usage. Track tokens, costs, and sessions across all your projects.

Features

• Token and cost tracking across sessions
• Project-based analytics with breakdowns
• Daily, weekly, and monthly trends
• Model usage breakdown (Opus, Sonnet, Haiku)
• Tool usage statistics
• Multi-harness support (Claude Code, Codex, OpenCode)

Installation

Desktop App (macOS)

Download the DMG from GitHub Releases:

daedux-{version}-darwin-arm64.dmg

1. Open the DMG and drag Daedux to Applications
2. On first launch, allow in System Settings > Privacy & Security
3. Daedux runs in the system tray

Note: Currently macOS ARM64 only. Intel support coming soon.

CLI (via NPM)

# Global install
npm install -g @agentika/daedux
daedux

# Or via npx (no install)
npx @agentika/daedux

# Or with bun
bunx @agentika/daedux

Prerequisites

• CLI: Bun runtime (automatically used if installed)
• Desktop: macOS ARM64 (Apple Silicon)
• Both: Claude Code must have been used (~/.claude/projects/ must exist)

OpenTelemetry Setup

To receive real-time metrics from Claude Code, configure telemetry export. Choose one approach:

Option 1: Shell Environment

Add to ~/.zshrc or ~/.bashrc:

export CLAUDE_CODE_ENABLE_TELEMETRY=1
export OTEL_METRICS_EXPORTER=otlp
export OTEL_LOGS_EXPORTER=otlp
export OTEL_EXPORTER_OTLP_PROTOCOL=http/json
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318

Option 2: Claude Code Settings

Add to ~/.claude/settings.json:

{
  "env": {
    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
    "OTEL_METRICS_EXPORTER": "otlp",
    "OTEL_LOGS_EXPORTER": "otlp",
    "OTEL_EXPORTER_OTLP_PROTOCOL": "http/json",
    "OTEL_EXPORTER_OTLP_ENDPOINT": "http://localhost:4318"
  }
}

After configuring, ensure Daedux is running and the OTEL receiver is enabled in Settings.

CLI Usage

daedux                      # Start on port 3456, auto-open browser
daedux --port 8080          # Custom port
daedux --no-open            # Don't auto-open browser
daedux --resync             # Full re-parse of all session data
daedux --verbose            # Debug logging

# JSON output mode (no server)
daedux --json               # Output JSON to stdout
daedux --json --filter 7d   # Filter: today, 7d, 30d, all

Options

| Option | Alias | Description | Default | | ----------- | ----- | ---------------------------------- | ------- | | --port | -p | Port to run the server on | 3456 | | --json | -j | Output JSON to stdout and exit | false | | --filter | -f | Date filter for --json mode | 7d | | --resync | -r | Full resync (clears and re-parses) | false | | --no-open | -n | Don't open browser automatically | false | | --verbose | -v | Enable verbose logging | false |

Data Storage

Database location by platform:

| Platform | Path | | -------- | ------------------------------------------------ | | macOS | ~/Library/Application Support/Daedux/daedux.db | | Windows | %APPDATA%/Daedux/daedux.db | | Linux | ~/.local/share/daedux/daedux.db |

Tech Stack

Bun runtime, Effect TS + Drizzle ORM backend, React 19 + TanStack frontend, Electrobun desktop shell.

License

MIT

Contributing

See CONTRIBUTING.md for development setup, architecture, and guidelines.

Issues and feature requests: GitHub Issues