DevLog

CLI + Dashboard for your Claude Code sessions.

DevLog reads your Claude Code conversation history and turns it into structured, searchable work journals — with a web dashboard for visual exploration.

---

Quick Start

# Install globally
npm install -g @moose-lab/devlog
# See your dashboard (CLI)
devlog
# Start the web dashboard
devlog serve
# What did I do today?
devlog today

---

Commands

Command	Description
devlog	Quick terminal dashboard
devlog serve	Start the web dashboard (default port 3333)
devlog today	What did I do today?
devlog sessions	Browse all sessions by project
devlog show <id>	View a full conversation
devlog search <query>	Search sessions
devlog stats	Aggregated usage statistics
devlog cost	Cost, credits, and quota breakdown by project/provider
devlog statusline	Status line for Claude Code integration
devlog setup-statusline	Configure Claude Code status bar
devlog setup-tmux	Configure tmux cost dashboard
devlog init	Set up DevLog (usually auto-detected)

Common flags:--json (JSON output), -q (quiet), --no-color

---

Web Dashboard

Start with devlog serve or bun run dev:

• Dashboard — Overview of all projects and sessions
• Tasks — Kanban board for work items
• Sessions — Launch and monitor Claude Code sessions
• Worktrees — Git worktree management
• Locks — File conflict detection across worktrees
• Reports — Daily, weekly, and monthly work-output reports with HTML export
• Cost & Usage — CLI stats, costs, credits, and quotas in the browser

To get your daily summary, open Analytics -> Reports, select Daily, choose the date, and click Export HTML. The dashboard downloads a standalone report named devlog-daily-report-YYYY-MM-DD.html.

---

Project Structure

DevLog/
├── src/
│ ├── cli/ # CLI (Commander.js + tsup)
│ │ ├── cli.ts # CLI entry point
│ │ ├── commands/ # Command implementations
│ │ └── utils/ # CLI formatting helpers
│ ├── core/ # Shared layer (CLI + Dashboard)
│ │ ├── types.ts # CLI types
│ │ ├── types-dashboard.ts # Dashboard types
│ │ ├── discovery.ts # Claude session discovery
│ │ ├── parser.ts # JSONL parser
│ │ ├── db.ts # SQLite database
│ │ ├── process-manager.ts # Claude process management
│ │ └── ... # Config, cache, pricing, etc.
│ ├── app/ # Next.js app router
│ │ ├── api/ # API routes
│ │ └── */page.tsx # Dashboard pages
│ ├── components/ # React components (shadcn/ui)
│ ├── hooks/ # React hooks
│ └── lib/ # Dashboard-specific utilities
├── tsup.config.ts # CLI build config
├── next.config.ts # Dashboard build config
├── devlog.config.json # Project configuration
└── package.json

---

Tech Stack

• TypeScript — Type-safe throughout
• Commander.js — CLI argument parsing
• tsup — Fast ESM bundling for CLI
• Next.js 16 — Web dashboard framework
• React 19 — UI components
• better-sqlite3 — Local database for dashboard
• shadcn/ui — Component library
• Tailwind CSS 4 — Styling
• chalk — Terminal colors

---

Development

# Install dependencies
bun install
# Build CLI
bun run build:cli
# Build dashboard
bun run build:web
# Build both
bun run build
# Dev mode (dashboard with hot reload)
bun run dev
# Run tests
bun run test# Run the pre-commit quality gate
bun run quality:precommit
# Run the full CI quality gate
bun run quality:ci
# Run CLI locally
bun dist/cli.js --help

bun install installs Husky hooks through the prepare script. The pre-commit hook runs bun run quality:precommit to check staged whitespace, TypeScript, and tests before code is committed. CI runs bun run quality:ci, which adds the production dashboard and CLI builds.

---

License

MIT