v0.0.17
6.33mib · 15,854 testsSubagents now work alongside you: switch between agents and run several fx instances in one window. Vercel Token Pass is now first-class in fx. Tool definitions 48.0% smaller, and 82.0% of later input from the prompt cache, up from 61.3%.
New Features
Subagents work alongside the main agent and report back when they finish.
Switch to any subagent to watch it, message it, or answer its prompts.
A parent agent hears when its subagent's command has printed nothing for 2 minutes.
Open the agent list with Down or Ctrl+X to see, search, switch, and close agents.
Each subagent has its own model, effort, Fast mode, and permission mode, and subagents can nest two levels deep.
The main agent sees its subagents each turn and reuses idle ones for related work.
Agent profiles in
~/.fx/agentsor.fx/agentsset an agent's tools, MCP servers, model, and prompt.fx --profile <name>starts a session in an agent profile.fx --instances <n>and/launchrun several fx instances in one window.fx sessions --livelists open sessions and their subagents.fx session <id>/<agent>reads a subagent's conversation, and--tail <n>shows only the last turns.Vercel Token Pass models come first in the model picker.
/creditsandfx creditsshow your Token Pass credit and its reset date.Token Pass sessions use Token Pass models for titles, images, and auto mode review.
Login offers Token Pass to teams that don't have it yet.
The
toolboxtool replacesskill,capability_search, andmcp_select_tool, so every request sends the same tools.fx mcp call TOOLruns an MCP tool from a shell command.Custom connections can set effort levels, request fields, headers, timeouts, and a title model.
Cache warming keeps Claude's prompt cache warm while you pause, and
"cache_warming": falseturns it off.Reopening a session after a crash or a closed window sends the interrupted request again.
Plain
fxshowsInterrupted turn · /resume to continuewhen a turn was left unfinished.fx configlists, reads, and changes settings.fx ask --config key=valueoverrides a setting for one request.fx completion bash,zsh, andfishprint a shell completion script.fx "<prompt>"starts a session with that prompt, and-ris short for--resume.FX_HOMEmoves the profile folder from~/.fx.Ctrl+T cycles the reasoning effort.
Improvements
Toolbox raised prompt cache reads from 61.3% to 82.0% of later input in live tests across 9 model families.
Built-in tool definitions are 48.0% smaller than in 0.0.16, and a new session's first request is 32.4% smaller.
libfx's native addons are 10.1% to 12.9% smaller than in 0.0.16.
The Linux arm64 and x86_64 binaries are 36.6% and 31.1% smaller than in 0.0.16.
libfx requests now use AI Gateway's prompt cache.
A shell result for a command with no output is about 70 characters instead of about 340.
Skill descriptions in the toolbox menu stop at 200 characters, down from 1,024.
Earlier turns go back to the model unchanged, so the prompt cache keeps covering them.
An attached file's folder rules arrive as a note, so the prompt cache keeps matching.
Conversations with many images drop the oldest in blocks, so the prompt cache stays valid longer.
Amazon Nova models now use the prompt cache.
Long sessions stay responsive, with the last turn of a 2,400-tool-call session taking 3 s instead of 11 s.
Full detail in Ctrl+O shows each model call with its model, time, tokens, and call ID.
/tracewrites JSON Lines instead of a Markdown report./traceincludes subagents and keeps failed calls whole.Questions from the model render as Markdown.
fx doctornow tests your credential and connects to each approved MCP server.Requests keep retrying through network drops, gateway errors, and rate limits until they succeed or you press Esc.
Steering moves a running shell command to the background, so your message reaches the model within about a second.
Cancelling a turn also stops the commands that steering moved to the background.
A command still running in the background shows
Still runninginstead ofRan.A waiting shell command uses under 1% of a core instead of about 3%.
More gateway errors are retried, including 520, 524, and 529.
The status line shows why a request is retrying and when it tries again.
fx resends a request within about a second when the Mac changes networks, instead of after 45 seconds.
fx finds a dead connection within about 5 seconds after the network returns, instead of waiting up to 10 minutes.
On a dead network,
fx askandfx acpstart in about 2 seconds instead of 20 to 30.A brief Mac sleep no longer restarts a healthy answer.
Errors show in plain words instead of error names.
A rejected or filtered request waits for you to send it again with Enter instead of ending the turn.
Running out of credits offers to retry, switch models, or cancel.
An expired sign-in opens the sign-in and then sends the request again.
A restarted answer replaces the broken one instead of following it.
A reply cut off before any text is sent again once instead of ending the turn.
fx asks the model to continue once when it stops without a reply.
After a tool call it can't read, fx tells the model and asks it again at once, with tools available.
A compaction the provider refuses as too long is sent again as a smaller request.
A command that fails again after an edit goes back to the model instead of ending the turn.
Shell results tell the model when a command has printed nothing for 2 minutes.
edit_fileerrors show the lines the model most likely meant.MCP arguments sent as text go to the server as the type its schema names.
Tool arguments a model writes as JSON text, such as question options and toolbox runs, are read like objects.
libfx sends host tools the argument types their schemas name.
Menus and pickers match letters in order, so
/mdlfinds/model.The model picker labels Fast models and Fast mode apart and lists newer GPT versions first.
Ordered lists in replies align their numbers.
Tool group headers say what the group did, such as
Edited a file, ran commands, instead of a tool-call count.Skill discovery warnings no longer show at startup.
MCP config changes made outside a session load at the next prompt.
fx mcp addsigns in to a new server that needs it, and--no-loginskips that.Mistyped commands, flags, and settings suggest the closest match.
Every command accepts flags as
--flag=value.fx pr,fx issue, andfx acptake the same run flags asfx ask.fx turns off color when
NO_COLORis set orTERM=dumb.The resume command prints on its own line at exit.
fx sessionsandfx sessions --liveprint aligned tables.fx retries a sign-out that the provider did not confirm.
A new libfx session skips 3 empty storage reads on its first prompt.
libfx starts preparing a prompt's run while the queue confirms the prompt.
Bug Fixes
Closing the window during a request no longer cancels it, so
fx -csends it again.fx askand ACP no longer wait 15 seconds for a stuck session title.Esc and Ctrl-C stop a request at once during a stuck DNS lookup.
Cancelling a turn ends a running tty command.
A cancelled provider switch ends at once.
fx uses a login another fx just refreshed instead of asking you to sign in again.
Several fx processes that get a 401 together refresh a shared fx, Codex, or Grok login once.
A cancel no longer cuts off a sign-in refresh, so other fx processes stay signed in.
A new Vercel sign-in starts on the team you used before.
A request waiting for a sign-in resends with the team you picked.
Claude Fable 5.1 and later no longer reject a continued session with "Invalid signature in thinking block".
Starting many HTTP MCP servers no longer crashes fx.
MCP logins save while other fx processes use the Keychain.
MCP logout says when a login couldn't be removed or revoked.
A named pipe in place of
~/.fx/mcp.jsonno longer hangs fx.fx says when it can't write its output and stops quietly when piped into
head.Startup-file wrappers such as Socket Firewall's
npmwork in fx.Large shell snapshots restore in full with macOS's bash 3.2.
A startup file that defines
builtinno longer breaks fx's shell.A backslash before a newline continues the line, as in the shell.
A daemon started by a command keeps running after the command ends.
Ctrl+Backspace deletes a word, and repeated Cmd+Backspace deletes across lines.
/rename,/image, and/shellpicked from the slash menu wait for their argument.Wide edit rows keep their
+N / -Mcounts.Resizing or resuming a session no longer drops turns from the screen, and long tool-heavy turns leave no blank rows in scrollback.
Theme switches and bracketed paste keep working after a terminal reset or Ctrl+Z.
Ctrl+G updates fx without moving or repeating the conversation.
A damaged session says it is unreadable and points to
fx doctor.New session IDs never start with a dash.
fx says why a terminal recording could not start.
libfx no longer sends the same Codex request twice.
/creditsshows the AI Gateway amount used.Skills load from a linked
FX_HOME, with multi-line descriptions and nested keys.fx keeps running when herdr doesn't answer.
A relative
HOMEno longer crashesfx mcp.MCP calls wait up to 5 minutes, up from 60 seconds.
Common tool-call mistakes from models no longer fail the call.
A blank custom answer no longer submits a question.
Quitting while the transcript loads no longer crashes fx.
Deeply nested provider events no longer crash fx.
Fixed a data race in parallel
grep_filessearches.
Security
Control codes in model replies, prompts, and MCP tool errors show as text instead of acting on the terminal.
fx logout codexrevokes the login at OpenAI.Shell commands no longer inherit
web_fetchconnections.fx doctorfix lines can't run commands from a project's.mcp.json.When other users can write to
~/.fx, fx removes their access and still loads your settings.Control characters in error messages show as visible escapes.
Breaking Changes
Auto mode now holds an action only for prompt injection or harm to your machine.
The subagent tool's one-off
runaction is gone.fx doctorexits 1 when a check fails.Usage errors exit with status 2 instead of 1.
statusLineis nowstatus_line, andnotificationsis nowsound.fx setup,/setup,fx mcp --profile, and/allowlist userandlocalwarn now and stop working in fx 0.0.18.Old resume spellings, such as
fx resumeand--resume-id, are removed.fx ask --verboseandFLASH_SYNC_UPDATESare removed; useFX_SYNC_UPDATES.Esc during a retry ends the turn, and the separate Esc-to-pause is gone.
fx ask --jsonand ACP report recovery asstate,attempt,need, andmessage.