Skip to content

spec(deep-link-scheme): add zeph:// URI scheme specification#5009

Merged
bug-ops merged 1 commit into
mainfrom
deep-link-scheme
Jun 7, 2026
Merged

spec(deep-link-scheme): add zeph:// URI scheme specification#5009
bug-ops merged 1 commit into
mainfrom
deep-link-scheme

Conversation

@bug-ops

@bug-ops bug-ops commented Jun 7, 2026

Copy link
Copy Markdown
Owner

Summary

Scope (v1 as specified)

  • URI grammar: zeph://new-session?cwd=...&prompt=...&profile=...&model=...
  • OS registration: Linux + Windows full; macOS dispatch-only (no .app wrapper in v1)
  • CLI subcommands: zeph url-open "<uri>" and zeph url-scheme {register,unregister,status}
  • ACP: spawn-only for v1 (bearer-token discovery for HTTP-attach deferred to v2 as OQ-2)
  • Security invariants: INV-CWD (7-step canonicalization), INV-LOOP, INV-TRUST, INV-NOAUTO, INV-SYNC, INV-NOTTY

Implementation plan

18 granular tasks in tasks.md, organized in 3 phases:

  1. Core parser + validation (zeph-common)
  2. CLI subcommands + OS registration
  3. Session bootstrap integration + TUI indicator

Related

@github-actions github-actions Bot added documentation Improvements or additions to documentation size/XL Extra large PR (500+ lines) labels Jun 7, 2026
Spec package produced by team-develop spec-driven chain for issue #4687.
Follow-up implementation tracked in the linked issue.

Covers: URI grammar, OS-level registration (Linux+Windows v1, macOS dispatch),
CLI `zeph url-open`/`zeph url-scheme` subcommands, security model (INV-CWD,
INV-TRUST, INV-NOAUTO), ACP spawn-only for v1, 18 granular implementation tasks.
@bug-ops
bug-ops force-pushed the deep-link-scheme branch from be3df66 to dc69a67 Compare June 7, 2026 15:42
@bug-ops
bug-ops enabled auto-merge (squash) June 7, 2026 15:42
@bug-ops
bug-ops merged commit 41c7ab3 into main Jun 7, 2026
20 checks passed
@bug-ops
bug-ops deleted the deep-link-scheme branch June 7, 2026 15:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation size/XL Extra large PR (500+ lines)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

feat(ux): deep link scheme for fresh session initiation (zeph://new-session)

1 participant