Supported Tools
What You Need
- Velatir for Desktop 0.27.0 or later on the devices. See Download and install.
- The Administrator role in your Velatir organisation, to change the settings. See Roles & permissions.
- An agent in the Enforcer role on the workspace, such as Data Protector, if you want prompts blocked. Without one, prompts are recorded and reviewed, but nothing is blocked.
Turn It On
Open Desktop coverage
Open Setup in the dashboard and find the Desktop coverage card.
Switch on AI tool coverage
Turn on AI tool coverage. It is off until you turn it on.
Choose the tools
Tick the tools to cover: Claude Code, Codex, and Cursor. All three are ticked by default. The choice applies to every device in your organisation.
What People See
- A blocked prompt is not sent. The tool shows that the prompt was blocked, and a Prompt blocked notification names the agent and its reason, in the person’s own language.
- Sessions already running need a restart. Claude Code and Codex read their hooks when a session starts, so a session that was open before coverage reached the device is not checked. Velatir shows a notification asking the person to restart it. Cursor picks the change up straight away.
- Everything else works as before. A prompt that passes the check is sent as usual.
Block If the Check Fails
By default, a prompt goes through when Velatir cannot check it, for example when the device is offline or Velatir is not running. Turn on Block if the check fails, under AI tool coverage, to block it instead. The person then sees Velatir could not evaluate this request. This setting only applies on workspaces whose Data Protector is an Enforcer. Elsewhere, prompts that cannot be checked always go through. A prompt too large to check is blocked whichever way this is set, so padding a prompt cannot get it past Velatir.Tool Calls
Velatir records each tool call the assistant makes, such as running a command or editing a file, with the tool’s name and how long it took. Tool calls are recorded, not checked: an agent cannot block one. Whether the tool call’s input and output are kept follows your Store trace data in sessions setting. See Data privacy.
With your own encryption key, only the tool’s name and timing are kept.
Subscriptions
Velatir for Desktop reads which plan each tool is signed in to and sends it with every prompt. Gatekeeper subscription rules therefore apply to Claude Code, Codex, and Cursor as they do in the browser: while Gatekeeper is an Enforcer, a prompt sent from a subscription you do not allow is blocked. When the plan cannot be identified, nothing is blocked.Limits
Hooks are not a security boundary
Hooks are not a security boundary
Someone with administrator rights on the device can remove Velatir’s hooks. A tool run inside a container or under another user account is not covered.
Claude Code before a folder is trusted
Claude Code before a folder is trusted
Claude Code runs no hooks in a folder until the person accepts its trust prompt. Prompts sent before that are not checked.
Tools in an elevated terminal on Windows
Tools in an elevated terminal on Windows
A tool started from a terminal running as administrator cannot reach Velatir. Its prompts go through, or are blocked when Block if the check fails is on.
Cursor and personal hooks
Cursor and personal hooks
Cursor lets a person add hooks of their own, and those can override Velatir’s answer. Cursor coverage is therefore not as firm as Claude Code’s and Codex’s, where Velatir’s hooks take precedence.
Data Protector
What Data Protector checks for and how it blocks.
How it works
Everything else Velatir for Desktop does on the device.