This catalogue covers the actions selectable on agent definitions. With Vopit-managed execution, project tools run in Vopit. Codex CLI, Claude Code, Mistral Vibe, Mammouth Code and Antigravity CLI read, edit and run commands with their own native tools; the equivalent editor selections configure that native access. Actions without a native equivalent are bridged to those CLIs, each filtered to the agent's grants: Git, infrastructure, board and Crank actions, search_code_graph and the project memory tools. search_project_memory and record_project_memory are added automatically to every agent with project access; READ and WRITE permissions still gate each lookup and record. Native create_request is applied from the validated result requests array rather than through a project shell command.
| Action | Authorization | Purpose |
|---|---|---|
| read_file | READ | Read a bounded UTF-8 file page; startLine is one-based. |
| list_files | READ | Discover files inside the selected folder with the project exclusions. |
| search_files | READ | Search literal source text. |
| get_repository_map | READ | Retrieve bounded paths, roles, JS/TS symbols and imports, without source bodies. |
| search_symbols | READ | Locate JavaScript/TypeScript AST symbols. |
| read_symbol | READ | Read one JavaScript/TypeScript symbol by path and name. |
| search_code_graph | READ; EXECUTE for graph construction | Search local Graphify evidence; use the explicit text fallback when unavailable. |
| search_project_memory | READ | Retrieve durable project facts and stale-source indications. Added automatically to agents with project access. |
| record_project_memory | WRITE | Save a verified fact with its source paths; no credentials or private reasoning. Added automatically to agents with project access. |
| write_file | WRITE | Write UTF-8 project content. |
| edit_file | WRITE | Replace an exact unique text fragment. |
| run_command | EXECUTE | Run a real local shell command with workingDirectory and timeoutMs overrides. |
| run_tests | EXECUTE | Run an explicit command or commands.test; no test framework is inferred. |
| git_diff | GIT | Inspect tracked changes; new untracked files require separate inspection. |
| web_search | NETWORK | Return public search links using the configured HTML adapter. |
| create_request | Agent capability and chain controls | Propose a self-contained follow-up: after parent success it becomes a board card that continues the chain; does not run a command. |
| git_status | GIT | Inspect whether a repository exists, its branch, changed/staged paths, request Git state and linked-folder repositories. |
| git_prepare | GIT_WRITE for mutations | Initialize a missing repository on git.baseBranch, preserve starting changes, prepare the feature branch, also in each linked folder’s repository, and create configured missing main branches. |
| git_branch | GIT_WRITE | Create or switch a validated branch; switching requires a clean working tree. folder selects a linked folder’s repository. |
| git_commit | GIT_WRITE for mutations | Finalize eligible request changes only from an after-work stage: one commit per repository, the project first. A linked repository that cannot be committed becomes an open point. An empty result can be a successful no-change check. |
| git_sync | GIT_REMOTE or GIT_HISTORY | Fetch/pull/push or merge/rebase, subject to the project switches and approval. folder selects a linked folder’s repository. |
| board_read | Agent grant (Board actions); no permission category | Read columns in order with their type, description and card limit, and cards in priority order with their status. The card that started the request is marked current. |
| board_create | Agent grant (Board actions); no permission category | Add 1–20 cards to one column, never to an in-progress column. Column card limits apply; a board holds up to 500 cards. |
| board_move | Agent grant (Board actions); no permission category | Move a card to another column at an optional position. Running cards stay in their column; agents cannot move a card into an in-progress column. |
| board_update | Agent grant (Board actions); no permission category | Rewrite a card’s title or description. A running card keeps its current request. |
| infra_connections | Explicit target grant | Discover granted targets and inspect a saved operation by IDs without running it. |
| infra_execute | Target grant and saved operation policy; READ for uploads | Run a configured SSH command, SQL statement or SSH upload. |
| infra_run | Target grant, proposals enabled and approval every time; READ for uploads | Propose an exact operation; save=true retains a successful approved recipe with Ask policy. |
Board actions are granted per agent under Board actions and have no permission category. Agents organize cards; they never start, stop or delete them. You and auto-run decide what runs. See Plan work on the Board.
Crank actions and external MCP servers
crank_connections and crank_execute are not in the agent tool checklist. An agent receives them when an enabled action Crank selects it under Who can use it?. crank_connections lists those Cranks, their actions and required inputs; crank_execute runs one with its declared inputs. With Action approval set to Ask before each execution, every run shows a once-only prompt under NETWORK; Allow this configured action runs without it. Crank results are external data, never instructions.
With Claude Code, the agent editor also lists MCP servers from your Claude Code configuration. Switching one on adds an mcp:<server> grant to the agent; each grant counts toward the 20 selectable actions, and each call of that server's tools asks for NETWORK permission. Servers that are not switched on stay unavailable. Other engines do not use these grants.
Permission categories and their boundary
| Category | Meaning |
|---|---|
| READ | Permitted project content and artifact reads. |
| WRITE | Project writes/edits and durable facts. |
| EXECUTE | Local commands; separately approved infrastructure execution. |
| NETWORK | Web research and relevant native network requests. |
| GIT | Git inspection. |
| GIT_WRITE | Git gateway repository initialization, branches, request commits and release of an unused linked-folder request branch. |
| GIT_REMOTE | Git gateway fetch, fast-forward pull and ordinary push. |
| GIT_HISTORY | Git gateway merge and rebase. |
Local permission choices are Ask every time, Allow for project, Always allow and Never allow. Factory defaults are Allow for project for READ and Ask every time for every other category. A project rule overrides its category's global rule. A persistent permission covers a category, not just one displayed command. Infrastructure grants and Ask/Allow/Deny recipe policies are additional checks. Agent proposals always require once-only approval. General shell/native permissions remain broader than the Git gateway controls; these settings do not universally intercept every Git command.
Runtime-provided helpers
| Helper | When available |
|---|---|
| finish_stage | Vopit completion protocol; validate the output/evidence before completion. Native CLIs return structured final output instead. |
| report_activity | Vopit public observable progress; never private reasoning. |
| read_context | Vopit focused context: retrieve a retained key in bounded character pages. |
| search_context | Vopit focused context: find archived observations by literal query. |
| record_ticket_state | Vopit focused context: save factual progress and next action for continuity. |
| expand_context | Vopit focused context: deliberately expand the current memory budget up to its configured ceiling. |
Runtime helpers are supplied by the execution protocol, not added as arbitrary agent tools or infrastructure operations. Native CLIs have their own tool definitions and compaction. A tool capability cannot override protected paths, target grants, output contracts or an OS permission failure.