Upgrading
Upgrading takes two commands. mcptask_runner update --self replaces the binary; then a bare mcptask_runner update in every project on the host, because the bundled .claude/ assets changed (skills/memory-search/SKILL.md). Run it while no runner is working that checkout. A runner idling in a wait keeps the old binary until its next task or a restart (launchctl kill SIGTERM, wait for the job to stop, then kickstart on macOS), so restart it.
The wrapper gem mcptask-rails-runner 0.3.53 carries this binary; no wrapper changes.
Start now on a runner waiting for the queue (#15160)
While the runner waits for its next look at the queue (an empty queue, or one
holding only set-aside tasks), the snapshot now carries recheck together with
a new member, recheck_kind: "queue". The card (mcptask.online
#15159, already deployed) draws
"Start now" for it. A click ends the wait and the runner asks the queue at once.
If the queue still has nothing, the card says "Asked the queue at HH:MM on Start
now — nothing to take" with the time of the next look. The click lifts no pause,
resets no back-off and starts no model run that the next look would not have
started. A usage limit whose reset time the CLI stated no longer offers the
re-check button: a re-check before the reset only meets the limit again.
schema_version is unchanged. No action needed.
Optional models.last_resort level (#14990)
The tier table can now carry a fourth, optional level, last_resort. The claude
profile declares claude-fable-5-2; codex and opencode declare none. Nothing
uses it yet. A host models: section that does not name it has no such level.
No action needed.
init and update start git less often (#15157)
The install read HEAD and the current branch with their own git calls, after
git status had already said both. It now takes them from the status headers
(--porcelain=v2 --branch). On Windows, where every git start costs about
40 ms, a run of the package's tests starts about 430 fewer processes (3,224 to
2,796). Nothing to do; behaviour is the same.
memory-search skill: note IDs and ratings (#15148)
The bundled memory-search skill now searches through
mcp__llmmn-production__SearchNotesTool instead of curl, prints each note's
ID, rating and date, and rates the notes it used (+1 right, -1 with a reason
when wrong or outdated). It no longer needs LLMMN_TOKEN in the environment.
Hosts get it with mcptask_runner update.
A machine that cannot start processes is one condition and one report
On 2026-11-11 a git hook in another checkout called itself in a loop and filled
one Mac's process table for two hours. Every process the runner tried to start
was refused. The runner read that as four different problems: a CLI that would
not start, a project with no origin remote, a preflight it could carry on past,
and a story sweep that could not list origin. It filed eleven bug pieces, one per
project and per reading. Its re-check passed while nothing could fork, and let a
paid run start (#15150).
- One condition on the card,
host_cannot_fork. It names the machine and how to find what holds the processes. It is raised whichever step met the refusal: the CLI's launch, the auto-squash preflight, or a read of origin. The story sweep files no anomaly over it. - The re-check starts a real process, the runner's own binary, without a shell in front of it. No model run starts until a process does.
- One report per machine. The incident is filed without the task or the
project in its key. Its throttle state lives in
~/.mcptask, so every runner on the machine files one piece between them. The piece carries the process limits, read without starting a process. Once processes start again, a count of this user's processes by command is added to it. - Windows is recognised in its own words. CreateProcess's out-of-memory, system-resources, commit-limit and quota codes count, because a Windows machine never answers with EAGAIN.
Nothing to do on upgrade.
Claude Code 2.1.322's expired login waits on the card, and a refused triage keeps the CLI's words
From 2026-11-12 Claude Code 2.1.322 words an expired login as Failed to. The
authenticate: this login reached its time limit and cannot be renewed
claude profile did not know that sentence. On one Mac every triage was then an
unnamed api_error: the card read "Triage completed but no task_id returned",
three bug pieces were filed and model launches were held, and nothing on the
card said to sign in (#15151).
- The sentence is
harness_login_required. The runner puts the login on the card, waits, re-checks with the login probe and resumes by itself, filing no bug piece and counting no retries. - The remedy names
claude auth login, the command the CLI itself names, run in a regular Terminal on that machine;claude, then/login, is still given for an older CLI. - A refused triage keeps the CLI's own sentence. Any API refusal (a hard cap, a refused account, a retired model, or one nobody has named yet) leaves triage as the engine reported it. The runner no longer replaces it with "no task_id returned", and no second triage in the same round is launched against the same refusal.
- The login probe's warning log shows the end of the CLI's output, where the refusal is, instead of the beginning, where settings warnings hid it.
On upgrade: run mcptask_runner update --self on every host with Claude Code
2.1.322 or later. A host that overrides the claude profile adds
login reached its time limit to its own failures.login_required list.
A permission refusal from mcptask.online for one piece is not the machine's
On 2026-11-12 AddAttachmentTool answered Access denied … authorization_error: true for one piece. The child
handed the step over correctly and also reported host_refused, so the runner filed a bug piece for a machine
that was fine. The prompt now says such a refusal is out of scope with the hand-off, never a host refusal; and
a host_refused whose message carries the literal marker authorization_error: true is set aside as the
task's — no host wait, no bug piece. Nothing else in the message is read. Nothing to do on upgrade.
A task that failed twice on genius gets one last_resort run (#14991)
A task that fails twice in a day in a situation the runner does not handle is
set aside for the rest of the day. When the second failure was on genius, and
the host's model table names models.last_resort, the task now gets one more
run on that model the next time triage picks it. After that run it is set aside,
whatever the run ended in.
- Once per task per day. The grant is kept in the retry ledger, so a restart neither forgets it nor grants a second one.
- Inside the existing caps. A failure that belongs to the machine is not counted toward it. The run counts as one of the three paid attempts after which model launches for the same failure are held.
- No level, no run. On a host whose table does not name
last_resort(codex, opencode, or a hostmodels:section without it) the task is set aside as before, with one log line saying the level is not configured. - Triage still never recommends the level, and a pinned urgent bug is not escalated to it.
Nothing to do on upgrade.
The card says when a run is the last-resort one (#14992)
The snapshot gains an additive escalation member: {level, reason} while a
task runs on the last_resort level, null on every other run and on an older
binary. schema_version is unchanged; the card's model member already
carries the last-resort model id. No action needed on a host.
The card side is mcptask.online task 15221.
The last-resort run is tested end to end (#14993)
Story #14988 is closed by tests rather than by new behaviour:
- A conformance scenario,
40_last_resort_run_after_two_failures_on_genius: a runner that starts with a granted last-resort run in its ledger — what a restart after the second failure on genius reads — launches the task on the profile's last-resort model, keeps the level out of the prompt, and sets the task aside after the run. On codex and opencode the same ledger meets "not configured" and the task runs on genius. Scenarios can now seed that ledger with aretry_ledger:section (Go only; the gem has no ledger). - A host-configuration matrix against the real bundled profiles: the
claude profile with no host
models:escalates to its own id; a hostmodels:with three levels (the local-Ollama shape) never escalates and never launches a model it did not name; a host naming its ownlast_resortgets that id, including throughollama launch's--model; codex and opencode never escalate. - The prompt guard now refuses the level's name and every bundled last-resort model id in any prompt, and the stress day checks that the card shows the escalation exactly when there was one.
Nothing to do on upgrade.
A script run takes away the temp file a killed save of init's answers left (#15342)
init at a terminal saves the answers given so far in
tmp/mcptask_runner/init_state.<user>.json, so an interrupted install can be
continued. A machine that went down in the middle of the very first save left
no state file, only that save's temp file beside it — the same answers under
another name. A later run with nobody at a terminal sets saved answers aside
unread, but it looked only for the state file and so left the temp file where
it was, for good: the directory is ignored by git, so the install's own sweep
of abandoned writes never saw it.
Such a run now removes those temp files too and says so in the install log.
Found by the noon stress sweep (seed 217809009).
Nothing to do on upgrade.
Changelog
Other
- b632d1373790e0cd71776dd59ed95ea0535e20e4 CI: the gem is checked out with a read-only deploy key
- 7a2d0f96ab0f112bbe274b4a4d1c55b889989d3f [#14990] Optional fourth model level last_resort in the profile and host models tables (#28)
- b3aa0b813d05ef837d36be0d315752946a773b3d [#14991] Second failure on genius gets one last_resort run before the task is set aside (#34)
- 0d0d9da50a25abb1b5085a563d20599a7dac3d5c [#14992] Show a last_resort escalation on the runner card (#38)
- c4b9562a31f162d37d1f4edf0db3a68d03baef5d [#14993] Test the last_resort escalation end to end (#39)
- cbe3178c6b5a9e1fc3a88a5024ff7bca220451d0 [#15023] internal/install: one template host per binary, one for-each-ref for the base (#29)
- 2e24a8ca0223d66f429c70bfecb1fb75045f66cc [#15148] memory-search skill returns note IDs and rates used notes (#35)
- 6d10dc4b96301f68cbbfcc875d86cf822232e68b [#15150] A machine that cannot start processes is one host condition, re-checked by a real fork, reported once per machine (#31)
- 89dec8e234271f43f82971e62587a71e51d69f1a [#15151] Claude Code 2.1.322's "login reached its time limit" is login_required; a refused triage keeps the CLI's own sentence (#32)
- a4e4c0b9f751c13ac405d616be314d314d72878b [#15152] An authorization refusal from mcptask.online for one piece is not host_refused: prompt says so, no runner bug is filed (#33)
- 312f2a372cf8ef7db4efe9346255ce931258b705 [#15157] internal/install: read HEAD and branch from the v2 status headers (#36)
- 0beafc18ccf658f81bb578c9a157e7f990fd05c2 [#15160] Start now on the card ends the wait for the next look at the queue (#41)
- 13bb4f9c41c66aa56d4a8ee9d29ebd8d512ff903 [#15161] CI cost: cheap Linux jobs per change, full matrix nightly and before a release (#30)
- 039e4da3d9bb9b33790b78a990824a13008b7e85 [#15162] bin/ci runs the Linux tests with the race detector in Apple's container on a Mac (#42)
- e08d9303fa3aab00d78082f25190129b1698a479 [#15176] internal/install: run the package's tests in parallel (#37)
- a597afc4b6000c236268028d717d8f951a191794 [#15342] A script run removes the temp file a killed save of init's answers left
- 9bff4a16fdf60901a17de13d56e25e25ea381247 [#15772] Install day: a key's foot comment is counted with the key after it
- 5f37756427f6ebe35ba5ac95eab990beba1f169d docs(release): v0.3.52 shipped, the next-tag notes start empty
curl -fsSL https://github.com/jchsoft/mcptask-releases/releases/latest/download/install.sh | sh
Or brew install jchsoft/tap/mcptask_runner, scoop install mcptask_runner,
or npx @mcptask/cli. Verify any manual download against checksums.txt.