/** * Setup/auth block for the `/visual-plan` skill. Interpolated into * `VISUAL_PLANS_SKILL_MD` below so the install + one-step authenticate * instructions are single-sourced. The materialized SKILL.md copies under * `templates/plan/.agents/skills/*`, top-level `skills/*`, and * `.agents/skills/*` are guarded byte-identical by `skills.sync.spec.ts`. */ export declare const PLAN_SETUP_AUTH_MD = "## Setup & Authentication\n\nThere are two ways into Plans.\n\n**Coding agent (CLI).** Install once with the Agent-Native CLI. The command\ninstalls the Plans skills, registers the hosted Plans MCP connector, and runs\nauth/setup for the selected local client(s) in the same step (a one-time browser\nsign-in at setup \u2014 this is intended), so the first tool call in that client does\nnot hit an OAuth wall:\n\n```bash\nnpx @agent-native/core@latest skills add visual-plans\n```\n\nAfter that, `/visual-plan`, `/visual-recap`, and `/visualize-repo` are the\ninstalled slash commands. If you only need one command, use\n`skills add visual-plan`, `skills add visual-recap`, or\n`skills add visualize-repo` instead. The other planning modes\n(`create-ui-plan`, `create-prototype-plan`, `create-plan-design`,\n`create-visual-questions`) are MCP tools reachable from `/visual-plan`, not\nseparate slash commands. Pass `--no-connect` to register the connector without\nauthenticating, then run\n`npx @agent-native/core@latest connect https://plan.agent-native.com --client all`\nwhenever you are ready, or choose a narrower `--client`. Auth and MCP tool\nloading are per client config/session.\n\n**Local-only / text installs.** If the user wants no sharing and all local files,\ninstall with `--mode local-files`:\n\n```bash\nnpx @agent-native/core@latest skills add visual-plans --mode local-files\n```\n\nThis mode does not register the Plan MCP connector. Before authoring structured\nMDX, fetch the no-auth, schema-only block catalog with\n`npx @agent-native/core@latest plan blocks --out plan-blocks.md`, read that file,\nwrite the MDX folder locally, run `plan local check`, then run `plan local serve`.\nFor repo-wide visual docs, run\n`npx @agent-native/core@latest visualize-repo --open` to create/update\n`agent-native.json`, seed `.agent-native/visual-docs/repo-overview`, and open\nthe local bridge.\nPlain text skill\ninstalls (Vercel Skills CLI, copied GitHub files, etc.) can follow that same\nlocal flow if `@agent-native/core` is available. Text alone cannot register\nMCP tools; hosted/shareable Plans still need the Agent-Native CLI\ninstall/reconnect step above.\n\n**Browser (people you share with).** Open the Plans editor and create & edit\nwith no sign-up \u2014 you work as a guest. Sign in only when you want to save or\nshare; signing in claims the plans you made as a guest into your account.\n\nSharing and commenting require an account: public/shared plans are viewable by\nanyone with the link, but commenting on them needs an agent-native account.\n\nFor no-account, no-DB plan storage, use local-files mode and the local bridge\ncommand. The optional `plan blocks` lookup reads only public schema metadata.\nIf network access is unavailable, use the bundled references and a local Plan\napp/runtime for validation.\n\nIf a Plans tool returns `needs auth`, `Unauthorized`, or `Session terminated`,\ndo not keep retrying the tool. Stop and give the user the reconnect step for the\nclient they are using: Codex/Codex Desktop should run\n`npx -y @agent-native/core@latest reconnect https://plan.agent-native.com --client codex`\nand start a new Codex session; Claude Code should run `/mcp` and choose\nAuthenticate/Reconnect for the plan connector, or run the reconnect command with\n`--client claude-code` and restart Claude. To refresh every local client config\nthat already has the Plan entry, use `--client all`, then restart/reload each\nclient. Reconnect re-authenticates WITHOUT reinstalling and finds the entry by\nURL regardless of connector name. Never reinstall from scratch just to fix auth.\nContinue once the connector is available.\n\nHosted default: connect `https://plan.agent-native.com/mcp`. Do\nnot put shared secrets in skill files."; //# sourceMappingURL=plan-setup-auth.d.ts.map