claw-diary

# Claw Diary — Personal Agent Visual Diary

An always-on agent activity recorder that auto-tracks every action, generates daily narrative summaries, and supports visual timeline replay. Like a dashcam for your AI assistant.

## Prerequisites

Before running any command, check if `claw-diary` is installed:

```bash
which claw-diary || npm install -g claw-diary
```

If the command is not found, run `npm install -g claw-diary` to install it.

## Slash Commands

### `/diary` — Today's Summary
Generate and display today's agent diary summary. Shows sessions, key activities, token usage, and cost breakdown in a narrative format.

**Implementation:** Run `claw-diary summarize today` and display the markdown output.

### `/diary:replay` — Visual Timeline
Launch an interactive HTML timeline in the browser showing all agent activities with color-coded nodes, token cost visualization, and click-to-expand details.

**Implementation:** Run `claw-diary replay` to start a local server, then open the URL in the browser.

### `/diary:stats` — Cost & Activity Stats
Show cost analysis (daily, weekly, by model, by tool), activity metrics (sessions, tool calls, failure rate), and discovered patterns.

**Implementation:** Run `claw-diary stats` and display the output.

### `/diary:week` — Weekly Report
Generate a weekly summary aggregating all daily diaries with trends, top activities, and cost analysis.

**Implementation:** Run `claw-diary summarize week` and display the markdown output.

### `/diary:search <query>` — Search History
Search across all historical agent activity events.

**Implementation:** Run `claw-diary search` with the user's query as separate arguments (do NOT embed the query inside a quoted string or interpolate into the command). Example: for query "refactor auth", run `claw-diary search refactor auth`. Display matching events.

### `/diary:export` — Export Data
Export diary data in Markdown, HTML, or JSON format.

**Implementation:** Run `claw-diary export [format]...