Skip to main content

​
What “Connect your agent” does

IMP can serve skills to a local coding agent — Claude Code, OpenCode, and others — so the agent can install them into its local toolchain. The “Connect your agent” dialog gives you a single shell command that points the agent at your IMP instance.
When the command runs, the agent asks you:
  • Which clients to install into (Claude Code, OpenCode, and others that are detected on your machine)
  • Whether to share one copy of the skill files across clients via symlinks (saves disk space when you use multiple agents)
You need an API key to authenticate. Create one on the API keys page (/keys, in the Develop sidebar group) before running the command.

​
Opening the dialog

From the skills list (/skills), click Connect your agent in the top-right area of the toolbar. The Connect your agent dialog opens.

​
The install command

The dialog shows the install command in a monospace code block:
The URL is your IMP instance’s origin — whatever domain or hostname your organization uses. The dialog derives this from window.location.origin client-side, so it always shows the correct URL for the instance you are logged into. Click the Copy command button (or the copy icon next to the code block) to put the command on your clipboard.
The install script is served from your own IMP instance, not from a third-party server. Inspect /api/skills/install.sh in your browser if you want to review it before running.

​
Run the command

1

Copy the command

Open the Connect your agent dialog and click Copy command.
2

Open your terminal

Open a terminal in your development environment — the same machine where your coding agent (Claude Code, OpenCode, etc.) is installed.
3

Paste and run

Paste the command and press Enter. The script downloads and runs the IMP skill installer.
4

Follow the prompts

The installer asks which client(s) to target and whether to use symlinks. Provide your API key when prompted.
After the installer finishes, the skill or skills you selected are available to the coding agent as MCP tools or context files, depending on the client.

​
API key

The install script requires an API key to authenticate against your IMP instance. Create a dedicated key on the API keys page (/keys in the Develop sidebar group):
  1. Navigate to API keys in the sidebar.
  2. Click Create key, give it a name (e.g. “Claude Code”), choose the Agents scope, and select the agents this key may access.
  3. Copy the key immediately — it is shown only once.
Paste the key into the installer prompt when asked.
The installer’s prompt mentions /token (your personal token). That also works but ties the agent to your personal session. A dedicated org API key from the API keys page is recommended so you can revoke the agent’s access independently.

​
Next steps

Skills overview

Browse, create, and manage skill packages.

Editing and versions

Edit skill files and save version snapshots.