hope

A Claude Code and Codex plugin that keeps your judgment and agency while AI does more of the work.

AI can now write a change faster than you can read it. You still answer for the result. Hope brings the choices that need you into view, shows the evidence behind them, and leaves the decision with you. That way you can take on larger work and still understand what you shipped.

Install

# Claude Code
claude plugin marketplace add dkstm95/hope
claude plugin install hope@hope

# Codex
codex plugin marketplace add dkstm95/hope
codex plugin add hope@hope

Hope needs Node.js 22 or newer. Diff reviews of GitHub pull requests also need an authenticated GitHub CLI.

Skills

Start a skill with /hope:<name> in Claude Code or $hope:<name> in Codex. Follow-ups in the same task continue without the command. PR Writing is the one skill that also starts on its own, whenever a PR or MR needs a title and description.

Align

Settle the choices that would change the result before any code is written. Align researches the project, asks the open questions together, each with a recommendation, and traces each answer to the choices it uncovers. You decide or delegate. When the agreement must outlast the conversation, Align keeps it as a record that marks who made each call and links it to evidence. Align Skill · Example record

Diff

Understand a change before you approve it. Diff reviews a GitHub pull request or your local branch, uncommitted edits included, against its base. It produces one offline HTML review that explains behavior before code and links each important claim to the captured lines behind it. The complete diff comes along, grouped by purpose, with the reason for each group beside it. When it helps, Diff adds a small microworld to try the behavior and a quiz to check your understanding. Diff Skill · Example review

Whiplash

“Not quite my tempo.”

Image: Hulu’s official “Not My Tempo” clip from Whiplash (2014).

Review, fix, verify, and repeat until no material issue remains. Whiplash judges the work against the outcome you asked for, follows it beyond the diff, and tests each finding before editing. Ask for review only to get findings without edits. Ask for a sweep to run cleanup only: dead code, duplication, and needless work removed with public behavior unchanged. Whiplash Skill

Design

Describe what the screen should do or what feels wrong, without design jargon. Design studies the real screen, recommends a direction, and makes image or working mockups, with a comparison when a real choice remains. It keeps what you like through each round of feedback. Alongside Align, its mockups become the visual evidence for a decision. Design Skill

Write

Draft, edit, or review text while keeping its meaning and voice. Write leads with the point, cuts filler, keeps one term per concept, and writes each language natively. Its writing standard, adapted from George Orwell’s six rules in Politics and the English Language and from ASD-STE100 Simplified Technical English, also shapes the language of every other Hope skill. Write Skill

Write itself runs only when you start it. To make every Claude Code and Codex reply follow its standard in all your projects, give your agent this prompt:

Add the Hope writing standard to my global agent instructions.
1. Fetch https://raw.githubusercontent.com/dkstm95/hope/main/plugins/hope/skills/write/references/writing-standard.md.
2. For ~/.claude/CLAUDE.md and ~/.codex/AGENTS.md: create the file if it is missing and keep its existing content. Put the standard between the lines <!-- hope-writing-standard:start --> and <!-- hope-writing-standard:end -->, replacing any earlier copy between them.
3. Inside the markers, before the standard, add: "Apply this standard to responses and written work unless the project or the person asks for another style."
4. Run `claude -p` and `codex exec` once each and confirm that both report the standard's headings.

Run the same prompt again to update the copy. Project instructions and explicit requests still take precedence, and some modes skip global instructions, such as Claude Code's --bare.

PR Writing

Explain a change to the people who review it. When you ask for a PR or an authorized task reaches one, PR Writing reads the project’s template and conventions, grounds the text in the actual diff and checks, and hands the wording to Write. Simple changes stay short; risky ones state their trade-offs and limits. PR Writing Skill

License

MIT. Design adapts MIT and Apache-2.0 guidance; its source index records the upstream notices and changes. Fonts are modified OFL builds described in font sources.