Polylane Agent Plugin

A cross-agent plugin and collection of Agent Skills for working with Polylane — the agent-powered production operations platform: connect your clouds, repositories, and observability tools; detect, investigate, and remediate production issues.

Installing

These skills work with any agent that supports the Agent Skills standard, including Claude Code, Cursor, OpenAI Codex, OpenCode, and Pi.

Claude Code

Install using the plugin marketplace:

/plugin marketplace add coreplanelabs/skills
/plugin install polylane@polylane

Cursor

Install the Polylane plugin from the Cursor Marketplace once it is listed (this repo is the plugin — manifest in .cursor-plugin/), or add the MCP server directly:

Add to Cursor

Manual — add this to your mcp.json (project .cursor/mcp.json or global ~/.cursor/mcp.json):

{
  "mcpServers": {
    "polylane": {
      "type": "http",
      "url": "https://mcp.polylane.com/mcp"
    }
  }
}

The server uses OAuth 2.0 with dynamic client registration — on first use, Cursor opens your browser to sign in to Polylane and authorize the connection. No API keys or environment variables are needed.

The skills can also be added manually via Settings > Rules > Add Rule > Remote Rule (Github) with coreplanelabs/skills.

OpenAI Codex

Install the repository marketplace, then install the plugin:

codex plugin marketplace add coreplanelabs/skills --ref main
codex plugin add polylane@polylane

Restart the desktop app and start a new task so Codex loads the plugin's skills and MCP servers. The Codex package manifest is at .codex-plugin/plugin.json; the repository marketplace is at .agents/plugins/marketplace.json.

npx skills

Install using the npx skills CLI:

npx skills add https://github.com/coreplanelabs/skills

polylane setup

If you already have the Polylane CLI, it can wire your coding agents directly — installing the CLI skill and registering the MCP server:

polylane setup --agent claude --agent cursor

Clone / Copy

Clone this repo and copy the skill folders into the appropriate directory for your agent:

Agent	Skill Directory	Docs
Claude Code	~/.claude/skills/	docs
Cursor	~/.cursor/skills/	docs
OpenCode	~/.config/opencode/skills/	docs
OpenAI Codex	~/.codex/skills/	docs
Pi	~/.pi/agent/skills/	docs

Commands

Commands are user-invocable slash commands that you explicitly call. They ship in the Claude Code and Cursor plugins; Codex surfaces the same three workflows as starter prompts on the plugin.

Command	Description
/polylane:onboard	Set up Polylane — account, workspace, integrations, cloud accounts, and starter automations
/polylane:investigate	Investigate a production issue — logs, metrics, dependency graph, code, and recent changes
/polylane:build-automation	Author an automation — trigger, instructions, tools, actions, and destinations

Skills

Skills are contextual and auto-loaded based on your conversation. When a request matches a skill's triggers, the agent loads and applies the relevant skill to provide accurate, up-to-date guidance.

Skill	Useful for
polylane	The platform: connecting a stack, investigating production issues, checking production impact before shipping a change, the context graph, detection, remediation, REST API conventions, and the five-tool platform MCP with backend code execution
polylane-cli	The polylane CLI: auth, workspaces, investigating issues, querying services and logs, running agent tools, threads, and scripting patterns for agents
polylane-automations	Authoring automations: the full trigger / action / destination schema, templates, and safe-authoring checklist

MCP Servers

This plugin includes Polylane's remote MCP servers:

Server	URL	Purpose
polylane	https://mcp.polylane.com/mcp	Query the workspace: context graph, telemetry across connected providers, code, and the full REST API
polylane-docs	https://docs.polylane.com/mcp	Search and read the Polylane documentation

Tools (polylane server)

Tool	What it does
search	Find Polylane REST API operations and their schemas: tracked issues, investigation threads, context graph resources.
execute	Call the Polylane REST API: read tracked issues, investigation threads, and context graph resources.
searchTools	List the workspace's agent tools with their input schemas: live logs, metrics, traces, deployments, and the context graph.
runTool	Run an agent tool to read live production state. Read-only by default; writes require write access and a session opt-in.
runCode	Chain several agent tools in one TypeScript call for multi-step production investigations.
startMapping	Start or resume mapping the current repository into the workspace topology.
advanceMapping	Submit a mapping phase's results and receive the next directive; the final submission publishes the topology.
getMappingStatus	Read the mapping session's phase, next directive, and terminal payload. Read-only.

Resources

• Plugin docs — install steps for Claude Code, Cursor, and OpenAI Codex
• Polylane Documentation — model-readable; agent index at /llms.txt
• API Reference
• Agent setup prompt — hand this to any coding agent to onboard from scratch
• Polylane CLI

Publishing

This repository is the single source for the Polylane plugin in three directories. Each agent reads its own manifest:

Agent	Manifest	Directory
Claude Code	.claude-plugin/plugin.json + marketplace.json	Claude plugin directory
Cursor	.cursor-plugin/plugin.json	Cursor Marketplace
OpenAI Codex	.codex-plugin/plugin.json + .agents/plugins/marketplace.json	Codex plugin directory

The OpenAI listing copy, reviewer fixtures, test cases, release notes, and submission checklist live in submission/README.md.

Run scripts/validate.sh before opening a pull request. It parses every manifest, checks that mcp.json (read by Cursor) and .mcp.json (read by Claude Code and Codex) stay identical, and runs claude plugin validate --strict, Codex's bundled plugin and skill validators, and Cursor's official JSON schemas for whichever tools are installed.