Repository navigation
v0.26.0
·
98 commits
to main
since this release
Immutable
release. Only release title and notes can be modified.
Security
From a security audit of the repository.
auth loginopens onlyhttpslogin addresses (orhttpto this machine).
The address comes from the server's OAuth metadata, and the browser opener does
whatever its scheme says: a hostile server could havexdg-open,openor
rundll32open afile:,smb:or app link, which on Windows can start a program.
It's refused before anything is opened or printed.toolmenu mcp: honest annotations,save_asinsidecwd.snapshot_menuand
check_sessionrun the command they're given, but were annotated
destructiveHint: false, so a client that auto-approves non-destructive tools would
let a prompt-injected agent run anything. They'redestructiveHint: truenow.
save_aswrites only insidecwd(symlinks followed): a new file, or an existing
menu file, never a shell profile or a source file.- Reports show a server's text; they never act on it. Tool names, descriptions,
serverInfoand error text went into reports as sent. In a terminal, escape
sequences could change the title, clear the screen or fake links, and a newline
could forge a finding or a::error::line in a CI log. In markdown (the Action's
PR comment) a backtick ended the code span, and images, links, @mentions and
#references rendered, posted by github-actions. Now control, invisible and
text-direction characters are shown as escapes (\u001b,\n), markdown is escaped
around toolmenu's owncode, and every write to stdout and stderr goes through the
same escaping. JSON output stays the same JSON. The menu file keeps the exact bytes. - The Action's PR comment can't be taken over. It edited the first comment with
its marker, whoever wrote it; now only one its own token wrote. - The Action keeps PR text out of its arguments and its markdown:
--releaseis
one argument (apackage.jsonversion with spaces added arguments), and error
output goes in a code block its backticks can't close. scanfills${VAR}only from variables you name with--allow-env(or'*').
A config decides where each value goes, a URL included, so scanning someone else's
.mcp.jsoncould send any secret in your environment to their server.- Credentials off the command line.
TOOLMENU_ARGS(a JSON array of options and
their values) keeps--header,--envand--client-secretvalues out ofps,
where every user of the machine can read them; the Action passes itsheadersand
envthat way (to an olderversionstill as arguments, with a warning). - Release and CI workflows: least-privilege tokens, every action pinned to a
commit (Dependabot keeps them current), and the npm package built in a job apart
from the tests and published from a job that runs no dependency, with npm's trusted
publishing: no long-lived npm token anymore.toolmenu init
pins the actions it writes the same way. - Smaller: a menu file,
toolmenu.config.jsonor scan list that isn't JSON is
reported without quoting it; JUnit output escapes characters a terminal acts on;
historyuses only semver-shaped registry versions; macOS runners (bash 3.2) get
their SARIF files.
Breaking
scan: a config that uses${VAR}needs--allow-env VAR(or--allow-env '*'
for the old behaviour). The entry says which.toolmenu mcp:save_asoutsidecwd, or over a file that isn't a menu, is an
error. The release-check skill keeps its baseline inside the worktree.snapshotexits 1 on a server whose tool names hold control, invisible or
text-direction characters (spec/tool-name, below).
Also
spec/tool-name: a tool name outside the format the spec recommends from
2025-11-25 (1 to 128 ofA-Z a-z 0-9 _ - .) is a warning (info on older
protocols), and an error when it hides characters.- An HTML report.
--html <path>writes the run ofsnapshot,difforsession
as one self-contained page beside the usual report: stat cards (errors, warnings,
tools, tokens; breaking changes and the suggested bump fordiff), the menu as a
table in server order with each tool's share of the tokens, and the findings with
their next steps.diffshows each tool before and after;sessionhas a row per
step with the menu after it, marking tools inserted, appended or edited, and links
each step to its findings. No script and nothing fetched, so it opens offline from a
CI artifact; light and dark follow the viewer. The design follows the Board UI
design system, in the logo's colours. - Library:
sessiontakesonStepMenu(the menu after each step, with what the step
inserted, appended, moved, edited or removed;stepMenuandStepToolare
exported), kept out of the result so the JSON output is unchanged. New
comparedTools(before, after, ignore)returns the toolsdiffMenuscompares (after
the ignore globs, with their served positions) and which were added, removed and
renamed;diffMenususes it too.