this repo has no description
Add project documentation
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
+108
+36
CLAUDE.md
+36
CLAUDE.md
···
1
+
# Worklog Project
2
+
3
+
A tool that summarizes Claude Code sessions into a daily worklog.
4
+
5
+
## Architecture
6
+
7
+
- **CLI** (`src/cli/`): Process sessions, serve web UI
8
+
- **Core** (`src/core/`): Session parsing, DB, LLM summarization
9
+
- **Web** (`src/web/`): React frontend + Express API
10
+
- **DB**: SQLite at `data/worklog.db`
11
+
12
+
Vite dev server (5173) proxies `/api` to backend (3456).
13
+
14
+
## Key Design Decisions
15
+
16
+
### Session Filtering
17
+
18
+
Only sessions with actual code changes (Write/Edit/NotebookEdit/MultiEdit) are included. Exploration-only sessions (just Read/Grep/Glob) are skipped entirely. This is intentional - reading code is not an accomplishment.
19
+
20
+
### Prompting for Outcomes
21
+
22
+
The LLM prompts explicitly say "OUTCOMES only, never exploration" to prevent summaries like "explored codebase" or "reviewed project structure". Focus is on what was BUILT, FIXED, or CHANGED.
23
+
24
+
## Gotchas
25
+
26
+
- Haiku sometimes returns malformed structured output (strings instead of arrays). The code has fallback handling for this.
27
+
- Kill any stale process on port 3456 before running `bun cli serve`
28
+
29
+
## Commands
30
+
31
+
```bash
32
+
bun cli process # Process new sessions
33
+
bun cli process --week this # Process this week only
34
+
bun cli serve # Serve web UI on :3456
35
+
bun dev # Vite dev server on :5173
36
+
```
+72
README.md
+72
README.md
···
1
+
# Worklog
2
+
3
+
Automatically generates a daily worklog from your Claude Code sessions. See what you actually accomplished, not what you looked at.
4
+
5
+
## What it does
6
+
7
+
- Scans Claude Code session files from `~/.claude/projects/`
8
+
- Filters to only sessions where code was actually changed (Write/Edit)
9
+
- Summarizes each session using Claude Haiku
10
+
- Generates daily summaries grouped by project
11
+
- Provides a web UI to browse your work history
12
+
13
+
## Setup
14
+
15
+
```bash
16
+
# Install dependencies
17
+
bun install
18
+
19
+
# Set your API key
20
+
export WORKLOG_API_KEY=sk-ant-...
21
+
22
+
# Process your sessions
23
+
bun cli process
24
+
25
+
# View the web UI
26
+
bun dev
27
+
```
28
+
29
+
Then open http://localhost:5173
30
+
31
+
## Commands
32
+
33
+
```bash
34
+
bun cli process # Process new sessions
35
+
bun cli process --force # Reprocess all sessions
36
+
bun cli process -d today # Process today only
37
+
bun cli process -w thisweek # Process this week only
38
+
bun cli status # Show stats
39
+
bun cli serve # Production server on :3456
40
+
bun cli regenerate # Regenerate daily summaries
41
+
bun cli regenerate --force # Regenerate all daily summaries
42
+
```
43
+
44
+
## Configuration
45
+
46
+
| Environment Variable | Default | Description |
47
+
|---------------------|---------|-------------|
48
+
| `WORKLOG_API_KEY` | - | Anthropic API key (required) |
49
+
| `WORKLOG_BASE_URL` | - | Custom API base URL (optional) |
50
+
| `SUMMARIZER_MODEL` | `claude-haiku-4-5-20251001` | Model for summarization |
51
+
52
+
## How it works
53
+
54
+
**Session filtering**: Only sessions with actual code changes are included. Reading, searching, and exploring don't count as work.
55
+
56
+
**Summarization**: Each session is summarized focusing on outcomes - what was built, fixed, or changed. The daily summary rolls up all sessions by project into brief phrases.
57
+
58
+
**Storage**: Processed data is stored in `data/worklog.db` (SQLite).
59
+
60
+
## Development
61
+
62
+
```bash
63
+
bun dev # Start Vite dev server + API
64
+
bun run build # Build for production
65
+
```
66
+
67
+
## Tech stack
68
+
69
+
- Bun runtime
70
+
- React + Vite + Tailwind
71
+
- SQLite (via bun:sqlite)
72
+
- Anthropic AI SDK