Skip to content

Editing a registry agent's command doesn't change what runs — a binary agent still downloads its registry build #121

Closed

Description

@hussain

The problem

An agent added from the ACP registry keeps its registry link after its command is edited. Saving the card stores the new command, but the link stays, and for a binary agent the link decides the launch: every connect still downloads and runs the registry's pinned archive. The typed command never runs, and declining the download leaves the agent crashed.

Reported by @GF-Huang in anomalyco/opencode#11176: he added OpenCode V2 from the registry and changed its command to his own C:\Users\Huang\cli-tools\opencode.exe acp. On connect he was asked to download OpenCode V2 2.1.2:

Download prompt for OpenCode V2 2.1.2 after the command was edited

Declining left the card crashed, with his edited command shown above it:

Agent card: crashed — launch prerequisite unavailable — OpenCode V2 2.1.2 download declined

Root cause

A registry agent was stored as what Add made of the registry entry: the launch line rendered into the agent's own command and args, its env merged into the agent's env, and only the registry id, the version and — for a binary — the archive kept as the link. The registry's recipe itself was never kept. So an edited command can't be told from the registry's own, and the link survives the edit: the save keeps the stored registrySource whatever the form sends (agents-store.ts, the agent-config save). For a binary agent that link decides the launch — a spec built from it carries the archive as a launch phase (specFromConfig), and the phase runs the archive's executable — and for every kind an Upgrade replaces the edited command with the registry's.

Workaround until then: add the local binary through Add agent → Custom instead of editing the registry card.

Activity

  1. added this to the 0.88.3 milestone on Oct 22, 2026
  2. hussain commented on Oct 22, 2026

    @hussain
    MemberAuthor

    Fixed in 6e8731c and 09df4f4 — ships with 0.88.3.

    A registry agent now keeps the registry's recipe for its version, so an edited command can be told from the registry's own. Changing the command makes the agent custom: what you typed is what runs, with no registry download and no upgrade writing over it — the form says so before Save. An agent edited before this release, like the OpenCode V2 card above, is made custom on first start. The way back to the registry is adding it from the registry again.

  3. hussain commented on Oct 22, 2026

    @hussain
    MemberAuthor

    @GF-Huang v0.88.3 is shipped — upgrade the Patchbay extension.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Type

    No type

    Projects

    No projects

      Milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions