{"id":51870717,"url":"https://github.com/natelindev/no-mistakes-lite","last_synced_at":"2026-07-24T22:30:24.149Z","repository":{"id":368564947,"uuid":"1284725252","full_name":"natelindev/no-mistakes-lite","owner":"natelindev","description":"Lightweight agent-friendly no-mistakes workflow driver for local review, validation, PR, and CI automation","archived":false,"fork":false,"pushed_at":"2026-07-01T05:56:03.000Z","size":93,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-01T07:24:39.389Z","etag":null,"topics":["agent-workflow","ai-agents","automation","ci","cli","coding-agents","git","github","go","no-mistakes","pull-requests","toon","treehouse"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/natelindev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-06-30T06:23:18.000Z","updated_at":"2026-07-01T05:56:07.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/natelindev/no-mistakes-lite","commit_stats":null,"previous_names":["natelindev/no-mistakes-lite"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/natelindev/no-mistakes-lite","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/natelindev%2Fno-mistakes-lite","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/natelindev%2Fno-mistakes-lite/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/natelindev%2Fno-mistakes-lite/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/natelindev%2Fno-mistakes-lite/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/natelindev","download_url":"https://codeload.github.com/natelindev/no-mistakes-lite/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/natelindev%2Fno-mistakes-lite/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35858781,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-07-20T02:08:10.276Z","status":"online","status_checked_at":"2026-07-24T02:00:07.870Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-workflow","ai-agents","automation","ci","cli","coding-agents","git","github","go","no-mistakes","pull-requests","toon","treehouse"],"created_at":"2026-07-24T22:30:23.657Z","updated_at":"2026-07-24T22:30:24.138Z","avatar_url":"https://github.com/natelindev.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# no-mistakes Lite (`nml`)\n\n`nml` is a lightweight local workflow driver inspired by [no-mistakes](https://github.com/kunchenguid/no-mistakes). It inspects a git repository, records original user intent, prepares committed changes for isolated validation, and is being built toward review, test, lint, PR, CI, optional automerge, and deploy steps.\n\n## Inspiration and key differences\n\n[`no-mistakes`](https://github.com/kunchenguid/no-mistakes) gates changes by putting a local git proxy in front of your real remote: push to the gate, let the AI validation pipeline run in a disposable worktree, then forward only clean work to the configured push target and PR flow.\n\n`nml` explores a smaller command-first take on the same idea:\n\n- **No git proxy remote required** - run `nml run`, `nml status`, `nml respond`, and `nml resume` directly from the repository.\n- **Agent-friendly by default** - headless commands emit compact TOON on stdout, progress on stderr, and avoid prompts unless an explicit interactive command is used.\n- **Lightweight local state** - run state lives under `.git/nml/runs` and is mirrored to `~/.nml/runs` for resume and logs.\n- **Explicit worktree isolation** - Treehouse leases provide isolated validation worktrees, with current worktree reuse when already inside a Treehouse-managed checkout.\n- **Incremental scope** - `nml` focuses on a small binary, simple config, direct GitHub PR/CI automation, and hooks or skills that can be installed separately.\n\nUse `no-mistakes` when you want the full git-push gate workflow. Use `nml` when you want a minimal CLI that agents and scripts can call directly.\n\n## Current commands\n\n```sh\nnml                                  # print compact workspace status in TOON\nnml init --yes --agent \u003cname\u003e         # create ~/.config/nml/config.yaml\nnml init --interactive                # guided setup wizard for humans\nnml doctor                            # check local tools, auth, config, and repo state\nnml run --message \"fix: handle empty input\"\nnml run --test-command \"go test ./...\"\nnml run --skip-review --test-command \"go test ./...\"\nnml status --format toon\nnml status --run \u003cid\u003e --full\nnml findings --format toon\nnml findings --run \u003cid\u003e --full\nnml runs --resumable\nnml resume --run \u003cid\u003e\nnml respond --action fix --run \u003cid\u003e      # fix all latest review findings\nnml respond --action approve\nnml config --format toon\nnml config --interactive\nnml config --scope global --set agent.name=codex\nnml config --scope project --set review.yolo=true --set ci.timeout=15m\nnml config --scope project --set review.auto_approve_after_rounds=true\nnml config --scope global --set auto_merge.enabled=true\nnml config --scope project --set conflict_resolution.mode=rebase\nnml config --scope project --set cleanup.auto=false\nnml hooks install --apps claude,codex,opencode\nnml tui                                 # timeline, or interactive review gate\n```\n\nHeadless commands keep stdout structured and compact. Running `nml` with no arguments is content-first and never prompts. Progress goes to stderr. Exit codes are 0 for success or no-op, 1 for runtime errors, and 2 for usage errors.\n\n## Agent integrations\n\nInstall live session context hooks when you want agents to see `nml` workspace status at startup:\n\n```sh\nnml hooks install --apps claude,codex,opencode\nnml hooks install --scope project --apps claude,codex\n```\n\nThe repository also carries an Agent Skill at `skills/no-mistakes-lite/SKILL.md`. `scripts/install.sh` installs only the `nml` binary and does not install the skill automatically. If you want the skill, install or copy it explicitly. The hook and skill are complementary: use the hook for ambient live state, and the skill for on-demand workflow guidance.\n\n## Implemented first\n\n- Go module and `nml` binary skeleton.\n- Global and per-repo config loading from `~/.config/nml`, including persistent run defaults such as yolo review fixing, auto-approve after review rounds, PR conflict repair mode, auto-merge, auto-cleanup, CI timeout, and validation commands.\n- Git preflight classification and no-op exits.\n- Non-interactive first-run setup with `--yes`, plus an explicit `--interactive` wizard for humans.\n- Doctor command with TOON output.\n- Dirty worktree staging, agent-generated commit metadata, and commit hook fix retries.\n- Agent or fallback intent generation and JSON run state under `.git/nml/runs`, mirrored to `~/.nml/runs` with event and log files for resume.\n- Treehouse worktree leasing with completed-run auto-cleanup that preserves a worktree when the current terminal started inside it, current Treehouse worktree reuse, exact source commit reuse when already based on the current base, and cherry-pick or format-patch fallback.\n- First review loop using configured agents, exact `LGTM`, Markdown finding parsing, review gate output, configured auto-approval after review rounds, `--skip-review`, and `--yes` or `--yolo` automatic fix attempts.\n- Test command execution only when configured per repo or supplied per run, plus lint command execution with skip reasons and agent fix retries.\n- Docs evaluation and optional agent documentation updates.\n- GitHub remote detection, safe push of tool-owned `nml/*` branches, and GitHub PR create/update through `gh` when available.\n- Bounded CI watch with delayed check registration handling, repeated PR merge-conflict detection with configurable merge or rebase repair before or after CI watches, failed-log collection, persisted CI logs, stricter no-checks handling for yolo, skipped-review, or unresolved-finding auto-approved runs, agent CI fix retries, optional per-run auto-merge with GitHub CLI prompts disabled, and optional deploy command retries.\n- Resumable failed or interrupted runs via `nml resume`, review finding parser, secret redaction, PR body generation, Bubble Tea run timeline and interactive review gate response picker, AXI session hook installation for Claude Code, Codex, and OpenCode, installable Agent Skill, binary-only install script, usage docs, and unit tests.\n\nSee `docs/usage.md` for workflow details. Future work is mostly provider expansion.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnatelindev%2Fno-mistakes-lite","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnatelindev%2Fno-mistakes-lite","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnatelindev%2Fno-mistakes-lite/lists"}