The boundary

Hosted coordination. Local plaintext use.

The hosted service stores encrypted secret versions, wrapped data keys, device public keys, scope metadata, grants, envelope audit modes, revocation state, and audit records. The trusted runtime fetches encrypted bundles, unwraps keys locally, checks policy, and exposes the value only through the approved action.

Customer API traffic stays on your machine or infrastructure. It never routes through Asiri servers.

The Asiri CLI runtime showing local secret use through approved commands.
What the model is made of

Eight things, no more.

Asiri is a small set of primitives that repeat across every workflow. Once these click, the rest of the product is just configuration.

Human owner
Approves identity, devices, policy, and recovery. Agents can prepare setup, but humans anchor trust.
Trusted device
A local installation with its own keypair. Private keys stay on the device.
Envelope
A lower-case container like prod/asiri inside an explicit workspace. Sharing an envelope shares only its direct secrets.
Secret
An uppercase label like dev/openai/OPENAI_API_KEY, encrypted locally before upload.
Capability
A scoped action granted to an authenticated user or service account, with trusted-device and audit requirements.
Audit mode
An envelope-level setting. Buffered keeps the local workflow useful offline. Strict requires a durable control-plane ack before release.
Runtime action
Inject into a command, mount a temporary file, answer a broker request, or run a sidecar.
Audit trail
Records who used what, where, how, and why a request was allowed or denied. Values stay out of logs.
Capability path

Grant the action, then let the local runtime do the sensitive part.

  1. 01
    Name the secret
    A stable short path like dev/openai/OPENAI_API_KEY inside a named workspace — a handle humans, machines, and agents can all reference.
  2. 02
    Approve the device
    The human trusts the device and the scope. The private key stays local; the human owns trust and recovery.
  3. 03
    Authorize the identity
    A signed-in human or narrowly granted service account uses the trusted runtime. A label such as codex may describe the audit event but never changes access.
  4. 04
    Run locally
    The runtime appends the audit event first. Buffered release continues locally; strict release waits for a matching control-plane ack before the value is exposed.
Envelope audit modes

Local for ordinary work. Acked before release for critical work.

Audit mode belongs to the envelope, so teams can keep local development loose and make production or staging access visible to administrators before release. Child envelopes inherit their parent mode unless a child overrides it.

Strict mode is enforced after a trusted device has synced the policy. It covers Asiri-controlled access paths; a fully compromised trusted host is still outside the guarantee.

BufferedAppend encrypted local audit, release the secret, and sync when the control plane is reachable.
StrictAppend locally, upload the event, require a matching ack, then release the secret.
InheritanceA parent envelope mode applies recursively until a child envelope sets its own mode.
Admin valueSensitive agent, SSH, deploy, and production API use becomes visible before the value is handed to the runtime.
Next

The quickest proof is one command.

Add one development secret, run a local command as the authenticated identity, and inspect the audit line before expanding usage.