Docs
Quick start. The full reference lives in the substrate repo.
What is papercusp?
papercusp is an open standard for AI agent harnesses — the layer of plumbing around Claude / GPT / Gemini that defines roles, tools, scheduling, persistence, and observability.
A harness package is a tarball with a papercusp.json manifest declaring which roles exist, which models they prefer, what plugins they need, what schema they own. The substrate is a single open-source server that loads packages and runs them.
Install the CLI
npm install -g @papercusp/cli papercusp --version
Install a harness
Browse the marketplace, then install by name:
papercusp install coding-project papercusp install papercup-org
The CLI fetches the tarball from api.papercuspai.com, verifies the manifest, and registers the harness with your local substrate at ~/.papercusp/registry.json.
Run a harness
papercusp run coding-project --spec ./SPEC.md
Publish your own
From inside a harness directory containing papercusp.json:
papercusp publish --registry https://api.papercuspai.com
The CLI tars the directory, runs a secret-scrubber pass, then uploads. The marketplace rejects tarballs with hard-coded API keys, AWS credentials, etc.
More docs coming
Reference docs (capabilities, hooks, schema migrations, plugin SDK) are still being written. Until then, see the papercusp repo.