daydream
Purpose
Daydream reviews tracked changes in a Git repository. It uses review agents for the languages in the change. Daydream checks the evidence for each finding. It can apply fixes and run repository tests.
Daydream records each run in Agent Trajectory Interchange Format (ATIF) 1.7. The archive contains reports, findings, patches, trajectories, and evaluation data. Separate commands can build a corpus or compare review tools.
Functions
- Run a deep or shallow review.
- Write a report without changing source files.
- Post findings to a GitHub pull request (PR).
- Fix findings from another review bot.
- Inspect a repository and write improvement plans.
- Archive and summarize run artifacts.
- Harvest, label, and filter corpus records.
- Run repeatable review benchmarks.
- Install a self-hosted GitHub review bot.
- Load a versioned extension package.
- Run the separate reinforcement-learning tools in the source repository.
Documentation
| Page | Content |
|---|---|
| Getting started | Installation, requirements, and a first review |
| Architecture | Workspace preparation, review stages, fixes, tests, and cleanup |
| CLI reference | Commands, options, defaults, and exit status |
| Configuration | Configuration files, backends, models, phases, and environment variables |
| Repository improvement | Repository audits, local plans, and optional GitHub issues |
| Artifacts and evaluation | Archives, trajectories, evaluation data, summaries, and uploads |
| Self-hosted bot setup | GitHub App setup, workflow files, secrets, and checks |
| Automation and integration | Continuous integration, separate review and post jobs, and feedback fixes |
| Corpus tools | Archive harvest, labels, filters, and corpus files |
| Benchmarking | Review runs, judge routes, harvested data, and reports |
| Reinforcement learning | Sandbox rollouts, task data, rewards, evaluation, and training configuration |
| Extensions | Extension API 6, flows, skills, prompts, stacks, and tool supervision |
| Troubleshooting | Common failures, saved evidence, recovery, and exit status |
Quick start
Install the current Daydream source:
uv tool install git+https://github.com/existential-birds/daydream@main
Go to a Git repository. Run a review that does not apply fixes:
daydream --review --non-interactive .
Use daydream . for an interactive review and fix run. Use
daydream --help-all to see all options.
Read Getting started before the first unattended run.