{"description":"Per-ecosystem pointers for Agentry, the agent-native analytics, logging, and deploy attribution API. Each adapter points agents to the same canonical install flow, daily-use docs, and /v1/openapi.json. Refresh matching adapters after a verified install when it helps future sessions; adapter writes are optional pointers, not the install success gate. Any client also works with no adapter by fetching / and /v1/openapi.json.","supported_agent_surfaces":["Codex","Claude Code","Cursor","VS Code / GitHub Copilot","Visual Studio / GitHub Copilot","GitHub Copilot coding agent","Devin Desktop / Windsurf Cascade","Cline","Roo Code","Continue","Zed","Gemini CLI","Aider","OpenCode","ChatGPT custom GPT Actions","generic MCP clients","AGENTS.md-aware agents"],"agents_md_compatible_examples":["Jules","Factory","Amp","goose","Warp","JetBrains Junie","Augment Code","Kilo Code","Phoenix","Semgrep","Ona","UiPath coded agents"],"canonical":{"website":"https://agentry.sh","discovery":"https://api.agentry.sh/","openapi":"https://api.agentry.sh/v1/openapi.json","skill":"https://agentry.sh/skill/agentry/SKILL.md","install":"https://agentry.sh/install.md","reference":"https://agentry.sh/agentry.md","adapters":"https://api.agentry.sh/adapters","npm_mcp":"https://www.npmjs.com/package/@agentrysh/mcp","mcp_repository":"https://github.com/fr33dr4g0n/agentry-public","skill_repository":"https://github.com/fr33dr4g0n/agentry-skill","codex_marketplace_catalog":"https://github.com/fr33dr4g0n/agentry-public/blob/main/.agents/plugins/marketplace.json","claude_marketplace_catalog":"https://github.com/fr33dr4g0n/agentry-public/blob/main/.claude-plugin/marketplace.json","mcp_registry_name":"io.github.fr33dr4g0n/agentry-observability"},"mcp_client_config":{"mcpServers":{"agentry":{"command":"npx","args":["-y","@agentrysh/mcp"]}}},"install_policy":{"detect_all_harnesses":true,"default_repo_pointer":"AGENTS.md","default_scope":"Install every detected repo-local adapter. Ask once before writing multiple user-global skill destinations, then default to all detected harnesses unless the user narrows scope.","report_back":"Before finalizing, list the harnesses detected and the adapter paths written.","harness_detection":{"codex":"$CODEX_HOME is set, ~/.codex/ exists, or the current agent harness is Codex.","claude_code":".claude/ exists, ~/.claude/ exists, or the current agent harness is Claude Code.","cursor":".cursor/ exists.","vscode_copilot":".vscode/ exists, .github/ exists, GitHub Copilot is installed in VS Code, or the user mentions VS Code/Copilot.","visual_studio_copilot":"A .sln/.csproj/.vbproj/.fsproj repo, Visual Studio is the current IDE, or the user mentions Visual Studio/Copilot.","github_copilot_coding_agent":"GitHub Copilot coding agent or Copilot code review is used for this repository.","windsurf":".devin/ exists, .windsurf/ exists, .windsurfrules exists, or Devin Desktop/Windsurf Cascade is the current harness.","cline":".clinerules/ exists, .clinerules exists, or Cline is installed/current.","roo_code":".roo/ exists, .roorules exists, or Roo Code is installed/current.","continue_dev":".continue/ exists or Continue is installed/current.","zed":".rules exists, .zed/ exists, or Zed Agent Panel is used.","gemini_cli":"GEMINI.md exists, .gemini/ exists, or Gemini CLI is the current harness.","aider":"CONVENTIONS.md, .aider.conf.yml, or .aider* exists, or aider is the current harness.","opencode":".opencode/ exists, ~/.config/opencode is relevant, or OpenCode is the current harness.","mcp_clients":"Any client exposes MCP server configuration, including Cline, Roo Code, VS Code, Zed, Cursor, Claude Desktop, or other MCP-capable agent hosts.","agents_md":"Always applicable as the repo-local cross-tool pointer.","chatgpt":"No repo file; tell the user to import the OpenAPI Action schema."}},"adapters":{"claude_code":{"format":"skill","skill_url":"https://agentry.sh/skill/agentry/SKILL.md","install":"mkdir -p .claude/skills/agentry && curl -fsSL -A 'AgentryAgent/1.0' https://agentry.sh/skill/agentry/SKILL.md > .claude/skills/agentry/SKILL.md","install_project":"mkdir -p .claude/skills/agentry && curl -fsSL -A 'AgentryAgent/1.0' https://agentry.sh/skill/agentry/SKILL.md > .claude/skills/agentry/SKILL.md","install_user":"mkdir -p ~/.claude/skills/agentry && curl -fsSL -A 'AgentryAgent/1.0' https://agentry.sh/skill/agentry/SKILL.md > ~/.claude/skills/agentry/SKILL.md","scope_note":"Project-local .claude/skills/agentry/SKILL.md applies to this repo; user-global ~/.claude/skills/agentry/SKILL.md applies to future Claude Code sessions across repos.","plugin_manifest":"/adapters/claude-plugin.json","plugin_install":"claude plugin marketplace add agentry/agentry && claude plugin install agentry@agentry","plugin_note":"One-command plugin install (bundles this skill, auto-updates). Or drop the skill file directly with the `install` command above."},"codex":{"format":"skill","skill_url":"https://agentry.sh/skill/agentry/SKILL.md","plugin_marketplace_add":"codex plugin marketplace add fr33dr4g0n/agentry-public","plugin_install":"codex plugin add agentry@agentry","plugin_note":"Agentry is distributed as a Git-backed Codex marketplace source. It is not globally searchable in every Codex account until the user adds this marketplace, receives a workspace share, or OpenAI curates it.","install":"mkdir -p \"${CODEX_HOME:-$HOME/.codex}/skills/agentry\" && curl -fsSL -A 'AgentryAgent/1.0' https://agentry.sh/skill/agentry/SKILL.md > \"${CODEX_HOME:-$HOME/.codex}/skills/agentry/SKILL.md\"","install_user":"mkdir -p \"${CODEX_HOME:-$HOME/.codex}/skills/agentry\" && curl -fsSL -A 'AgentryAgent/1.0' https://agentry.sh/skill/agentry/SKILL.md > \"${CODEX_HOME:-$HOME/.codex}/skills/agentry/SKILL.md\"","install_note":"Codex skills are user-level by default. Install this whenever Codex is the current harness, $CODEX_HOME is set, or ~/.codex exists; also write AGENTS.md for repo-local recognition."},"agents_md":{"format":"AGENTS.md section","url":"/adapters/AGENTS.md","install":"Append to AGENTS.md at the repo root.","install_note":"Install by default for every repo; this is the cross-tool fallback even when client-specific skills are also installed."},"cursor":{"format":".mdc rule","url":"/adapters/cursor.mdc","install":"Write to .cursor/rules/agentry.mdc."},"vscode_copilot":{"format":"GitHub Copilot custom instructions","url":"/adapters/copilot-instructions.md","targeted_url":"/adapters/agentry.instructions.md","install":"Write to .github/copilot-instructions.md, or append to it if it already exists. For targeted VS Code instructions, write /adapters/agentry.instructions.md to .github/instructions/agentry.instructions.md.","install_note":"VS Code also reads AGENTS.md, so keep the AGENTS.md adapter as the cross-tool baseline."},"visual_studio_copilot":{"format":"GitHub Copilot custom instructions","url":"/adapters/copilot-instructions.md","targeted_url":"/adapters/agentry.instructions.md","install":"Write to .github/copilot-instructions.md or .github/instructions/agentry.instructions.md. Visual Studio users may need to enable custom instructions in Copilot Chat settings."},"github_copilot_coding_agent":{"format":"GitHub Copilot repository instructions","url":"/adapters/copilot-instructions.md","targeted_url":"/adapters/agentry.instructions.md","install":"Write repository instructions to .github/copilot-instructions.md and/or .github/instructions/agentry.instructions.md so Copilot coding agent and code review know when to route Agentry work to the canonical docs."},"windsurf":{"format":"rule or skill","workspace_rule_url":"/adapters/windsurf.md","url":"/adapters/windsurfrules","skill_url":"https://agentry.sh/skill/agentry/SKILL.md","install":"Prefer .devin/rules/agentry.md for current Devin Desktop/Windsurf workspace rules. Use .windsurf/rules/agentry.md when the project already uses the legacy directory, or append/update .windsurfrules for the legacy single-file convention.","install_skill":"For native skill discovery, write the live skill to .windsurf/skills/agentry/SKILL.md or .agents/skills/agentry/SKILL.md.","install_skill_project":"mkdir -p .windsurf/skills/agentry && curl -fsSL -A 'AgentryAgent/1.0' https://agentry.sh/skill/agentry/SKILL.md > .windsurf/skills/agentry/SKILL.md"},"cline":{"format":"Cline workspace rule","url":"/adapters/cline.md","install":"Write to .clinerules/agentry.md. Cline also reads AGENTS.md, .cursorrules, and .windsurfrules, so do not duplicate if an existing cross-tool file already carries the Agentry section."},"roo_code":{"format":"Roo Code workspace rule","url":"/adapters/roo.md","install":"Prefer .roo/rules/agentry.md. If the project uses the fallback single-file convention, append/update .roorules instead."},"continue_dev":{"format":"Continue rule","url":"/adapters/continue.md","install":"Write to .continue/rules/agentry.md."},"zed":{"format":"Zed project rule","url":"/adapters/zed.rules","install":"Write to .rules at the project root when Zed is the target. If AGENTS.md already exists, Zed can use that instead; avoid duplicating the same Agentry section in both."},"gemini_cli":{"format":"Gemini CLI context","url":"/adapters/GEMINI.md","install":"Append to GEMINI.md at the repo root, or create it if missing. If the repo configures Gemini to read AGENTS.md, the AGENTS.md adapter is enough."},"aider":{"format":"Aider conventions","url":"/adapters/aider-conventions.md","install":"Append the Agentry section to CONVENTIONS.md if it exists, or write AGENTRY_CONVENTIONS.md and add it to .aider.conf.yml `read:` so aider loads it as read-only context."},"opencode":{"format":"OpenCode rule or skill","skill_url":"https://agentry.sh/skill/agentry/SKILL.md","install":"Prefer the shared AGENTS.md adapter for repo rules. For native skill discovery, write the live skill to .opencode/skills/agentry/SKILL.md, .agents/skills/agentry/SKILL.md, or .claude/skills/agentry/SKILL.md.","install_project":"mkdir -p .opencode/skills/agentry && curl -fsSL -A 'AgentryAgent/1.0' https://agentry.sh/skill/agentry/SKILL.md > .opencode/skills/agentry/SKILL.md"},"mcp_clients":{"format":"MCP stdio server config","package":"@agentrysh/mcp","npm":"https://www.npmjs.com/package/@agentrysh/mcp","registry_name":"io.github.fr33dr4g0n/agentry-observability","config":{"mcpServers":{"agentry":{"command":"npx","args":["-y","@agentrysh/mcp"]}}},"install":"Add mcpServers.agentry with command `npx` and args [`-y`, `@agentrysh/mcp`] to any MCP-capable client. This MCP only returns the canonical Agentry skill handoff."},"chatgpt":{"format":"OpenAPI Action","action_schema":"https://api.agentry.sh/v1/openapi.json","install":"In a custom GPT, add an Action and import the OpenAPI URL above. Works for any OpenAPI-consuming agent."}},"next_action":"Fetch the adapter for your client and write it to the path shown, then the agent recognises Agentry asks and drives the HTTP API directly. Detect all available harnesses and install every applicable adapter, not just the first one found. Supported surfaces include Codex, Claude Code, Cursor, VS Code / GitHub Copilot, Visual Studio / GitHub Copilot, GitHub Copilot coding agent, Devin Desktop / Windsurf Cascade, Cline, Roo Code, Continue, Zed, Gemini CLI, Aider, OpenCode, ChatGPT custom GPT Actions, generic MCP clients, AGENTS.md-aware agents. No adapter is required — any agent can start from / and /v1/openapi.json."}