Repository navigation
0.5.0 - 2026-11-07
Release Notes
Added
--harness opencodeand--harness qwendrive OpenCode and Qwen Code
over ACP, as fx is (--opencode-binand--qwen-binname their
executables). Each runs in aHOMEof its own under.tenaz/private/
with a configuration Tenaz writes for each session's model: the engine
proxy, the model's window, asking before every edit and command, and
the media MCP server; the pinned skills are linked into thatHOME.
Qwen Code's memory and chat recording are off, and the context files
it reads from itsHOMEare removed before each session. Neither
agent takes a steering message.
tenaz doctorand the setup wizard find both onPATH. See ADR 0019.- A
generate_3dmedia tool:--meshes <base URL> --mesh-model <model>
(atinitorrun, pinned inrun.jsonaslaunch.meshesUrland
launch.meshModel) let the agent turn a PNG or JPEG inside the project
into a GLB inside the project through mlx-serve's
POST /v1/3d/generations(Idol, TRELLIS.2). Each call takes the lease
like an image and is limited by--media-timeout.tenaz doctorhas an
optional3dline that offers a 3D model an engine lists. See ADR 0020.
Changed
- The engine proxy now forwards only the last assistant message's
reasoning: a harness that sends all of it back filled the window with
the model's earlier reasoning.--set keepPastReasoning=truesends it all. See ADR 0023. - When an ACP agent reports an edit as a diff, Tenaz records the edited
file's path as the call's result, not the agent's raw output. Qwen Code
sends the whole file before and after each edit in the diff, so every edit to
a large file raised a false big-output steer. - With
--harness qwen, the engine proxy refuses Qwen Code's own request
to summarize its conversation, and Tenaz ends the session there as one
out of context; a fresh session continues. Before, each summary took
minutes, showed as an empty reply, and the session was stopped right
after it anyway. See ADR 0022. - A reviewer stopped (for example at its turn budget) after writing its
review now says so in the log, as in
turn budget exceeded (38/25) after writing its review; its verdict (CHANGES) is used.
Before, it read only as a failed session, though its verdict was taken.
Fixed
- A session the engine held past a lowered context budget, with no
engine error, now raises the budget at once to the headroom share of its
peak (0.8 by default, the share a lowering uses), and
lifts a ceiling under that. Before, sessions that needed more than the
cap were cut one after another while Tenaz waited for a raise, and a
run could block. See ADR 0026. - A request the engine refuses for what is in it (400, 413, 415 or 422,
other than an image, a prompt too long or the engine's memory) is no
longer retried as it was. A fresh session continues the work with a
note that quotes the refusal and says to read that input another way;
the journal records it asrefused-continuation. Before, Tenaz
retried the same session six times with growing waits and then
blocked the run as "engine unavailable"; it still does once the
session's continuations are spent (ADR 0025). - A video file an agent reads reaches the engine as a note saying to
read it as frames. Before, Qwen Code sent the whole file, Sushi
refused each request, and the run blocked as "engine unavailable"
(ADR 0024). tenaz run --resumeon a run blocked with no task ready gets one
more replan. Before, the run had already used its one replan for
that, so it blocked again at once, and only an edit of
.tenaz/run.jsonlet it go on.- A replan that sets a blocked task back to
todowhile no card still to
build amends a check of its conflict gets one more prompt before it
ends, once per session, saying that Tenaz will block the task again.
It may then add theamendsor route around the task. Before, Tenaz set
the task back toblockedwhen the replan ended and said nothing, and
the run found no task ready and started another replan, or blocked.
The log says when Tenaz asks and when it blocks the task again (ADR
0018). - The watchdog sees Qwen Code's reads and writes (
ReadFile,
WriteFile,Edit), so it no longer stops a Qwen Code session that is
reading new files as idle, and the journal counts its writes. For an
ACP agent (fx, OpenCode, Qwen Code) it now goes by the tool call's
kindfirst (readoredit) and by the name only when the kind says
nothing about files. See ADR 0021. - After a
generate_3dor--imagesjob, Tenaz frees the media model
through the server'sPOST /v1/unload-model, as for ComfyUI. mlx-serve
keeps a 3D or image model loaded after its job; in the first real 3D run
TRELLIS.2 stayed resident for hours next to the LLM and the Mac swapped.
This is done also when the server is the LLM's own. A server without
that route is left as it is. A failed media unload is journaled
(media:<engine> failed unload: …) and no longer fails the job, which has
already written its file. - An ACP agent's tool call is reported with the input it runs with.
OpenCode and Qwen Code announce a call before its input is complete
(bashwith only its folder, a read with no file) and send the input
once it runs; Tenaz took the first version, so different calls looked
the same and the loop check stopped sessions that were working. A
pending call is now reported when it is about to run: at its permission
request, when it starts, or when it ends.toolMinutescounts from
then, so a call the agent sends neither a permission request nor
in_progressfor is not timed. A context stop held for a reply's tool
calls now also waits for a call that starts after another one ended.
A permission request names the call as its start does, not by the
title the agent shows people. - A replan that routes a blocked task's work through a card that amends
its conflict's checks may set the blocked task back totodo, depending
on that card, instead of dropping it. Tenaz used to reject that backlog
("amendsT001.runs, which no file in .tenaz/conflicts/ names") and end
the run BLOCKED. The reopened task starts with no attempts and is not
built while a card that amends its checks is still to build. A status a
planner may not set is now put right before its cards are judged. See
ADR 0018.
Install tenaz 0.5.0
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/aartiles/tenaz/releases/download/v0.5.0/tenaz-installer.sh | shInstall prebuilt binaries via Homebrew
brew install aartiles/tap/tenazDownload tenaz 0.5.0
| File | Platform | Checksum |
|---|---|---|
| tenaz-aarch64-apple-darwin.tar.gz | Apple Silicon macOS | checksum |
| tenaz-x86_64-unknown-linux-gnu.tar.gz | x64 Linux | checksum |
Verifying GitHub Artifact Attestations
The artifacts in this release have attestations generated with GitHub Artifact Attestations. These can be verified by using the GitHub CLI:
gh attestation verify <file-path of downloaded artifact> --repo aartiles/tenazYou can also download the attestation from GitHub and verify against that directly:
gh attestation verify <file-path of downloaded artifact> --bundle <file-path of downloaded attestation>