asiri field guide
operate / setupsasiri:smol
raw .md

setups

Choose how you approve requests and which identity each agent uses. All setups start with a vault and an owner profile from getting started.

a person in a terminal

Run asiri run from your own terminal. If Rex is available, it handles approval. Otherwise an interactive terminal can ask directly.

asiri run --env GH_TOKEN=asiri://dev/github \
  --reason "check my account" -- gh api user --jq .login

Return allows once. In the terminal prompt, f allows 15 minutes, h allows an hour, and d denies, subject to the secret's policy.

an agent with Rex

Install Rex support as the owner:

asiri rex install

Create a separate client identity for the agent:

asiri clients add claude

Use the code it prints to pair the agent profile:

asiri pair --profile claude --code CODE
ASIRI_PROFILE=claude asiri ls

Set ASIRI_PROFILE=claude in the agent process's environment. For example, if you use Claude Code, launch it from that environment:

ASIRI_PROFILE=claude claude

This selects the profile. It is not an operating-system sandbox. Keep owner credentials outside the agent's reach, especially when it can read arbitrary files as your user.

give the agent the instructions

The agent skill explains the secret-reference workflow. The “copy page as markdown” action on each documentation page copies that page's source for your agent.

Provide the skill and the relevant documentation page. Never include a token, password, private key, or pairing code in a shared conversation.

an agent without Rex

The same agent profile works without Rex. Leave the agent request waiting. In a separate owner terminal, inspect and answer it:

asiri pending
asiri approve ID

Use asiri deny ID to refuse. Do not run the approval command through the agent profile or give the agent owner access to make the prompt disappear.

git and SSH tools

First create a host-bound SSH key as described in CLI usage. Start the socket service in one terminal:

asiri ssh-agent

In the terminal where you use Git or rsync, point OpenSSH at the socket:

export SSH_AUTH_SOCK=~/.asiri/agent.sock
git push

Only allowed hosts can use the key. The server signs the SSH login without sending the private key to the client. Agent forwarding, ssh-add, and non-login signatures are refused.

remove an agent's access

Inspect the client list and revoke the client by name:

asiri clients ls
asiri clients revoke claude
asiri revoke --all

The last command also revokes other clients' grants and denies pending requests. Use it only when you intend that wider effect. It does not undo commands that already ran.