All pages
Developers · Appendix A
Agent tool catalog
Generated from the app's tool registry. Every tool here is available to the in-app agent and, over MCP, to any client you connect.
Generated from macos/Sources/Features/Agent/AgentToolName.swift and every
AgentToolRunner.Entry registration under macos/Sources — a feature that owns
its own tools registers them beside itself. Regenerate rather than hand-edit —
see README.
420 built-in tools — 198 classified WRITE (approval-gated by default), 222 classified READ (run silently under the default posture).
Plugin- and MCP-contributed tools are not listed here: they are registered at
runtime through AgentToolProvider and carry their own approval classification.
| Domain | Tools | WRITE | READ |
|---|---|---|---|
| Terminal & panes | 56 | 22 | 34 |
| Terminal intelligence | 6 | 1 | 5 |
| Filesystem & search | 13 | 5 | 8 |
| Git & GitHub | 12 | 3 | 9 |
| Code intelligence | 10 | 3 | 7 |
| Build, test & jobs | 7 | 4 | 3 |
| Browser | 144 | 76 | 68 |
| Web & network | 2 | 0 | 2 |
| OS & desktop | 34 | 19 | 15 |
| Remote & connections | 6 | 4 | 2 |
| Docker & containers | 13 | 8 | 5 |
| Ports | 10 | 5 | 5 |
| Projects & worktrees | 9 | 6 | 3 |
| Knowledge & collaboration | 47 | 10 | 37 |
| Orchestration | 13 | 8 | 5 |
| Automation & workflows | 26 | 18 | 8 |
| Safety & policy | 12 | 6 | 6 |
| Total | 420 | 198 | 222 |
Terminal & panes
| Tool | Class | Description |
|---|---|---|
read_terminal |
READ | Read terminal |
send_keys |
WRITE | Send keys |
terminal_press_enter |
WRITE | Press Enter in terminal |
terminal_press_key |
WRITE | Press key in terminal |
run_command |
WRITE | Run in terminal |
bash |
WRITE | Run (background) |
get_context |
READ | Get context |
list_tabs |
READ | List tabs |
list_all_tabs |
READ | List all tabs |
attach_to_tab |
WRITE | Attach to tab |
run_in_new_tab |
WRITE | Run in new tab |
open_tab |
WRITE | Open tab |
watch_terminal |
READ | Watch terminal |
wait_for_panes_idle |
READ | Wait for panes to finish |
spawn_and_read |
WRITE | Spawn tab & read |
run_in_pane |
WRITE | Run in pane |
queue_command |
WRITE | Queue command |
queue_list |
READ | List queued commands |
queue_clear |
WRITE | Clear command queue |
queue_run_next |
WRITE | Run next queued command |
queue_remove |
WRITE | Remove queued command |
queue_move |
WRITE | Reorder queued command |
prompt_queue_add |
READ | Queue prompt |
prompt_queue_list |
READ | List queued prompts |
prompt_queue_remove |
READ | Remove queued prompt |
split_pane |
WRITE | Split pane |
focus_split |
READ | Focus split |
equalize_splits |
READ | Equalize splits |
zoom_split |
READ | Zoom split |
list_panes |
READ | List panes |
list_split_presets |
READ | List split presets |
save_split_preset |
WRITE | Save split preset |
apply_split_preset |
WRITE | Apply split preset |
delete_split_preset |
WRITE | Delete split preset |
pipe_panes |
WRITE | Pipe between panes |
surface_set_metadata |
READ | Write pane metadata |
surface_get_metadata |
READ | Read pane metadata |
surface_clear_metadata |
READ | Clear pane metadata |
surface_set_title |
READ | Name pane |
surface_set_description |
READ | Describe pane |
surface_set_status |
READ | Set pane status |
surface_set_progress |
READ | Set pane progress |
surface_set_agent |
READ | Declare agent identity |
surface_set_claude_session |
READ | Record Claude session |
surface_raise_flag |
READ | Raise attention flag |
surface_lower_flag |
READ | Lower attention flag |
surface_suppress |
READ | Suppress pane signals |
surface_unsuppress |
READ | Resume pane signals |
surface_list |
READ | List panes with manifests |
events_tail |
READ | Read event log |
pane_spawn |
WRITE | Spawn child pane |
pane_send |
READ | Message a pane |
pane_recv |
READ | Read pane inbox |
pane_type |
WRITE | Type into a pane |
pane_title |
READ | Read/set a pane title |
pane_tree |
READ | Pane mesh topology |
Terminal intelligence
| Tool | Class | Description |
|---|---|---|
shell_state |
READ | Inspect shell state |
get_command_errors |
READ | Get command errors |
command_provenance |
READ | Command provenance |
command_stats |
READ | Command stats |
session_record |
READ | Record terminal session |
session_replay |
WRITE | Replay terminal session |
Filesystem & search
| Tool | Class | Description |
|---|---|---|
read_file |
READ | Read file |
write_file |
WRITE | Write file |
edit_file |
WRITE | Edit file |
list_dir |
READ | List directory |
file_download |
READ | Download file |
file_upload |
WRITE | Upload file |
glob |
READ | Glob |
search_files |
READ | Search files |
grep |
READ | Grep |
find_files |
READ | Find files |
code_search |
READ | Code search |
apply_patch |
WRITE | Apply patch |
open_in_editor |
WRITE | Open in editor |
Git & GitHub
| Tool | Class | Description |
|---|---|---|
git_status |
READ | Git status |
git_diff |
READ | Git diff |
git_log |
READ | Git log |
git_blame |
READ | Git blame |
git_log_line |
READ | Git log (line) |
gh_pr_view |
READ | PR view |
gh_pr_diff |
READ | PR diff |
gh_pr_files |
READ | PR files |
gh_pr_comments |
READ | PR comments |
gh_pr_comment |
WRITE | PR comment |
gh_pr_create |
WRITE | Open PR |
gh_pr_merge |
WRITE | Merge PR |
Code intelligence
| Tool | Class | Description |
|---|---|---|
symbol_search |
READ | Symbol search |
ast_rename |
WRITE | Rename symbol |
lsp_goto_definition |
READ | Go to definition |
lsp_find_references |
READ | Find references |
lsp_hover |
READ | Hover |
lsp_diagnostics |
READ | Diagnostics |
notebook_read |
READ | Read notebook |
notebook_edit |
WRITE | Edit notebook |
figma_export |
WRITE | Figma export |
image_describe |
READ | Describe image |
Build, test & jobs
| Tool | Class | Description |
|---|---|---|
run_background_job |
WRITE | Submit background job |
list_background_jobs |
READ | List background jobs |
stop_background_job |
WRITE | Stop background job |
update_job_progress |
READ | Update job progress |
run_tests |
WRITE | Run tests |
xcodebuild |
WRITE | xcodebuild |
job_output_digest |
READ | Job output digest |
Browser
| Tool | Class | Description |
|---|---|---|
browser_state |
READ | Browser state |
browser_list_tabs |
READ | Browser list tabs |
browser_list_windows |
READ | Browser list windows |
browser_attach_tab |
READ | Browser attach tab |
browser_detach_tab |
READ | Browser detach tab |
browser_new_tab |
WRITE | Browser new tab |
browser_close_tab |
WRITE | Browser close tab |
browser_select_tab |
WRITE | Browser select tab |
browser_pin_tab |
READ | Browser pin tab |
browser_unpin_tab |
READ | Browser unpin tab |
browser_hibernate_tab |
WRITE | Browser hibernate tab |
browser_wake_tab |
WRITE | Browser wake tab |
browser_undo_close |
WRITE | Browser undo close |
browser_duplicate_tab |
WRITE | Browser duplicate tab |
browser_session_bucket_create |
WRITE | Browser session bucket create |
browser_session_bucket_list |
READ | Browser session bucket list |
browser_session_bucket_clone |
WRITE | Browser session bucket clone |
browser_session_bucket_set_expiry |
WRITE | Browser session bucket set expiry |
browser_session_bucket_export |
WRITE | Browser session bucket export |
browser_session_bucket_import |
WRITE | Browser session bucket import |
browser_navigate |
WRITE | Browser navigate |
browser_back |
WRITE | Browser back |
browser_forward |
WRITE | Browser forward |
browser_reload |
WRITE | Browser reload |
browser_eval_js |
WRITE | Browser eval JS |
browser_get_text |
READ | Browser get text |
browser_screenshot |
READ | Browser screenshot |
browser_console |
READ | Browser console |
browser_network |
READ | Browser network |
browser_wait_for |
READ | Browser wait for |
browser_click |
WRITE | Browser click |
browser_click_at |
WRITE | Browser click at point |
browser_type |
WRITE | Browser type |
browser_find |
READ | Browser find |
browser_reader_text |
READ | Browser reader text |
browser_dom |
READ | Browser DOM |
browser_key_press |
WRITE | Browser key press |
browser_key_chord |
WRITE | Browser key chord sequence |
browser_hover |
WRITE | Browser hover |
browser_drag |
WRITE | Browser drag |
browser_scroll |
READ | Browser scroll |
browser_upload |
WRITE | Browser upload |
browser_locator |
READ | Browser locator |
browser_frame_eval |
WRITE | Browser frame eval |
browser_shadow_query |
READ | Browser shadow query |
browser_cookies_get |
READ | Browser cookies get |
browser_cookies_set |
WRITE | Browser cookies set |
browser_cookies_delete |
WRITE | Browser cookies delete |
browser_storage_get |
READ | Browser storage get |
browser_storage_set |
WRITE | Browser storage set |
browser_viewport |
READ | Browser viewport |
browser_user_agent |
WRITE | Browser user agent |
browser_init_script |
WRITE | Browser init script |
browser_pdf |
READ | Browser PDF |
browser_a11y_tree |
READ | Browser a11y tree |
browser_mock_route |
WRITE | Browser mock route |
browser_mock_clear |
WRITE | Browser mock clear |
browser_block_route |
WRITE | Browser block route |
browser_form_fill |
WRITE | Browser form fill |
browser_select_option |
WRITE | Browser select option |
browser_touch |
WRITE | Browser touch |
browser_xpath |
READ | Browser XPath |
browser_query_all |
READ | Browser query all |
browser_outer_html |
READ | Browser outer HTML |
browser_describe_at |
READ | Browser describe at point |
browser_list_frames |
READ | Browser list frames |
browser_list_inputs |
READ | Browser list inputs |
browser_describe_locator |
READ | Browser describe locator |
browser_handle_acquire |
READ | Browser handle acquire |
browser_handle_eval |
WRITE | Browser handle eval |
browser_handle_release |
READ | Browser handle release |
browser_handle_list |
READ | Browser handle list |
browser_har_replay |
WRITE | Browser HAR replay |
browser_dialog_policy |
WRITE | Browser dialog policy |
browser_dialog_list |
READ | Browser dialog list |
browser_downloads_list |
READ | Browser downloads list |
browser_batch |
WRITE | Browser batch |
browser_action_save |
WRITE | Browser action save |
browser_action_list |
READ | Browser action list |
browser_action_run |
WRITE | Browser action run |
browser_action_delete |
WRITE | Browser action delete |
browser_action_record_start |
WRITE | Browser action record start |
browser_action_record_stop |
READ | Browser action record stop |
browser_session_save |
WRITE | Browser session save |
browser_session_list |
READ | Browser session list |
browser_session_restore |
WRITE | Browser session restore |
browser_session_delete |
WRITE | Browser session delete |
browser_lookup_credentials |
READ | Browser lookup credentials |
browser_autofill_credentials |
WRITE | Browser autofill credentials |
browser_emulate |
WRITE | Browser emulate |
browser_new_window |
WRITE | Browser new window |
browser_record_gif |
READ | Browser record GIF |
browser_expect |
READ | Browser expect |
browser_grant_permission |
WRITE | Browser grant permission |
browser_screenshot_all |
READ | Browser screenshot all |
browser_annotate_screenshot |
WRITE | Browser annotate screenshot |
browser_perf_record |
READ | Browser perf record |
browser_act |
WRITE | Browser act |
browser_assert_text |
READ | Browser assert text |
browser_assert_url |
READ | Browser assert URL |
browser_wait_for_idle |
READ | Browser wait for idle |
browser_console_clear |
READ | Browser console clear |
browser_ax_locate |
READ | Browser AX locate |
browser_inspect_at |
READ | Browser inspect at point |
browser_har_record_start |
READ | Browser HAR record start |
browser_har_record_stop |
READ | Browser HAR record stop |
browser_har_record_list |
READ | Browser HAR record list |
browser_har_diff |
READ | Browser HAR diff |
browser_replay_logged |
WRITE | Browser replay logged |
browser_prewarm_tab |
READ | Browser prewarm tab |
browser_drop |
WRITE | Browser drop |
browser_paste |
WRITE | Browser paste |
browser_set_clipboard |
WRITE | Browser set clipboard |
browser_geolocation_set |
WRITE | Browser geolocation set |
browser_timezone_set |
WRITE | Browser timezone set |
browser_offline |
WRITE | Browser offline |
browser_permission_grant |
WRITE | Browser permission grant |
browser_dialog_text |
READ | Browser dialog text |
browser_close_dialog |
WRITE | Browser close dialog |
browser_window_position |
WRITE | Browser window position |
browser_window_resize |
WRITE | Browser window resize |
browser_sessions_diff |
READ | Browser sessions diff |
browser_session_open |
WRITE | Browser session open |
browser_login_with |
WRITE | Browser login with account |
browser_form_submit |
WRITE | Browser form submit |
browser_extract |
READ | Browser extract |
browser_diff_navigate |
WRITE | Browser diff navigate |
browser_observe |
READ | Browser observe |
browser_repl |
WRITE | Browser REPL |
browser_step_through |
WRITE | Browser step through |
browser_until |
WRITE | Browser until |
browser_screenshot_compare |
READ | Browser screenshot compare |
browser_text_diff |
READ | Browser text diff |
browser_mock_list |
READ | Browser mock list |
browser_mock_reorder |
WRITE | Browser mock reorder |
browser_service_worker_bypass |
WRITE | Browser SW bypass |
browser_network_pattern_wait |
READ | Browser network pattern wait |
browser_screenshot_elements |
READ | Browser screenshot elements |
browser_visual_assert |
READ | Browser visual assert |
browser_record_video |
READ | Browser record video |
browser_codegen |
READ | Browser codegen |
browser_allowlist_list |
READ | Browser allowlist list |
browser_allowlist_add |
WRITE | Browser allowlist add |
browser_request_allowlist |
WRITE | Browser allowlist request |
Web & network
| Tool | Class | Description |
|---|---|---|
web_fetch |
READ | Fetch URL |
web_search |
READ | Web search |
OS & desktop
| Tool | Class | Description |
|---|---|---|
screenshot |
WRITE | Screenshot |
clipboard_read |
READ | Read clipboard |
clipboard_write |
WRITE | Write clipboard |
process_info |
READ | Process info |
activity_monitor |
READ | Activity monitor |
activity_history |
READ | Activity history |
activity_recording |
READ | Activity recording |
activity_period_save |
READ | Save activity period |
activity_period_list |
READ | List activity periods |
activity_period_delete |
WRITE | Delete activity period |
osa_exec |
WRITE | Run AppleScript |
app_list |
READ | List apps |
app_launch |
WRITE | Launch app |
app_activate |
WRITE | Activate app |
app_quit |
WRITE | Quit app |
app_hide |
WRITE | Hide app |
mouse_move |
WRITE | Move mouse |
mouse_click |
WRITE | Click mouse |
mouse_scroll |
WRITE | Scroll mouse |
key_type |
WRITE | Type text |
key_press |
WRITE | Press key combo |
ax_window_list |
READ | List windows (AX) |
ax_dump |
READ | Dump AX tree |
ax_action |
WRITE | AX action |
ax_set_value |
WRITE | AX set value |
screen_list_displays |
READ | List displays |
screen_capture_region |
WRITE | Capture screen region |
ax_find |
READ | Find AX element |
ax_wait_for |
READ | Wait for AX element |
ax_focused |
READ | Focused element |
ax_window_set |
WRITE | Move/resize window |
ax_menu_list |
READ | List menus |
ax_menu_invoke |
WRITE | Invoke menu item |
mouse_drag |
WRITE | Drag mouse |
Remote & connections
| Tool | Class | Description |
|---|---|---|
ssh_exec |
WRITE | Run on host |
sftp_read |
READ | Read remote file |
sftp_write |
WRITE | Write remote file |
port_forward_list |
READ | List port forwards |
port_forward_apply |
WRITE | Toggle port forward |
container_exec |
WRITE | Run in container |
Docker & containers
| Tool | Class | Description |
|---|---|---|
docker_daemon_status |
READ | Docker daemon status |
docker_container_list |
READ | List containers |
docker_container_start |
WRITE | Start container |
docker_container_stop |
WRITE | Stop container |
docker_container_restart |
WRITE | Restart container |
docker_container_remove |
WRITE | Remove container |
docker_container_logs |
READ | Container logs |
docker_images_list |
READ | List images |
docker_pull |
WRITE | Pull image |
docker_run |
WRITE | Run container |
docker_compose_list |
READ | List compose projects |
docker_compose_up |
WRITE | Compose up |
docker_compose_down |
WRITE | Compose down |
Ports
| Tool | Class | Description |
|---|---|---|
ports_list |
READ | List ports |
ports_reserve |
WRITE | Reserve port |
ports_release |
WRITE | Release port |
ports_suggest_free |
READ | Suggest free port |
ports_kill_listener |
WRITE | Kill listener |
ports_resolve_alias |
READ | Resolve port alias |
ports_check |
READ | Check port |
ports_claim |
WRITE | Claim port |
ports_declared |
READ | Declared ports |
ports_import_declared |
WRITE | Import declared ports |
Projects & worktrees
| Tool | Class | Description |
|---|---|---|
project_list |
READ | List projects |
project_create |
READ | Create project |
worktree_list |
READ | List worktrees |
worktree_create |
WRITE | Create worktree |
worktree_switch |
WRITE | Switch worktree |
worktree_rename |
WRITE | Rename worktree |
worktree_remove |
WRITE | Remove worktree |
worktree_adopt |
WRITE | Adopt worktree |
worktree_merge_cleanup |
WRITE | Merge PR & clean up |
Knowledge & collaboration
| Tool | Class | Description |
|---|---|---|
list_prompts |
READ | List prompts |
run_prompt |
READ | Read prompt |
save_prompt |
READ | Save prompt |
help_list |
READ | List help topics |
help_read |
READ | Read help topic |
help_search |
READ | Search help docs |
notes_read |
READ | Read notes |
notes_write |
WRITE | Write notes |
notes_list |
READ | List notes |
notes_add |
WRITE | Add note |
notes_rename |
WRITE | Rename note |
notes_delete |
WRITE | Delete note |
notes_select |
READ | Select note |
kanban_list |
READ | List tasks |
kanban_add |
READ | Add task |
kanban_update |
READ | Update task |
kanban_move |
READ | Move task |
kanban_remove |
WRITE | Delete task |
kanban_columns |
WRITE | Manage task columns |
kanban_archive |
READ | Archive tasks |
kanban_undo |
READ | Undo board change |
kanban_boards |
READ | Manage boards |
kanban_depend |
READ | Link task dependencies |
kanban_ready |
READ | Find ready tasks |
kanban_claim |
READ | Claim task |
diff_comment_add |
READ | Comment on a diff line |
diff_comment_list |
READ | List diff comments |
diff_comment_flush |
READ | Collect diff comments |
chat_identify |
READ | Claim chat handle |
chat_threads |
READ | List conversations |
chat_read |
READ | Read conversation |
chat_post |
READ | Send message |
chat_wait |
READ | Wait for messages |
chat_thread_create |
READ | Start conversation |
chat_thread_update |
READ | Update conversation |
chat_thread_delete |
WRITE | Delete conversation |
feedback_submit |
WRITE | Send feedback to the TRMNLY team |
tracker_issue_context |
READ | Read tracker issue |
conversation_save |
READ | Save conversation |
conversation_list |
READ | List conversations |
conversation_get |
READ | Get conversation |
conversation_send |
WRITE | Send to agent conversation |
conversation_archive |
READ | Archive conversation |
conversation_delete |
WRITE | Delete conversation |
agent_stop_turn |
READ | Stop agent turn |
list_claude_code_sessions |
READ | List Claude Code sessions |
read_claude_code_session |
READ | Read Claude Code session |
Orchestration
| Tool | Class | Description |
|---|---|---|
spawn_subagent |
WRITE | Spawn sub-agent |
wish_submit |
WRITE | Triage a request into tasks |
fleet_status |
READ | Fleet status |
fleet_start |
WRITE | Start the fleet |
fleet_stop |
READ | Stop the fleet |
race_start |
WRITE | Race agents on a prompt |
race_status |
READ | Race status |
race_pick |
WRITE | Keep one race entrant |
plan_create |
READ | Create plan |
plan_execute |
WRITE | Execute plan |
plan_list |
READ | List plans |
debug_hypotheses |
WRITE | Debug hypotheses in parallel |
judge_panel |
WRITE | Judge panel |
Automation & workflows
| Tool | Class | Description |
|---|---|---|
schedule_create |
WRITE | Create schedule |
schedule_list |
READ | List schedules |
schedule_update |
WRITE | Update schedule |
schedule_delete |
WRITE | Delete schedule |
schedule_run_now |
WRITE | Run schedule now |
post_notification |
WRITE | Post notification |
awake_acquire |
WRITE | Keep system awake |
awake_release |
READ | Release awake claim |
awake_status |
READ | Awake status |
list_runbooks |
READ | List runbooks |
save_runbook |
WRITE | Save runbook |
update_runbook |
WRITE | Update runbook |
delete_runbook |
WRITE | Delete runbook |
run_runbook |
WRITE | Run runbook |
run_workflow_steps |
WRITE | Run workflow steps |
list_workflow_runs |
READ | List workflow runs |
list_workflow_tags |
READ | List workflow tags |
set_workflow_tags |
WRITE | Set workflow tags |
list_tab_monitor_rules |
READ | List tab-monitor rules |
add_tab_monitor_rule |
WRITE | Add tab-monitor rule |
update_tab_monitor_rule |
WRITE | Update tab-monitor rule |
set_tab_monitor_rule_enabled |
WRITE | Toggle tab-monitor rule |
remove_tab_monitor_rule |
WRITE | Remove tab-monitor rule |
list_write_snapshots |
READ | List write snapshots |
revert_write_snapshot |
WRITE | Revert write snapshot |
awake_preferences |
WRITE | Awake preferences |
Safety & policy
| Tool | Class | Description |
|---|---|---|
agent_mcp_server |
WRITE | Manage MCP server |
usage_read |
READ | Read usage |
audit_list |
READ | List remote activity |
dry_run_begin |
READ | Begin dry-run overlay |
dry_run_diff |
READ | Dry-run diff |
dry_run_apply |
WRITE | Apply dry-run changes |
dry_run_discard |
READ | Discard dry-run overlay |
access_key_list |
READ | List access keys |
access_key_get |
WRITE | Get access key value |
access_key_set |
WRITE | Store access key |
access_key_delete |
WRITE | Delete access key |
access_key_push_cloud |
WRITE | Push access keys to cloud |