From e2310618202f60535c74aad516f7f8881770411a Mon Sep 17 00:00:00 2001 From: hermes Date: Thu, 15 Oct 2026 04:43:52 +0000 Subject: [PATCH] docs(web): agent-led install prompt and agents/install.md Co-Authored-By: Claude Opus 5.5 --- web/DESIGN.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/web/DESIGN.md b/web/DESIGN.md index 72b1444..8d17664 100644 --- a/web/DESIGN.md +++ b/web/DESIGN.md @@ -40,6 +40,7 @@ Non-goals: a blog, a hosted API, live market data on the site, user accounts. /mcp/setup one tab per client (see below) /mcp/tools generated: the 11 tools (plus opt-in ownership_sync) /agents using idx from an agent: contract, recipes, skill file +/agents/install.md instructions an agent follows to install and register idx /about data sources, freshness, disclaimer, license /llms.txt, /llms-full.txt generated ``` @@ -125,6 +126,23 @@ site. The site becomes the one place for user docs. ## Agent features +- **Agent-led install.** The landing install tabs end with "Ask your agent", + and the MCP setup page opens with the same box: a one-line prompt to paste + into any coding agent: + + > Install idx-cli and its MCP server for me by following + > https://idx.rasyidanaf.com/agents/install.md, then show me that it works. + + The prompt stays short and stable; the instructions live in + `/agents/install.md`, served as plain Markdown. That file tells the agent + to: detect OS and architecture; pick npm, the install script or Cargo + (no sudo); confirm with `idx --version`; work out which harness it is + running in and register `idx-mcp` with that harness's config from the + setup tabs; ask before editing global config; run `idx ownership sync`; + and finish with a test call (`get_shareholders BBCA`) reported back to the + user. `tests/agents/agent-smoke.sh` gains a case that runs this prompt + against each agent in a throwaway home, so the instructions stay working. + - `/llms.txt` (index) and `/llms-full.txt` (all docs in one file), from the `starlight-llms-txt` plugin. - Every page also served as `.md`, and a "Copy as Markdown" button.