Skip to content

The Effort Project 0.1.0 — Experimental

Pre-release
Pre-release

Choose a tag to compare

@AntyXO AntyXO released this 26 Sep 12:58

The first public experimental release of The Effort Project: a free, local controller for reasoning effort in coding agents. MIT licensed, with no npm dependencies, telemetry, or install hooks.

What is included

  • Codex and Claude Code CLI adapters that request real effort levels and preserve sessions across managed attempts.
  • Transparent low/medium/high recommendations, explicit effort/attempt/time limits, independent verification, and bounded escalation after repeated test failures.
  • A local dashboard for recommendations and run history.
  • Advisory MCP tools for compatible desktop hosts, with generated setup entries.

Install

Requires Node.js 22+. Download antyxo-effort-project-0.1.0.tgz below, then run:

npm install --global ./antyxo-effort-project-0.1.0.tgz
effort doctor
effort recommend "Investigate an intermittent race condition" --provider codex
effort dashboard

Managed tasks also require an installed, signed-in Codex or Claude Code CLI. Existing provider subscriptions/API usage still apply. Source installation instructions are in the README. SHA256SUMS contains the download checksum.

Validation and limits

Live macOS checks completed low/high turns in the same session with both providers. Each provider also repaired a disposable module at low effort; independent positive/negative/zero tests passed and the test files were unchanged. Offline tests cover permission failures, session/model mismatches, recovery, process cancellation, usage accounting, MCP and dashboard access controls. A package smoke check installs the archive offline and exercises its CLI, MCP and dashboard.

All 70 local tests passed. The release CI run passed all six jobs: Linux, macOS, and Windows with Node 22 and 24, including the offline package installation check. POSIX-specific cleanup assertions are explicitly skipped on Windows. The first matrix found a real cancellation race; the release includes its verified fix.

See the validation record for the full evidence and limits.

This release uses uncalibrated rules. It has not established cost savings or equivalent coding quality. Effort changes happen at managed turn boundaries. Desktop MCP tools provide recommendations; they cannot change a host chat's active effort. Live provider compatibility was checked on macOS only. Explicit verification commands run with the user's normal local privileges. Review the README and SECURITY.md before running tasks.

Contributions and reproducible compatibility reports are welcome. Do not post credentials, provider transcripts, or private task prompts in issues.