feat: project-aware ocman:// URL schemes #74

Open
opened 2026-05-28 11:45:30 +02:00 by dries · 1 comment
Owner

From spec/multi-agent-support/agent-feature-survey.md — finding #22.

What it is

Cursor / Windsurf / Zed have OS-level URL handlers (cursor://, zed://) for "open this repo / file in the editor".

Seen in

All IDE agents.

ocman angle

Register ocman://session/<id> and ocman://project/<dir> URL schemes. Lets us link to ocman from external tools (GitHub PR comments, Slack messages, docs). Combined with finding #5 (ocman://prompt), this becomes a real integration surface.

Effort

S–M (OS registration is the annoying part).

From [spec/multi-agent-support/agent-feature-survey.md](../src/branch/main/spec/multi-agent-support/agent-feature-survey.md) — finding #22. ## What it is Cursor / Windsurf / Zed have OS-level URL handlers (`cursor://`, `zed://`) for "open this repo / file in the editor". ## Seen in All IDE agents. ## ocman angle Register `ocman://session/<id>` and `ocman://project/<dir>` URL schemes. Lets us link to ocman from external tools (GitHub PR comments, Slack messages, docs). Combined with finding #5 (`ocman://prompt`), this becomes a real integration surface. ## Effort S–M (OS registration is the annoying part).
Author
Owner

Folding in #57 (prompt URL handler / send-problems / explain-and-fix). This issue is now the single deep-link tracker. Scope additions from #57:

  • ocman://prompt?text=... (survey finding #5): open ocman with a pre-filled prompt aimed at the active OpenCode session, using existing project-detection to route to the right instance.
  • "Explain and Fix" / send-problems entry points (browser extension / bookmarklet) as a follow-up on top of the URL handler.

Note: OS-level scheme registration (ocman://) is more involved than the current effort:trivial label suggests — consider re-labelling to effort:medium.

Folding in #57 (prompt URL handler / send-problems / explain-and-fix). This issue is now the single deep-link tracker. Scope additions from #57: - `ocman://prompt?text=...` (survey finding #5): open ocman with a pre-filled prompt aimed at the active OpenCode session, using existing project-detection to route to the right instance. - "Explain and Fix" / send-problems entry points (browser extension / bookmarklet) as a follow-up on top of the URL handler. Note: OS-level scheme registration (`ocman://`) is more involved than the current effort:trivial label suggests — consider re-labelling to effort:medium.
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
dries/ocman#74
No description provided.