Skip to content
Open
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
32 changes: 32 additions & 0 deletions .env.example
Original file line number Diff line number Diff line change
Expand Up @@ -82,6 +82,38 @@ STREAMING_BLOCK_SIZE=50
# Minimum interval between updates in milliseconds (default: 200)
STREAMING_UPDATE_INTERVAL_MS=200

# =============================================================================
# Run Reporting Configuration
# =============================================================================

# Enable HTML run reports (default: true)
RUN_REPORTS_ENABLED=true

# Automatically send a report after each run (default: true)
RUN_REPORTS_AUTOSEND=true

# Only auto-send reports for Babysitter runs (/babysitter:call, /babysit) (default: true)
RUN_REPORTS_BABYSITTER_ONLY=true

# Maximum output characters captured per run (default: 12000)
RUN_REPORTS_MAX_OUTPUT_CHARS=12000

# Maximum events captured per run (default: 200)
RUN_REPORTS_MAX_EVENTS=200

# Maximum tool input characters captured (default: 2000)
RUN_REPORTS_MAX_TOOL_INPUT_CHARS=2000

# Maximum runs kept per session in memory (default: 25)
RUN_REPORTS_MAX_RUNS=25

# Maximum report file size to send (MB, default: 45)
RUN_REPORTS_MAX_FILE_MB=45

# Optional local preview directory for generated HTML reports
# Example: /tmp/claude-run-reports
RUN_REPORTS_PREVIEW_DIR=

# =============================================================================
# Threaded Mode Configuration (Forum Topics)
# =============================================================================
Expand Down
47 changes: 46 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -202,6 +202,20 @@ npm start
| `STREAMING_BLOCK_SIZE` | Characters per block in `block` mode | `50` |
| `STREAMING_UPDATE_INTERVAL_MS` | Minimum interval between updates | `200` |

### Run Reporting

| Variable | Description | Default |
|----------|-------------|--------|
| `RUN_REPORTS_ENABLED` | Enable HTML run reports | `true` |
| `RUN_REPORTS_AUTOSEND` | Auto-send a report after each run | `true` |
| `RUN_REPORTS_BABYSITTER_ONLY` | Auto-send only for Babysitter runs | `true` |
| `RUN_REPORTS_MAX_OUTPUT_CHARS` | Max output captured per run | `12000` |
| `RUN_REPORTS_MAX_EVENTS` | Max events captured per run | `200` |
| `RUN_REPORTS_MAX_TOOL_INPUT_CHARS` | Max tool input captured | `2000` |
| `RUN_REPORTS_MAX_RUNS` | Max runs kept per session | `25` |
| `RUN_REPORTS_MAX_FILE_MB` | Max report file size to send | `45` |
| `RUN_REPORTS_PREVIEW_DIR` | Optional local directory to save report HTML files | - |

### Threaded Mode (Forum Topics)

| Variable | Description | Default |
Expand Down Expand Up @@ -265,8 +279,39 @@ npm start
| `/bookmark [action]` | Save/recall/list prompts | `/bookmark save test "run tests"` |
| `/context` | Show context usage (tokens, percentage) | `/context` |
| `/cost` | Show session cost information | `/cost` |
| `/report [runId]` | Download latest run report | `/report` |
| `/reporthistory <projectPath> [--index N] [--session id] [--all]` | Download report from already completed runs | `/reporthistory /Users/me/project --index 2` |
| `/babysit` | Start Babysitter workflow orchestration | `/babysit` |

### Run Report Commands

Generate HTML dashboards for live and historical runs:

| Command | Purpose |
|---------|---------|
| `/report` | Send report for latest tracked run in current session |
| `/report <runIdPrefix>` | Send report for a specific tracked run ID prefix |
| `/reporthistory <projectPath>` | Send report for latest historical Babysitter run in project |
| `/reporthistory <projectPath> --index N` | Pick older historical run (`1` = latest) |
| `/reporthistory <projectPath> --session <sessionIdPrefix>` | Limit to one Claude session |
| `/reporthistory <projectPath> --all` | Include non-Babysitter runs |

Examples:

```bash
/report
/report 01KHBV
/reporthistory /Users/matrixy/Dev/MaTriXy/oneLine
/reporthistory "/Users/matrixy/Dev/MaTriXy/oneLine" --index 3
/reporthistory /Users/matrixy/Dev/MaTriXy/oneLine --session 51970530
/reporthistory /Users/matrixy/Dev/MaTriXy/oneLine --all
```

Notes:
- Historical runs are read from Claude logs under `~/.claude/projects/...`.
- By default, `/reporthistory` filters to Babysitter runs.
- Temporary report files are deleted after Telegram send. If `RUN_REPORTS_PREVIEW_DIR` is set, a persistent preview copy is also saved there.

### Settings

| Command | Description | Example |
Expand Down Expand Up @@ -637,4 +682,4 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file

---

[![100% Built with Babysitter](https://img.shields.io/badge/100%25%20Built%20with-Babysitter%20%F0%9F%A7%99-blueviolet)](https://a5c.ai) **100% Built using [Babysitter](https://github.com/a5c-ai/babysitter) by [a5c.ai](https://a5c.ai)** - AI-powered development orchestration.
[![100% Built with Babysitter](https://img.shields.io/badge/100%25%20Built%20with-Babysitter%20%F0%9F%A7%99-blueviolet)](https://a5c.ai) **100% Built using [Babysitter](https://github.com/a5c-ai/babysitter) by [a5c.ai](https://a5c.ai)** - AI-powered development orchestration.
2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@
"scripts": {
"build": "tsc",
"start": "node dist/index.js",
"dev": "ts-node --esm src/index.ts",
"dev": "npm run build && node dist/index.js",
"test": "jest",
"test:watch": "jest --watch",
"test:coverage": "jest --coverage",
Expand Down
Loading