Skip to content

feat(settings): Distinguish first-party ACP harnesses from npx-adapter presets in UI #929

Closed

Description

@cursor

What

Settings/landing copy should clarify which Harness presets need Node (Claude/Codex/Pi via npx adapters) vs which are standalone CLIs (hermes/opencode/grok/cursor-agent, zero external deps beyond the binary itself).

Why now

#735 census showed users face a choice: three presets need Node+npx (external dep), four need only a PATH binary (which they may already have installed). Presenting this distinction helps users choose the zero-dep option when available.

Scope

In

  1. Settings Harness picker — Group or annotate presets. Examples:
    • "Standalone: hermes, opencode, grok, cursor-agent (no Node required)"
    • "Requires Node: Claude, Codex, Pi (install from nodejs.org)"
    • Or inline badges/notes per preset row.
  2. Chat connect landing — When presenting Harness buttons, clarify which need external deps. Same grouping or annotation as Settings.
  3. First failure messaging — fix(chat): Surface a missing Harness launcher on the landing #831 already shows ```npx` is not installed`` for Claude/Codex/Pi. Ensure first-party ACP missing-binary messages name the CLI to install (e.g. "Install Hermes from https://...").
  4. Consistent naming — "First-party ACP" vs "registry adapter" vs "npx adapter" — pick one term for the distinction and use it consistently.

Out

Done when

  • Settings Harness picker groups or annotates zero-Node presets (hermes/opencode/grok/cursor-agent) vs npx presets (Claude/Codex/Pi).
  • Chat landing buttons or copy clarify the same distinction.
  • Missing-binary messages for first-party ACP name the correct CLI + install URL (hermes → hermes-agent.nousresearch.com, etc.).
  • Terminology consistent across Settings/landing/errors.

Related

— Cursor agent, on @omesser's behalf.

Activity

  1. added this to the V1 milestone on Sep 23, 2026
  2. omesser commented on Sep 23, 2026

    @omesser
    Owner

    Clarification (Oded)

    Sticky inline missing-dep text (selectable / copy-paste into search or another AI), not a toast. Presentation owned by #950; install URLs + first-party vs npx grouping stay here.

    Also related: #949 (Apply/Connect initializing), #948 (ADR).

    — Cursor agent (Architect), on @omesser's behalf.

  3. moved this from Todo to In Progress in Fidgeton Sep 23, 2026
  4. moved this from In Progress to Done in Fidgeton Sep 23, 2026
  5. omesser commented on Sep 23, 2026

    @omesser
    Owner

    Shipped on main via #961

    Merge commit 639a1486.

    Done when — checked against main

    • Settings Harness picker annotates standalone CLIs (cursor-agent, grok, hermes, opencode) vs registry adapters (claude, codex, pi) that need Node.js + npx — section + row disclosure in settings/form.rs.
    • Chat missing-binary landing copy includes install URLs via installUrlFor() (npx → nodejs.org; hermes / cursor-agent / grok / opencode → their sites).
    • Rust not_installed() carries the same URLs.
    • Terminology: standalone binaries/CLIs vs registry adapters.

    Chat landing does not add a separate proactive button grouping; the distinction is in Settings disclosure, and Chat surfaces the right install URL when a launcher is missing (presentation stickiness remains #950).

    — Cursor agent (Coder), on @omesser's behalf.

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

    No labels
    No labels

    Projects

    • Status
      Done

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions