Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
248 changes: 125 additions & 123 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,123 +1,125 @@
# CodeDash

Dashboard + CLI for AI coding agent sessions. View, search, resume, convert, and hand off between 5 agents.

[Russian / Русский](docs/README_RU.md) | [Chinese / 中文](docs/README_ZH.md)

https://github.com/user-attachments/assets/15c45659-365b-49f8-86a3-9005fa155ca6

![npm](https://img.shields.io/npm/v/codedash-app?style=flat-square) ![Node](https://img.shields.io/badge/node-%3E%3D18-green?style=flat-square) ![License](https://img.shields.io/badge/license-MIT-blue?style=flat-square) ![Zero deps](https://img.shields.io/badge/dependencies-0-blue?style=flat-square)

## Quick Start

```bash
npm i -g codedash-app
codedash run
```

## Supported Agents

| Agent | Sessions | Preview | Search | Live Status | Convert | Handoff | Launch |
|-------|----------|---------|--------|-------------|---------|---------|--------|
| Claude Code | JSONL | Yes | Yes | Yes | Yes | Yes | Terminal / cmux |
| Codex CLI | JSONL | Yes | Yes | Yes | Yes | Yes | Terminal |
| Cursor | JSONL | Yes | Yes | Yes | - | Yes | Open in Cursor |
| OpenCode | SQLite | Yes | Yes | Yes | - | Yes | Terminal |
| Kiro CLI | SQLite | Yes | Yes | Yes | - | Yes | Terminal |

Also detects Claude Code running inside Cursor (via `claude-vscode` entrypoint).

## Features

**Browser Dashboard**
- Grid and List view with project grouping
- Trigram fuzzy search + full-text deep search across all messages
- Filter by agent, tags, date range
- Star/pin sessions, tag with labels
- GitHub-style SVG activity heatmap with streak stats
- Session Replay with timeline slider and play/pause
- Hover preview + expandable cards
- Themes: Dark, Light, System

**Live Monitoring**
- LIVE/WAITING badges on all 5 agent types
- Animated border on active session cards
- Running view with CPU, Memory, PID, Uptime
- Focus Terminal / Open in Cursor buttons
- Polling every 5 seconds

**Cost Analytics**
- Real cost from actual token usage (input, output, cache)
- Per-model pricing: Opus, Sonnet, Haiku, Codex, GPT-5
- Daily cost chart, cost by project, most expensive sessions

**Cross-Agent**
- Convert sessions between Claude Code and Codex
- Handoff: generate context document to continue in any agent
- Install Agents: one-click install commands for all 5 agents

**CLI**
```bash
codedash run [--port=N] [--no-browser]
codedash search <query>
codedash show <session-id>
codedash handoff <id> [target] [--verbosity=full] [--out=file.md]
codedash convert <id> claude|codex
codedash list [limit]
codedash stats
codedash export [file.tar.gz]
codedash import <file.tar.gz>
codedash update
codedash restart
codedash stop
```

**Keyboard Shortcuts**: `/` search, `j/k` navigate, `Enter` open, `x` star, `d` delete, `s` select, `g` group, `r` refresh, `Esc` close

## Data Sources

```
~/.claude/ Claude Code sessions + PID tracking
~/.codex/ Codex CLI sessions
~/.cursor/projects/*/agent-transcripts/ Cursor agent sessions
~/.local/share/opencode/opencode.db OpenCode (SQLite)
~/Library/Application Support/kiro-cli/ Kiro CLI (SQLite)
```

Zero dependencies. Everything runs on `localhost`.

## Install Agents

```bash
curl -fsSL https://claude.ai/install.sh | bash # Claude Code
npm i -g @openai/codex # Codex CLI
curl -fsSL https://cli.kiro.dev/install | bash # Kiro CLI
curl -fsSL https://opencode.ai/install | bash # OpenCode
```

## Requirements

- Node.js >= 18
- At least one AI coding agent installed
- macOS / Linux / Windows

## Contributing

`main` is protected. All changes go through feature branches and pull requests.

```bash
git checkout -b fix/my-fix
# make changes
git push -u origin fix/my-fix
gh pr create
```

- **Branch naming:** `feat/`, `fix/`, `chore/`, `release/`
- **1 approval** required to merge
- Keep PRs small and focused

See [ARCHITECTURE.md](docs/ARCHITECTURE.md) for codebase details.

## License

MIT
# CodeDash

Dashboard + CLI for AI coding agent sessions. View, search, resume, convert, and hand off between 6 agents.

[Russian / Русский](docs/README_RU.md) | [Chinese / 中文](docs/README_ZH.md)

https://github.com/user-attachments/assets/15c45659-365b-49f8-86a3-9005fa155ca6

![npm](https://img.shields.io/npm/v/codedash-app?style=flat-square) ![Node](https://img.shields.io/badge/node-%3E%3D18-green?style=flat-square) ![License](https://img.shields.io/badge/license-MIT-blue?style=flat-square) ![Zero deps](https://img.shields.io/badge/dependencies-0-blue?style=flat-square)

## Quick Start

```bash
npm i -g codedash-app
codedash run
```

## Supported Agents

| Agent | Sessions | Preview | Search | Live Status | Convert | Handoff | Launch |
|-------|----------|---------|--------|-------------|---------|---------|--------|
| Claude Code | JSONL | Yes | Yes | Yes | Yes | Yes | Terminal / cmux |
| Codex CLI | JSONL | Yes | Yes | Yes | Yes | Yes | Terminal |
| Cursor | JSONL | Yes | Yes | Yes | - | Yes | Open in Cursor |
| GitHub Copilot (VS Code) | JSONL | Yes | Yes | No | - | Yes | Open in VS Code |
| OpenCode | SQLite | Yes | Yes | Yes | - | Yes | Terminal |
| Kiro CLI | SQLite | Yes | Yes | Yes | - | Yes | Terminal |

Also detects Claude Code running inside Cursor (via `claude-vscode` entrypoint).

## Features

**Browser Dashboard**
- Grid and List view with project grouping
- Trigram fuzzy search + full-text deep search across all messages
- Filter by agent, tags, date range
- Star/pin sessions, tag with labels
- GitHub-style SVG activity heatmap with streak stats
- Session Replay with timeline slider and play/pause
- Hover preview + expandable cards
- Themes: Dark, Light, System

**Live Monitoring**
- LIVE/WAITING badges on local terminal/IDE agent processes
- Animated border on active session cards
- Running view with CPU, Memory, PID, Uptime
- Focus Terminal / Open in Cursor / Open in VS Code buttons
- Polling every 5 seconds

**Cost Analytics**
- Real cost from actual token usage (input, output, cache)
- Per-model pricing: Opus, Sonnet, Haiku, Codex, GPT-5
- Daily cost chart, cost by project, most expensive sessions

**Cross-Agent**
- Convert sessions between Claude Code and Codex
- Handoff: generate context document to continue in any agent
- Install Agents: one-click install commands for Claude, Codex, Kiro, OpenCode

**CLI**
```bash
codedash run [--port=N] [--no-browser]
codedash search <query>
codedash show <session-id>
codedash handoff <id> [target] [--verbosity=full] [--out=file.md]
codedash convert <id> claude|codex
codedash list [limit]
codedash stats
codedash export [file.tar.gz]
codedash import <file.tar.gz>
codedash update
codedash restart
codedash stop
```

**Keyboard Shortcuts**: `/` search, `j/k` navigate, `Enter` open, `x` star, `d` delete, `s` select, `g` group, `r` refresh, `Esc` close

## Data Sources

```
~/.claude/ Claude Code sessions + PID tracking
~/.codex/ Codex CLI sessions
~/.cursor/projects/*/agent-transcripts/ Cursor agent sessions
%APPDATA%/Code/User/workspaceStorage/*/chatSessions/ GitHub Copilot chat sessions
~/.local/share/opencode/opencode.db OpenCode (SQLite)
~/Library/Application Support/kiro-cli/ Kiro CLI (SQLite)
```

Zero dependencies. Everything runs on `localhost`.

## Install Agents

```bash
curl -fsSL https://claude.ai/install.sh | bash # Claude Code
npm i -g @openai/codex # Codex CLI
curl -fsSL https://cli.kiro.dev/install | bash # Kiro CLI
curl -fsSL https://opencode.ai/install | bash # OpenCode
```

## Requirements

- Node.js >= 18
- At least one AI coding agent installed
- macOS / Linux / Windows

## Contributing

`main` is protected. All changes go through feature branches and pull requests.

```bash
git checkout -b fix/my-fix
# make changes
git push -u origin fix/my-fix
gh pr create
```

- **Branch naming:** `feat/`, `fix/`, `chore/`, `release/`
- **1 approval** required to merge
- Keep PRs small and focused

See [ARCHITECTURE.md](docs/ARCHITECTURE.md) for codebase details.

## License

MIT
Loading