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
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