Changelog¶

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

1.0.0 - 2026-06-14¶

Compare with first commit

Features¶

• --linger flag to enable lingering during install (#102) (544c7d5 by Jacob Taylor). Co-authored-by: cheaphelp[bot] cheaphelp@users.noreply.github.com
• repair a failing quality gate with a fixer before replanning (#101) (9210638 by Jacob Taylor). Co-authored-by: Claude Opus 4.8 noreply@anthropic.com
• include per-issue cost breakdown in opened PR descriptions (#100) (ada7503 by Jacob Taylor). Co-authored-by: cheaphelp[bot] cheaphelp@users.noreply.github.com
• surface service run result in systemd status (#94) (cecc993 by Jacob Taylor). Co-authored-by: cheaphelp[bot] cheaphelp@users.noreply.github.com
• show today's spend vs daily budget footer (#95) (29d8c5d by Jacob Taylor). Co-authored-by: cheaphelp[bot] cheaphelp@users.noreply.github.com
• persist unparseable agent output to last_unparsed_.log (#93) (4ca4aaa by Jacob Taylor). Co-authored-by: cheaphelp[bot] cheaphelp@users.noreply.github.com
• report systemd timer/service health in cheaphelp doctor (#92) (f2958c2 by Jacob Taylor). Co-authored-by: cheaphelp[bot] cheaphelp@users.noreply.github.com
• add daily spend budget guardrail with warn/exceeded comments (#74) (728aaf6 by Jacob Taylor). Co-authored-by: cheaphelp[bot] cheaphelp@users.noreply.github.com
• Label needs-human on comment; route back to responder on human reply (#73) (3f3c493 by Jacob Taylor). Co-authored-by: cheaphelp[bot] cheaphelp@users.noreply.github.com
• Allow cheaphelp run for many ticks (-n / --continuous) (#75) (5b52ed9 by Jacob Taylor). Co-authored-by: cheaphelp[bot] cheaphelp@users.noreply.github.com
• Add cheaphelp retry to un-stick issues labeled needs-human (#72) (c1bead1 by Jacob Taylor). Co-authored-by: cheaphelp[bot] cheaphelp@users.noreply.github.com
• Act on PR review feedback instead of leaving issues stuck in-review (#68) (25f5f3f by Jacob Taylor). Co-authored-by: Claude Opus 4.8 noreply@anthropic.com
• Add cheaphelp config subcommand (show/get/set) with auto-regen (#63) (1d26895 by Jacob Taylor). Co-authored-by: cheaphelp[bot] cheaphelp@users.noreply.github.com, Co-authored-by: Claude Opus 4.8 noreply@anthropic.com
• track token usage and cost per tick, per role, and per issue (#64) (e087550 by Jacob Taylor). Co-authored-by: cheaphelp[bot] cheaphelp@users.noreply.github.com, Co-authored-by: Claude Opus 4.8 noreply@anthropic.com
• retry transient GitHub and OpenRouter failures with backoff (#62) (2daca10 by Jacob Taylor). Co-authored-by: cheaphelp[bot] cheaphelp@users.noreply.github.com
• add cheaphelp logs subcommand for viewing and following run activity (#61) (f3e99a3 by Jacob Taylor). Co-authored-by: cheaphelp[bot] cheaphelp@users.noreply.github.com
• Blast-radius guardrail caps PR diff size (max files/lines) (#60) (6037d91 by Jacob Taylor). Co-authored-by: cheaphelp[bot] cheaphelp@users.noreply.github.com
• Let agents follow a project's own contribution conventions (#59) (7a8e8be by Jacob Taylor). Co-authored-by: cheaphelp[bot] cheaphelp@users.noreply.github.com
• Prune build clones for closed issues; add cheaphelp clean (#45) (302eec9 by Jacob Taylor). Co-authored-by: Claude Opus 4.8 noreply@anthropic.com
• Retry timed-out tasks; re-prompt agents that emit no decision (#44) (17e8ab6 by Jacob Taylor). Co-authored-by: Claude Opus 4.8 noreply@anthropic.com
• Hold issues until their dependencies close (#35 part 2) (#43) (4aeb146 by Jacob Taylor). Co-authored-by: Claude Opus 4.8 noreply@anthropic.com
• Parallel ticks via per-issue locks (#35 part 1) (#42) (0ba4a4e by Jacob Taylor). Co-authored-by: Claude Opus 4.8 noreply@anthropic.com
• Log each agent step as it starts; trim crash logs (#40) (01efe1b by Jacob Taylor). Co-authored-by: Claude Opus 4.8 noreply@anthropic.com
• Cap worker tasks run per issue per tick (max_tasks_per_tick) (#39) (5c7b138 by Jacob Taylor). Co-authored-by: Claude Opus 4.8 noreply@anthropic.com
• Cap issues processed per tick (--max-issues / max… (#38) (a34dbfd by Jacob Taylor). Co-authored-by: Claude Opus 4.8 noreply@anthropic.com
• Add cheaphelp status command (#27) (96e0cb6 by Jacob Taylor). Co-authored-by: cheaphelp[bot] cheaphelp@users.noreply.github.com
• add workspace run-lock to serialise overlapping ticks (#25) (bfc4778 by Jacob Taylor). Co-authored-by: cheaphelp[bot] cheaphelp@users.noreply.github.com, Co-authored-by: Claude Opus 4.8 noreply@anthropic.com
• make opencode agent subprocess timeout configurable (#21) (62a4e7a by Jacob Taylor). Co-authored-by: cheaphelp[bot] cheaphelp@users.noreply.github.com
• add cheaphelp repo set to update checks/autofix in place (#19) (6f66999 by Jacob Taylor). Co-authored-by: cheaphelp[bot] cheaphelp@users.noreply.github.com
• Prefix every GitHub message with a cheaphelp attribution header (#17) (c001847 by Jacob Taylor). Co-authored-by: Claude Opus 4.8 noreply@anthropic.com
• Hand the exact quality-gate commands to the worker (#12) (a5ddec5 by Jacob Taylor). Co-authored-by: Claude Opus 4.8 noreply@anthropic.com

Bug Fixes¶

• stop finalize replies promising a 'spec below' (#99) (942db6e by Jacob Taylor). Co-authored-by: cheaphelp[bot] cheaphelp@users.noreply.github.com
• balance-brace JSON extraction and retry unparseable clean exits (#98) (1232a80 by Jacob Taylor). Co-authored-by: cheaphelp[bot] cheaphelp@users.noreply.github.com
• Drop stale bot_login args from responder test call sites (#69) (e9be0c0 by Jacob Taylor). Co-authored-by: Claude Opus 4.8 noreply@anthropic.com
• Identify bot comments by marker only, not by author login (#67) (e554d7b by Jacob Taylor). Co-authored-by: Claude Opus 4.8 noreply@anthropic.com
• Route push failures to needs-human; require workflow PAT scope (#65) (587b8d5 by Jacob Taylor). Co-authored-by: Claude Opus 4.8 noreply@anthropic.com
• Re-validate issue state under its lock so overlapping ticks don't double-act (#58) (24c279e by Jacob Taylor). Co-authored-by: Claude Opus 4.8 noreply@anthropic.com
• distinguish repo set no-op from real update (#34) (264cd6c by Jacob Taylor). Co-authored-by: cheaphelp[bot] cheaphelp@users.noreply.github.com
• Keep the spec at requirements altitude, ask only material questions (#14) (04a9010 by Jacob Taylor). Co-authored-by: Claude Opus 4.8 noreply@anthropic.com

Code Refactoring¶

• Don't run the full quality gate after every task (#29) (cf0de8e by Jacob Taylor). Co-authored-by: Claude Opus 4.8 noreply@anthropic.com