Skip to content

feat(web): universal-agent install prompt as primary action#14

Merged
alextnetto merged 2 commits into
mainfrom
feat/web-universal-agent-prompt
May 11, 2026
Merged

feat(web): universal-agent install prompt as primary action#14
alextnetto merged 2 commits into
mainfrom
feat/web-universal-agent-prompt

Conversation

@alextnetto
Copy link
Copy Markdown
Member

Summary

The landing page's install panels were both Claude-Code-shaped — the plugin marketplace one is Claude-Code-only by design, and the "any MCP client" panel ironically shipped claude mcp add ... as the one-liner. Users on Cursor / Codex / Cline / Aider had to mentally translate.

This PR leads with a copyable agent prompt instead. Paste it into any agent chat, the agent installs the MCP its own way (each client has its own config) and reads the linked SKILL.md to learn the polling pattern.

The two CLI one-liners are kept behind a <details> disclosure ("Or run a CLI command directly") for users who want to skip the round-trip through their agent. Step 1 of "How it works" also reframes from "Install in Claude Code" to "Install in your agent".

Also fixes a stale alias reference: viewHost in requests.prod.http was still pagent.vercel.app; updated to the canonical agent-ui-session.vercel.app declared in #9.

Test plan

  • npm run typecheck — clean
  • npm run lint — clean
  • npm run format:check — clean
  • npm test — 162/162 pass
  • npm run build:web — succeeds
  • Verified visually in dev server: primary panel shows the prompt, disclosure expands to reveal both CLI panels, copy buttons render correct labels (Copy prompt / Copy), step 1 copy updated.

Both existing install panels assumed Claude Code's CLI surface — the
plugin marketplace one is Claude-Code-only by design, and the "any MCP
client" panel ironically shipped the `claude mcp add ...` one-liner.
Anyone using Cursor / Codex / Cline / Aider had to translate.

Lead with a copyable prompt instead. The user pastes it into any agent
chat and the agent installs the MCP its own way (Claude Code's
`claude mcp add`, Cursor's `~/.cursor/mcp.json`, Codex's config, etc.)
and reads the linked SKILL.md to learn when to call show_ui /
check_result.

The two CLI one-liners aren't gone — they're tucked behind a
"Or run a CLI command directly" disclosure for power users who want
to skip the round-trip through their agent. Step 1 of "How it works"
also reframes from "Install in Claude Code" to "Install in your agent".

Also fixes a stale alias reference in requests.prod.http: `viewHost`
was still pointing at the legacy `pagent.vercel.app` instead of the
canonical `agent-ui-session.vercel.app` declared in #9.
@vercel
Copy link
Copy Markdown

vercel Bot commented May 11, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
pagent Ready Ready Preview, Comment May 11, 2026 1:22am

Request Review

Per follow-up: the install panel should be the *only* call to action,
the prompt body fully visible (no scroll), and the URLs prominent
inside it. Drop the `<details>` disclosure and its two CLI panels;
collapse the prompt to one intro line plus two `Label: URL` lines so
both endpoints are scannable at a glance.

Bumps `.install` max-width from 640px → 720px so the longer raw
GitHub URL fits on a single line at the panel's monospace font size.

Also drops the now-unused `InstallKind` / `INSTALL_COMMANDS` Record
indirection — only one thing is copyable, so `_onCopy()` takes no
argument and `copied` is a plain boolean.
@alextnetto alextnetto merged commit 8032b89 into main May 11, 2026
3 checks passed
@alextnetto alextnetto deleted the feat/web-universal-agent-prompt branch May 11, 2026 01:23
Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: e6b0e0c933

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread apps/web/home.ts
Comment on lines +525 to 526
<pre class="install-body is-prompt"><code>${AGENT_PROMPT}</code></pre>
</div>
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Keep a manual install path alongside the agent prompt

This change leaves the landing page with only a prompt-to-agent flow (AGENT_PROMPT) and removes any directly runnable install commands from the UI, which blocks onboarding for users whose agent cannot edit MCP config automatically (for example read-only or approval-gated clients). In those environments, users now have no actionable fallback on the page, so installation can fail even though the MCP endpoint is available.

Useful? React with 👍 / 👎.

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant