github UsefulSoftwareCo/executor executor@2.0.0-beta.61
Executor 2.0.0-beta.61

pre-release2 hours ago

Changes since 2.0.0-beta.60

All installs

  • Local Executor no longer makes every MCP client on one machine share one limit on sign-in token requests, so one busy client can no longer stop the others from getting tokens.
  • Connecting a LinkedIn account no longer fails at the last step once the LinkedIn app is updated, because apps can now turn off PKCE for a service that refuses it.
  • The desktop app no longer interrupts you with a dialog when an update is ready; a card in the sidebar shows it, and you can restart to install it from there.
  • The connect account dialog no longer runs off the screen for apps with long sign-in method names; its button now just says Validate.
  • Screen readers now hear Validating and then the result when the connect dialog checks credentials.
  • The connect account dialog now sums up a long list of hosts a credential may be sent to by domain, with a button that shows every host.
  • When a call to a tool that says it only reads fails, agents are now told it is safe to retry instead of that it may have changed data.
  • Agents are no longer told to read the Executor skill again when their client already showed the server instructions.
  • An app whose provider names only a subdomain host now shows a neutral icon instead of a logo from its parent domain, which could belong to another site.
  • The desktop app shows a ready update at the bottom of the sidebar as a short line with a Restart to update link.
  • When the desktop app's sidebar is collapsed, a small download icon shows that an update is on its way, with a dot once it is ready; pressing it opens the sidebar.
  • Agents are now told to run independent tool calls so that one failure keeps the other results, and when one of several tool calls running together fails, the error now says the others were interrupted, that finished calls did run, and how to keep their results.
  • A workflow sleeping until a time that passes while the request is on its way now continues, where it could fail under load.
  • When the desktop app has an update ready, the sidebar shows what changed in it, and clicking it lists every change since the version you are running.
  • Self-hosted servers now check once a day for a newer release and show owners and admins how to update; the docs explain what the check sends and how to turn it off.
  • The self-hosted update check asks the same npm registry mirror that app installs use, also on a private network, and does not ask at all while it cannot save when it last asked.
  • The self-hosted update check now reaches the npm registry exactly as app installs do, without proxy variables, and logs one warning when it cannot save its record.
  • Executor no longer runs out of memory and restarts every app when many apps with a database are used in quick succession.

Self-host

  • The usage dashboard now names MCP clients that use the newest MCP protocol version, such as recent Claude Code releases, instead of showing them as unnamed.
  • The self-host image now logs a clear line when the server stops answering, and can restart it when you turn that on.

Not listed: 31 other changes.

Install

Install with npm, npm i -g executor@beta, on Node 14.18 or newer. Without Node, run curl -fsSL https://executor.sh/docs/install.sh | sh
on macOS or Linux, or irm https://executor.sh/docs/install.ps1 | iex in
PowerShell on Windows. Each release also attaches its archives and SHA256SUMS.
Run executor to start the background Executor, or join the one already
running, and open the dashboard. The background Executor keeps running until
executor service stop; nothing starts it with the OS. executor checks npm
daily for a newer release and suggests executor upgrade; set
EXECUTOR_NO_UPDATE_CHECK=1 to skip it. Use executor service start to start it
without a browser, executor serve to run it in the foreground, and
executor service pair to get a new browser connection link.
executor upgrade installs the newest release on your channel the way Executor
was installed: an install-script copy downloads and checks the release and keeps
the previous version for executor upgrade --rollback; an npm, pnpm, Bun or
Yarn install runs its package manager. Either way it stops the background
Executor before replacing its files and starts it again on the new version; a
release from before the background service, which a rollback can return to, has
no executor service, so run executor serve there instead.

Executor is one executable, built with Bun, with the files it runs or reads
beside it: the dashboard, the app framework and compiler references, workerd,
Git, the native credential-store binding and the telemetry collector with its viewer. It needs no
source checkout, Node, Bun or 1Password on the user machine. The executor npm
package is a launcher. The first time a version starts, it downloads that
release's archive for the platform, for macOS (Apple Silicon and Intel), Linux
(arm64 and x64, glibc) or Windows (x64), from the public GitHub release, checks it
against the SHA-256 the package records, and keeps it in
~/.executor/v2/launcher/<version> with the version before it. The same archive
is the release download the install scripts and Homebrew use.
EXECUTOR_DOWNLOAD_URL names a mirror of the releases for all of them.

Beta uses ~/.executor/v2/cli for its data. This path stays the same at the
stable release. It is separate from Executor 1 data. One server runs per data
directory; its .server.lock stops a second. EXECUTOR_DATA_DIR selects another
directory, and EXECUTOR_PORT or executor service set port changes the default
port of 4312. The desktop app uses the same directory and background Executor.
Its first launch moves the data of a desktop release from before the background
service into that directory, once. CLI data already there moves to
~/.executor/v2/backups/cli-data-<time>, which the desktop app names; nothing
is merged or deleted. The CLI's settings carry over, except its port and the
env variables that belong to its data.

On first launch, Executor saves its API and encryption keys in the OS credential
store: macOS Keychain, Windows Credential Manager, or Linux Secret Service.
Linux uses a persistent Secret Service such as GNOME Keyring. If there is no
store on a directory's first start, the keys are saved to keys.json in the
data directory (mode 0600) and the path is printed to stderr. If a store exists
but access is denied or it is locked, startup stops without a key file and the
next start asks again. Over SSH, unlock the store first, or set
EXECUTOR_KEY_STORAGE=file before a directory's first start to use keys.json
(os requires the store instead). A directory that already uses the OS store stops when it
is locked or unavailable. A missing or
invalid credential or key file stops startup; existing installations never
receive replacement keys.

Back up the data directory, including installation.json and any keys.json,
and the matching OS credential (com.usefulsoftware.executor.v2, account ID
from that file) when the directory uses one.
Copying only the data directory to another machine is not enough to recover it.
For a new headless install, supply both EXECUTOR_API_KEY (32+ characters) and
EXECUTOR_ENCRYPTION_KEY (64 hexadecimal characters) through a secret manager.
Those supplied keys are never saved by Executor. Keep them with your backups.
A directory keeps its chosen key source across upgrades; changing it requires
an explicit transfer. Uninstalling the program does not delete your data or keys.

Don't miss a new executor release

NewReleases is sending notifications on new releases.