Skip to main content

​
Coding-agent integrations

Use AgentUse from Codex, Claude Code, or Pi to turn a workflow in your current conversation into a reusable .agentuse file. The integration helps define the agent, prepare its runtime, and validate it before its first real run.

​
Choose a release

Starting with v0.21.0, GitHub Releases include four downloadable integration packages: Choose a published version and keep the extracted files in a persistent directory. The commands below use v0.21.0; they work once that release is published. They require curl and the appropriate archive tool (unzip or tar). Install your coding assistant first.
Follow one host’s instructions below. These are local installations from the release archives, so no source checkout or integration build is needed.

​
Codex

Start a new Codex task, then use:

​
Claude Code

Restart Claude Code, then run:

​
Pi

Start a new Pi session, then run:
The package is installed from the extracted release download. Keep that directory available while it is installed.

​
Portable Agent Skills archive

Download and extract the portable package:
Import the resulting portable/automate directory through your host’s skill installer, or copy it into that host’s supported skills directory. Keep the whole directory, including references, together. Restart the host if required and ask it to use the automate skill.

​
Validate and run the resulting agent

The integration first tries to load current AgentUse guidance through npx, then from an installed agentuse command. If neither is available, it can use the bundled guidance to draft a file. Running and validating that file requires the AgentUse CLI and a configured model provider. Review the generated source and setup requirements, then validate and test it:
See testing agents for test scope and limitations. Review the test output before a real run or enabling a schedule.

​
Updates and local development

Release downloads stay at the version you installed. To move to another release, remove the old integration through your host’s plugin or package manager, download the new archives into a separate version directory, and repeat the installation. For Codex and Claude Code, also remove the old agentuse-release marketplace registration before adding its replacement. Contributors can run bun run integrations:build in the AgentUse repository. The generated local-development marketplaces use agentuse-development; their installation commands are in the repository’s integrations READMEs.