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
4 changes: 2 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@

Check whether a new model or project rule fixes the mistakes your coding agent already made.

Uses your Codex or Claude subscription. No API key. No Docker.
Uses your Codex or Claude subscription.

[![CI](https://github.com/alexdevmotion/grudges/actions/workflows/ci.yml/badge.svg)](https://github.com/alexdevmotion/grudges/actions/workflows/ci.yml)
[![Release](https://img.shields.io/github/v/release/alexdevmotion/grudges?include_prereleases&color=e9a745)](https://github.com/alexdevmotion/grudges/releases)
Expand Down Expand Up @@ -42,7 +42,7 @@ uv tool install git+https://github.com/alexdevmotion/grudges@v0.3.0a1
grudges run
```

**No API key, Docker, or Harbor required.** Grudges chooses your installed CLI (Codex if both are present), checks the broken input and reference fix, runs one attempt, and prints a results card. It uses your subscription allowance.
Grudges chooses your installed CLI (Codex if both are present), checks the broken input and reference fix, runs one attempt, and prints a results card. It uses your subscription allowance.

```bash
grudges run --agent claude # choose Claude
Expand Down
Binary file modified docs/assets/demo.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion docs/demo.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
The 18-second animation is an edited walkthrough, not a real-time recording. A [static alternative](assets/demo.png) is available.

- Capture uses the existing synthetic amount-formatting fixture. Its output is real, with the saved ID replaced by `DEMO_ID`; no private project or session appears.
- Replay shows a real native `starter/blur-formatting` run using Codex `gpt-6.1-sol`, low effort, one attempt. Baseline and reference checks passed, then the agent solved the task. No Docker or API-key route was used. Subscription allowance was consumed. Waiting time is condensed and summary text shortened.
- Replay shows a real native `starter/blur-formatting` run using Codex `gpt-6.1-sol`, low effort, one attempt. Baseline and reference checks passed, then the agent solved the task. Subscription allowance was consumed. Waiting time is condensed and summary text shortened.
- Compare shows example commands, not measured evidence that rules improve results. `path/to/task` is a placeholder.

Sanitized inputs: [demo-data.json](assets/demo-data.json). Rebuild with Python, Pillow and DejaVu Sans fonts:
Expand Down
2 changes: 1 addition & 1 deletion docs/usage.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ grudges run path/to/task --agent claude --rules ./CLAUDE.md

`-m MODEL` selects a model your subscription supports; omit it for the CLI default. Repeat `-m` to compare models. `--effort` forwards the CLI effort setting. Runs are sequential. `--runner local-codex` and `--runner local-claude` remain compatible aliases; `--trust-local` is no longer required.

Requirements: Linux, Git, and a recent signed-in official CLI. uv provides the Python runtime. Bundled tasks use only Python's standard library and Bash. No Docker daemon or Harbor installation is needed. Custom tasks may have additional documented host dependencies.
Requirements: Linux, Git, and a recent signed-in official CLI. uv provides the Python runtime. Bundled tasks use only Python's standard library and Bash. Custom tasks may have additional documented host dependencies.

## How local verification works

Expand Down
2 changes: 1 addition & 1 deletion packs/starter-intent/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,7 @@ Each task is an offline Python CLI. Environments and reference solutions are unc

Initial mechanical validation used Harbor `nop` and `oracle`, with five attempts each per kept task and one hand-authored near miss per task. Fresh rewards and exception checks are recorded in [validation/RESULTS.md](validation/RESULTS.md). Later calibration prompted the task-specific corrections recorded in FAIRNESS.md; the validation summary describes the initial mechanical checks. No credentials or subscription sessions are mounted into the containers.

Run locally with your signed-in Codex or Claude CLI; no Docker or API key:
Run locally with your signed-in Codex or Claude CLI:

```sh
grudges run --pack starter-intent
Expand Down
2 changes: 1 addition & 1 deletion packs/starter/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

Eight small, re-authored, headless Python 3.13 tasks. Each is a fresh behavioral analogue of an authorized private session; no original repository code, transcript, customer data or provenance is included. All tasks are labelled **routine**: requirements are explicit; the work is finding and repairing the relevant implementation across a few modules. Human completion times and current-model difficulty are unmeasured. Some seeds are historical bug repairs or user-requested improvements rather than a proven correction of the source agent's own work.

With Codex or Claude signed in, run the pack locally (no Docker or API key):
With Codex or Claude signed in, run the pack locally:

```sh
grudges run --pack starter
Expand Down
2 changes: 1 addition & 1 deletion scripts/render_demo.py
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ def font(size, mono=False, bold=False):
('01 / CAPTURE', 'Don’t lose the failure.', 'A tiny local fixture. A mistake worth keeping.',
['$ grudges save --session demo '+chr(92), ' --note "Keep the amount editable until blur."', '', *DATA['capture'].splitlines()],
'Starting code + failed attempt, pinned locally.'),
('02 / REPLAY', 'Use the plan you already have.', 'One starter task. One attempt. No Docker.',
('02 / REPLAY', 'Use the plan you already have.', 'One starter task. One attempt.',
['$ grudges run -m gpt-6.1-sol --effort low', '',
'Using codex subscription · local verification',
'Checking starter/blur-formatting (as captured)…', '',
Expand Down
Loading