A plugin for Claude Code and Codex
Better software from coding agents, with less input from you
Hand off a task and get back a planned, built and reviewed pull request. Or work through requirements and design with the agent before any code. The skills aim to help agents be thoughtful engineers, not just write code.
- > /dream:smith GH42
- ●Opened draft PR #57Add retries to the upload client
- ●Posted the plan4 tasks
- ✓Commit 1/4Extract the request loop
- ✓Commit 2/4Add a backoff policy
- ✓Commit 3/4Retry on 429 and 5xx
- ✓Commit 4/4Cover retries in tests
- ●Coherence review2 accepted
- ●Code review1 accepted, 1 rejected
- ●Precedent reviewno findings
- ✓Ready for review#57
- >
Install¶
/plugin marketplace add alimanfoo/dream
/plugin install dream@dream
codex plugin marketplace add alimanfoo/dream
codex plugin add dream@dream
Call a skill by name, with a leading slash under Claude Code and a $ under
Codex: /dream:smith or $dream:smith.
Most skills work with GitHub issues and pull requests. For those, install gh
2.94.0 or later and sign in.
Hand off a task¶
Give one of these skills a task, and it carries the task to a pull request on its own. The skill opens the pull request as a draft before it touches any code. Follow the session there, and answer anything the skill asks you.
| Skill | What it does |
|---|---|
/dream:smith |
Plans a well-specified task, builds it one commit at a time, reviews it. |
/dream:less |
Builds a small, self-contained change, with no plan and one review. |
Name the task as an argument: an issue such as GH123, or free text. Without an
argument, the skill takes the issue numbers in the branch name.
Run them from labelled issues¶
dreamcatcher runs these skills for you, with no session to watch. Label a GitHub issue, and dreamcatcher starts an agent on it in a worktree of its own, with several agents at a time. You talk to each agent on GitHub. Reply on the pull request, and dreamcatcher passes your reply to the agent. When you merge or close the pull request, dreamcatcher gives the agent a last round to wrap up.
dreamcatcher runs a skill as an assignment or as a conversation. An assignment carries an issue to a pull request. A conversation answers the questions that you post as comments on an issue, and writes no code.
| Skill | Under dreamcatcher |
|---|---|
/dream:smith |
Runs as an assignment, and on its own. |
/dream:less |
Runs as an assignment, and on its own. |
/dream:scout |
Answers your questions on an issue, before any code. Runs only as a conversation. |
dreamcatcher init installs this plugin, and routes a label of each skill's
name to that skill. Follow the
dreamcatcher tutorial for
a first run.
Think it through together¶
These skills work with you on the thinking that comes before code, one question at a time. Each skill ends in a written specification, and offers to put it on a pull request where you can comment on any line.
| Skill | What it does |
|---|---|
/dream:spark |
Interviews you about a rough idea, and writes a requirements brief. |
/dream:trace |
Reads unfamiliar code with you, and writes a reading guide to it. |
/dream:weave |
Works out a design with you, and tests it by asking what breaks. |
/dream:quest |
Breaks a design into a roadmap of pull requests, one issue each. |
Run them in order on a large piece of work, or run the one you need. Each skill takes an issue, a file or free text, so you can point it at what the one before it wrote.
Review a change¶
Each review reads the branch against origin/main, or takes a git range or a
path. Smith runs all of them before it marks a pull request ready, and you can
run any of them yourself.
| Skill | What it looks for |
|---|---|
/dream:coherence-review |
The fix that stopped at the symptom, and the fact with two homes. |
/dream:code-review |
Bugs, through lenses chosen to fit the diff, each finding verified. |
/dream:precedent-review |
What you would catch, learned from your own past review comments. |
Plan and write¶
| Skill | What it does |
|---|---|
/dream:plan |
Turns a focus into a plan for one pull request, a commit per task. |
/dream:coherent-coding |
Loads the coherent coding guide, for the agent to code to. |
/dream:plain-english |
Loads the Plain English guide, for the agent to write to. |
If something goes wrong¶
Start each session in an automatic permissions mode, so that most permissions are handled for you.
claude --permission-mode auto
codex --approve-for-me
Smith and Less print the plugin version as they start. Quote that version when you raise an issue.