Author
Author and publish
Scan a repo, compose a plugin, pack a bundle, and publish it to a HarnessTap Cloud catalog.
You're here because you want to author a plugin others can apply. This is the producer ramp.
The producer ladder
Four steps, in order. Each links to the page that owns it:
| # | Step | What success looks like |
|---|---|---|
| 1 | Scan | ht scan . imports existing harness files into the local library |
| 2 | Compose | plugin create / plugin edit / plugin from-project builds an authored plugin |
| 3 | Pack | ht pack writes an Agent Plugins bundle (plugin.json, primitives, embedded apm.lock.yaml) |
| 4 | Publish | plugin publish uploads an immutable version to a Cloud catalog |
You don't need Cloud to start. Scan and compose stay local. Pack is enough for a teammate's laptop; publish is for catalog discovery.
Where to start
| Your situation | Start here |
|---|---|
| First time — want a working plugin end-to-end | Scan, then compose |
| Existing harness files in a repo | Scan |
| Resources already in the library | Compose |
| Need a file to hand someone offline | Pack |
| Ready for the org catalog | Publish |
Compatible with the consumer ramp
Every plugin you publish here applies through the consumer ramp's ht apply command. Test that loop yourself: apply your plugin in a scratch repo before declaring it shipped.