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" \
--confirmRun 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 --stdinThe 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.