fix: `run --attach` agent validation by alberti42 · Pull Request #11812 · anomalyco/opencode · GitHub

Update (02/08): I edited the PR description following #11812 (comment). The new fix intentionally does not forward the client cwd when attaching, since the client and server may be on different machines/filesystems. The crash is fixed by validating --agent against the attached server.

Update (02/25): Added to the PR description explicitly the issues fixed and closed. Before they were marked in the comment section.

Release Note

Fix crash when running opencode run --attach ... --agent ... by validating agents on the attached server.

Fixes #6489
Closes #8094

What changed

opencode run no longer crashes when used with both --attach and --agent.

This PR fixes a client-side crash that occurred before any request was sent to the attached server.

Problem

The issues were raised in #6489 and #8094. This PR fixes those issues.

Here below is a short summary of the issues:

Running opencode run with --attach + --agent would fail with:

Error: No context found for instance

Root cause:

The --attach path in packages/opencode/src/cli/cmd/run.ts does not run bootstrap(...), so no Instance async-local context is created.
The CLI tried to validate --agent via Agent.get(...), which depends on Instance.state(...) and requires that missing context.
Result: immediate crash.

Implementation

Changes are contained to packages/opencode/src/cli/cmd/run.ts:

When --attach is used, validate --agent against the attached server (via GET /agent, SDK: sdk.app.agents()), instead of calling local Agent.get(...).

If the agent doesn’t exist (or is mode: "subagent"), print the existing warning and fall back to the default agent.
If the agent list can’t be fetched, warn and fall back.

How to reproduce (before) / verify (after)

Start a server:

opencode server --port 4096

Assuming you have an agent called shell_cmd_generator, run:

  opencode run \
  --attach http://localhost:4096 \
  --agent shell_cmd_generator \
  --model 'google/gemini-2.5-flash' \
  --log-level DEBUG \
  --format json \
  '<user><request>How to list the files in this directory?</request></user>'

In practice, replace shell_cmd_generator with one of the primary agents available for you.

Before: crashes with No context found for instance.

After: completes successfully and uses the requested agent (or gracefully falls back if unavailable).

Notes

This keeps existing CLI behavior for unknown/subagent agents: warn + fall back.
For attached runs, the CLI intentionally does not assume the client’s process.cwd() matches the server’s filesystem.

Hey! Your PR title Fix run --attach agent validation and forward cwd doesn't follow conventional commit format.

Please update it to start with one of:

feat: or feat(scope): new feature
fix: or fix(scope): bug fix
docs: or docs(scope): documentation changes
chore: or chore(scope): maintenance tasks
refactor: or refactor(scope): code refactoring
test: or test(scope): adding or updating tests

Where scope is the package name (e.g., app, desktop, opencode).

See CONTRIBUTING.md for details.

The following comment was made by an LLM, it may be inaccurate:

Potential duplicate found:

PR fix(cli): skip local agent validation in attach mode #8154: fix(cli): skip local agent validation in attach mode
- URL: fix(cli): skip local agent validation in attach mode #8154
- Why related: This PR directly addresses skipping local agent validation in attach mode, which is a core part of the fix in PR fix: run --attach agent validation #11812. While PR fix(cli): skip local agent validation in attach mode #8154 appears to be an earlier attempt at fixing agent validation in attach mode, PR fix: run --attach agent validation #11812 is a more comprehensive fix that also includes forwarding the caller's cwd to the server.

The searches show that PR #8154 is the most closely related PR. You may want to review whether #8154 was closed/reverted and why this new PR is needed, or if they're addressing the same underlying issues from different angles.

Thanks for your contribution!

This PR doesn't have a linked issue. All PRs must reference an existing issue.

Please:

