Publish your harness
to anpm
Build your own AI agent harness and deploy it with a single command.
This guide walks you through creating a harness and publishing it to the anpm registry.
0 Overview
anpm harnesses are AI agent packages installed into the .claude/ directory. They include skills, hooks, and config files. Anyone can install them with anpm install.
Harnesses follow Anthropic's .claude standard. Managed agent deployment is also supported.
Full flow to publish:
- 1Install anpm CLI and log in
- 2Create harness directory structure
- 3Write
anpm.yamlmanifest - 4Test locally
- 5Publish with
anpm publish
1 Prerequisites
Before you start, make sure you have:
- ✓anpm CLI installed (
npm install -g anpm-io) - ✓anpm account authenticated via
anpm login - ✓Slash commands connected via
anpm init - ✓Node.js 18+ (for dependency management)
2 Harness Structure
The default directory structure generated by anpm create. On install, files are placed inside the user's .claude/ directory.
Required Files
| File | Description |
|---|---|
anpm.yaml | Harness metadata, dependencies, and publish config |
skills/ | At least one skill file required |
README.md | Usage documentation (shown on the anpm registry page) |
3 Manifest File
anpm.yaml is the core config file for your harness. It defines the name, version, dependencies, and publish settings.
4 Test Locally
Before publishing, verify that your harness works correctly in a local environment.
Use anpm link to symlink your harness locally, then anpm run to test it in a live agent session before publishing.
5 Publish
Once your tests pass, deploy to the anpm registry with a single command.
Version Updates
After making changes, bump the version and republish in one step:
6 Visibility Options
Control who can install your harness via the visibility field in anpm.yaml.
| Visibility | Description | Use Case |
|---|---|---|
public | Anyone can install | Open-source agents |
private | Requires an access code to install | Paid or limited distribution |
internal | Organization members only | Internal team agents |
Private harnesses require an access code at install time.anpm install my-harness --code ABC123
7 Review Guidelines
Public harnesses go through automated review. Your harness must meet these criteria:
- ✓Valid manifest — all required fields in anpm.yaml are present
- ✓README included — with install instructions, usage, and examples
- ✓Skills work — verified via
anpm run - ✓Safe hooks — no malicious code or unauthorized data collection
- ✓Clear description — description matches actual functionality
- ✓License specified — open-source license or proprietary declaration
Reviews are automated and usually complete within minutes. If rejected, you'll receive specific feedback explaining what needs to be fixed.
Ready to publish?
Create your first harness and share it with the anpm community.
Start with anpm create →