Repository navigation
The Effort Project 0.2.0 — Experimental
Pre-releaseThe second experimental release of The Effort Project. Effort now picks the model as well as the effort level, for Claude, Codex and Gemini, so you do not have to choose either. Still MIT licensed, with no npm dependencies, telemetry, or install hooks.
What is new
- Model and effort together. Short mechanical requests go to a fast model at low effort, requests that are both high-stakes and tangled go to a frontier model at high effort, and everything else stays on the daily model. Built-in models: Claude haiku / opus / fable, Codex gpt-6-luna / gpt-6.1-sol / gpt-6-astra, Gemini gemini-4-hydrogen / gemini-4-argon.
--modelpins a model;effort auto --routing-configoverrides the table. - Claude Code plugin that routes by itself. Its prompt hook asks Claude to invoke a routing skill: Haiku at low effort in a fork, Fable at high effort in a fork, or high effort on the session's model. Ordinary prompts are left alone.
- Codex terminal router.
effort auto codexnow starts with a small built-in WebSocket server and needs no extra package. - Gemini.
effort run --provider geminiandeffort auto gemini, through the Antigravity CLI (agy). File permissions last for the session only and shell commands are never allowed. - Benchmark harness with eleven small tasks, offline by default, and a live acceptance script.
- The npm package is now named
effort-project(previously@antyxo/effort-project).
The full list, including fixes, is in the changelog.
Install
Requires Node.js 22+. Download effort-project-0.2.0.tgz below, then run:
npm install --global ./effort-project-0.2.0.tgz
effort doctor
effort recommend "Investigate an intermittent race condition" --provider codexIf you installed 0.1.0 globally, remove it first with npm uninstall --global @antyxo/effort-project. Managed tasks need an installed, signed-in Codex, Claude Code or Antigravity CLI; your existing subscription or API usage still applies. The Claude Code plugin and source installation are described in the README. SHA256SUMS contains the download checksum.
Validation and limits
Checked live on macOS on 2026-11-16 (Node 26.13, Claude Code 2.1.310, codex-cli 0.160.0, agy 1.5.9):
effort runon a typo, a small feature and a race condition chose the expected model and effort and passed its check on Codex and Gemini (3 of 3 each). On Claude, the daily and frontier runs passed, and the Haiku run passed 6 of 6 after a fix made in this release.- The Claude Code plugin, run headless from this repository, routed a typo to Haiku at low effort and a race condition to Fable at high effort, and left an ordinary prompt unchanged.
- The Codex router rewrote a typo prompt from gpt-6.1-sol at max effort to gpt-6-luna at low, and Codex's own session record agreed.
- 55-run benchmark pilots on Codex (
gpt-6.1-sol) and Gemini (gemini-4-argon): every arm passed every task, so the comparison with fixed high effort is inconclusive.
All 367 local tests passed (10 skipped), with the syntax check and the offline package installation check. Continuous integration is switched off for this repository, so there is no CI run for this release.
See the validation record for the full evidence.
This release uses uncalibrated rules. It has not established cost savings or equivalent coding quality. Frontier models cost more, and a run has no spending cap. Claude Code routing depends on Claude following the hook, and a forked skill does not see earlier conversation unless Claude passes it along. Desktop MCP tools still only give advice. Not checked: a prompt typed into the official Codex terminal UI, OpenCode, the plugin installed from GitHub rather than a local folder, and Windows or Linux live runs. 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.