Open an issue describing the bug/feature (if one doesn't exist)
Add Fixes #<number> or Closes #<number> to this PR description

See CONTRIBUTING.md for details.

This PR doesn't have a linked issue. All PRs must reference an existing issue.

Fixes #6489 and #8094

I made a PR for allowing --dir with opencode run, in my PR dir is assumed local if not used with attach, and passed as it is to server if attach is being used
#12443

You shouldn't assume dir is process.cwd() when attaching to a server, in my case if I run attach to my linux box from my mac and it passes my mac cwd to linux server, that would cause problems

This is a fix following the feedback anomalyco#11812 (comment)

Thanks @BlankParticle ! I reverted the "offending" line back to the original. I will take a look at your PR. It sounds very useful! Let me know if there is anything else to be fixed.

any update this for being merged? would be super helpful for my tmux workflow when using my VPS

any update this for being merged? would be super helpful for my tmux workflow when using my VPS

Unfortunately there was no real feedback so far. It would be great if a maintainer could give some feedback if more work is needed.

…ntext found for instance`

@adamdotdevin @Hona — gentle ping. I've added the required Fixes #... links to the PR description. This is a bug fix for a crash on run --attach --agent. The cwd concern raised by @BlankParticle has also been resolved.

I would appreciate feedback when you have a moment. Glad to invest more time, and polish it along your indications.

I will look tomorrow

Any updates here? This is the last step needed for my tmux-powered orchestrator to operate correctly.

Any updates here? This is the last step needed for my tmux-powered orchestrator to operate correctly.

same here, super useful with tmux

merged - thanks friends

Co-authored-by: LukeParkerDev <10430890+Hona@users.noreply.github.com>

github-actions Bot added the needs:title label Feb 2, 2026

This was referenced Feb 2, 2026

Unable to use --agent option when using run with --attach #8094

Closed

Specify an agent when attaching to server fails #6489

Closed

alberti42 changed the title Fix run --attach agent validation and forward cwd fix: run --attach agent validation and forward cwd Feb 3, 2026

github-actions Bot added needs:issue and removed needs:title labels Feb 3, 2026

This was referenced Feb 4, 2026

[FEATURE]: Add a /delete command to delete the current session #8677

Closed

fix(cli): skip local agent validation in attach mode #8154

Closed

alberti42 force-pushed the dev-fork-fix-agent-attach branch from bbf42cc to ca88433 Compare February 7, 2026 09:34

alberti42 added a commit to alberti42/fork-opencode that referenced this pull request Feb 8, 2026

Refactor agent retrieval logic in run.ts

4d34ff0

This is a fix following the feedback anomalyco#11812 (comment)

alberti42 force-pushed the dev-fork-fix-agent-attach branch 4 times, most recently from 6ce24ed to 94ec407 Compare February 12, 2026 20:32

github-actions Bot mentioned this pull request Feb 16, 2026

fix(attach): default working directory to invoker's cwd #13844

Closed

fix(cli): opencode run --attach ... --agent ... crashes with `No co…

e0edbd4

…ntext found for instance`

alberti42 force-pushed the dev-fork-fix-agent-attach branch from 94ec407 to e0edbd4 Compare February 24, 2026 18:56

fix(cli): handle attached agent lookup errors

9270877

Hona changed the title fix: run --attach agent validation and forward cwd fix: run --attach agent validation Mar 3, 2026

Merge branch 'dev' into dev-fork-fix-agent-attach

13c4d32

Hona enabled auto-merge (squash) March 3, 2026 22:23

Hona merged commit 109ea17 into anomalyco:dev Mar 3, 2026
9 checks passed

praxstack pushed a commit to praxstack/opencode that referenced this pull request Mar 5, 2026

fix: run --attach agent validation (anomalyco#11812 )

c6ae183

Co-authored-by: LukeParkerDev <10430890+Hona@users.noreply.github.com>

alberti42 deleted the dev-fork-fix-agent-attach branch March 8, 2026 22:51

coleleavitt mentioned this pull request Apr 21, 2026

fix/memory 20695 coleleavitt/opencode#5

Merged

xywsxp pushed a commit to xywsxp/opencode that referenced this pull request Apr 24, 2026

fix: run --attach agent validation (anomalyco#11812 )

2d4c084

Co-authored-by: LukeParkerDev <10430890+Hona@users.noreply.github.com>

Rwanbt pushed a commit to Rwanbt/unifia that referenced this pull request May 5, 2026

fix: run --attach agent validation (anomalyco#11812 )

e6e24f3

Co-authored-by: LukeParkerDev <10430890+Hona@users.noreply.github.com>

AIALRA-0 pushed a commit to AIALRA-0/opencode-turn-engine that referenced this pull request Jun 10, 2026

fix: run --attach agent validation (anomalyco#11812 )

19c9ae8

Co-authored-by: LukeParkerDev <10430890+Hona@users.noreply.github.com>

AIALRA-0 pushed a commit to AIALRA-0/opencode-turn-engine that referenced this pull request Jun 10, 2026

fix: run --attach agent validation (anomalyco#11812 )

5b2081b

Co-authored-by: LukeParkerDev <10430890+Hona@users.noreply.github.com>

avion23 pushed a commit to avion23/opencode that referenced this pull request Jun 10, 2026

fix: run --attach agent validation (anomalyco#11812 )

8d3d24c

Co-authored-by: LukeParkerDev <10430890+Hona@users.noreply.github.com>

Rwanbt pushed a commit to Rwanbt/unifia that referenced this pull request Jun 14, 2026

fix: run --attach agent validation (anomalyco#11812 )

c1ce836

Co-authored-by: LukeParkerDev <10430890+Hona@users.noreply.github.com>

MarsQiu007 referenced this pull request in MarsQiu007/openNovel Jul 31, 2026

fix: run --attach agent validation (#11812)

9f6a28d

Co-authored-by: LukeParkerDev <10430890+Hona@users.noreply.github.com>

fix: `run --attach` agent validation by alberti42 · Pull Request #11812 · anomalyco/opencode · GitHub

Uh oh!

fix: run --attach agent validation - #11812

fix: run --attach agent validation#11812Hona merged 3 commits intoanomalyco:devanomalyco/opencode:devfrom alberti42:dev-fork-fix-agent-attachalberti42/fork-opencode:dev-fork-fix-agent-attachCopy head branch name to clipboard

Conversation

alberti42 commented Feb 2, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Release Note

What changed

Problem

Implementation

How to reproduce (before) / verify (after)

Notes

Uh oh!

github-actions Bot commented Feb 2, 2026

Uh oh!

github-actions Bot commented Feb 2, 2026

Uh oh!

github-actions Bot commented Feb 3, 2026

Uh oh!

alberti42 commented Feb 3, 2026

Uh oh!

BlankParticle commented Feb 7, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

alberti42 commented Feb 8, 2026

Uh oh!

iamhenry commented Feb 23, 2026

Uh oh!

alberti42 commented Feb 24, 2026

Uh oh!

alberti42 commented Feb 25, 2026

Uh oh!

Hona commented Feb 25, 2026

Uh oh!

pid1 commented Mar 3, 2026

Uh oh!

iamhenry commented Mar 3, 2026

Uh oh!

Uh oh!

Hona commented Mar 3, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

fix: run --attach agent validation#11812
Hona merged 3 commits into
anomalyco:devfrom
alberti42:dev-fork-fix-agent-attach

alberti42 commented Feb 2, 2026 •
edited
Loading

BlankParticle commented Feb 7, 2026 •
edited
Loading