publish
Publish an agent's resolvable set — current cards, certificate chain, revocations — to the attached Hub so it resolves over the network.
Usage
treeship publish <agent-uri>Requires an attached hub connection (treeship hub attach); there is no --hub flag — the active connection is used.
What gets pushed
Everything a remote verifier needs to run resolve --hub with client-side verdicts:
- Capability cards —
agent_card.v1receipts for the agent. - Certificate chain — the
agent_cert.v1binding the agent's URI to its key, so a counterparty who pinned only your ship key (--kind cert_issuer) can verify the card via the chain walk. - Revocations — any
agent_card_revocation.v1referencing the pushed cards. Revocations are always included, never filtered; the verifier judges their authority.
treeship publish agent://deployer✓ agent published
agent: agent://deployer
artifacts: 3If nothing matches, it warns nothing to publish and points you at treeship attest card.
To also anchor the published set to the transparency log in one step, prefer treeship onboard <agent> --publish, which runs checkpoint + publish together.
Notes
- Publishing is push-only convenience: artifact validity never depends on it, and the Hub grades nothing.
- Counterparties resolve with
treeship resolve <agent> --hub <url>and audit withtreeship audit. - No JSON output shape yet — in
--format jsonmode the command emits nothing on success (exit code is the signal).
resolve
Resolve an agent URI to a verifiable bundle — identity, current card, revocations, provenance grades — re-derived from artifacts, never from a stored verdict.
audit
Audit an agent's transparency log from a Hub — re-verify every anchored entry's inclusion offline, check completeness against the committed anchor, and detect forks, regressions, and rewrites.