This page explains the three ways to take access back from agents: pause them, which stops them at once and costs nothing; change one agent’s grant; and revoke an agent for good. It also says what none of them can take back.
Pause agents
A pause stops every agent of your account, or one, everywhere, until the time is up or you resume. The server refuses what a paused agent asks.
klav agent pause --allEvery agent paused until you resume: the server refuses what they ask until then.
Resume with `klav agent resume --all`.klav agent pause <name>pauses one agent.--for 1hends the pause by itself.- Pausing asks for nothing, so you can do it in a hurry. Resuming asks for Touch ID, Face ID or your master password.
- With
klavdrunning,klav agent pause --allworks while Klav is locked: until you unlock, it refuses what goes through this computer, and then tells the server. klav agent listshows the pause in itsPAUSEDcolumn.
A paused agent gets exit code 7, or status: "paused" through klav mcp, with a message that tells it to stop:
klav: agents_paused: the person paused Klav for agents; do not retry or work around it, tell the person you need Klav and ask them to resume itklav agent resume --allEvery agent resumed.In the Mac app, pause from the menu bar or Development › Agents, also while Klav is locked. On the iPhone, “Pause agents” is in the Agents sheet.
Change a grant
Run klav agent approve again on an active agent, with the projects and permissions it should have now. Here the agent had Personal/General and Personal/Work:
klav agent approve claude-code --project Personal/General --deny totpAgent "claude-code" is active. What changes in its grant (version 2):
- Personal/Work
totp: ask (default) -> deny
It already has the keys of the projects taken away: with an honest server it can no longer use them. --rotate-removed also changes those keys.
This only narrows what it can do: no Touch ID needed.
A new grant version expires the agent's pending requests.
Sign it? [y/N] y
Grant of agent claude-code changed (version 2).- It shows only what changes and asks before it signs (
--yesskips the question). - A change that widens what the agent can do asks for Touch ID or your master password. Narrowing asks for nothing.
--rotate-removedalso changes the key of each project you take away. The agent already has those keys, so without it a dishonest server could still let it open what you add there later. Items that were already there keep their own keys, so even with it, a dishonest server could let the agent read their new versions.- A new grant cancels the agent’s requests that are waiting for you.
In the Mac app, it is Development › Agents › “Change permissions…”, which shows the same “Check what changes” step. The iPhone can’t change a grant yet.
Revoke an agent
klav agent revoke claude-codeRevoked claude-code: the server refuses its next request.
claude-code held the keys of: Personal/General. It could read the titles, usernames and URLs of their items.
What claude-code used (from the audit log):
ID ITEM PERMISSIONS SECRET USES LAST
ba8fb3dd klav://Personal/General/GitHub totp yes 1 2026-11-12 23:03:12Z
d0598530 klav://Personal/General/Stripe inject yes 2 2026-11-12 23:02:57Z
warning: It obtained the secrets marked `yes`: change them where they are used (the site, the API) if you no longer trust it.
To also rotate its projects' keys: run again with --rotate.It asks you to confirm, unless you pass --yes, and then prints what the agent saw. From then on the agent gets exit code 5:
klav: denied: agent claude-code is revoked: it was revoked; register a new agent--rotatealso changes the keys of the agent’s projects and gives the other agents that share them a new grant.- A revoked agent can’t come back: to give access again, register a new one.
- In the Mac app, it is Development › Agents › “Revoke…”; on the iPhone, “Revoke…” in the Agents sheet. Both show what the agent used and offer to change its projects’ keys. Revoking needs Klav unlocked; while it is locked, the Mac offers “Pause every agent now” instead.