Intelligence and reviews

Putnami Intelligence gives an entitled workspace subscription reviews of immutable pull-request heads, shared audit attestations, signed provenance receipts, and a readiness report for the code index that reviews read.

putnami cloud setup links the workspace; the /audit skill ships as @putnami/intelligence agent content. putnami intelligence setup reports whether the code index can answer for the linked workspace. Availability is still discovered from the linked workspace's subscription on every hosted call; a local flag cannot grant entitlement.

Every hosted call also checks your role on the workspace it acts on. Audit lookups and provenance lookups need intelligence.index.read. Recording an audit attestation or a provenance receipt needs delivery.run.submit. A workspace member or admin holds both; a workspace viewer holds neither and reads review status only. A workspace key acts only in its own workspace, and never on reviews. A key you own as a person holds no role, so it is refused.

Check review readiness

Use the workspace-scoped doctor before launching a review:

putnami intelligence review doctor --workspace <workspace-id>

Doctor and review status need intelligence.review.read on the workspace you name. Review mutations need intelligence.review.manage there; commands that create or revoke worker keys also need workspace.manage.

Launch and inspect a review

A review is tied to an exact PR head. Pass the immutable head SHA and record an audit reason:

putnami intelligence review launch \
  --workspace <workspace-id> \
  --pr <number> \
  --head <sha> \
  --reason "review before merge"

putnami intelligence review status \
  --workspace <workspace-id> \
  --review-key <review-key>

Use --issues <n,n> on launch to attach explicit issue numbers. Pause, resume, and reconcile are workspace operations and require --reason. Cancellation also requires the immutable review key and --confirm:

putnami intelligence review cancel \
  --workspace <workspace-id> \
  --review-key <review-key> \
  --reason "superseded head" \
  --confirm

Run a workspace worker

Self-hosted review execution is an advanced path. worker run enrolls an ephemeral key, passes it privately to the separate review worker, and revokes the key when the process exits:

putnami intelligence review worker run \
  --workspace <workspace-id> \
  --once \
  --pull

--pull fetches only absent images pinned by digest. Use --engine codex|claude-code to select the review engine.

Owner credentials are imported from an independently obtained official subscription artifact over standard input:

putnami intelligence review auth login codex --stdin

The CLI does not launch vendor OAuth. Use auth status to inspect custody and auth replace or auth revoke with the expected generation for concurrent change protection.

Next