Tools
The toolsets an agent can use, which one to reach for, and where each is explained: files and shell, browser, computer use, voice, meetings, media, MCP, plugins and integrations.
On this page
Tools come in toolsets, and an agent lists the ones it gets under toolsets. Without the setting it gets core, memory, skills, schedule, delegate and board. A list replaces the default, so add the defaults you want to keep:
agents:
habakkuk:
toolsets: [core, memory, skills, schedule, delegate, board, browser]What a tool may do on its own is decided by the agent's permission mode and approvals.
If you need X, use Y#
| You need the agent to | Use | Page |
|---|---|---|
| Read, write and patch files, run commands | core (default) |
Files and shell |
| Run commands in a container or on another host | sandbox: docker or ssh |
Files and shell |
| Undo what a turn changed in the workspace | checkpoints (on by default), /undo |
Files and shell |
| Browse the web, fill in forms, use sites you are signed in to | browser |
Browser |
| Drive desktop apps with the mouse and keyboard | computer |
Computer use |
| Search the web | hosted search, or search: |
Media and web search |
| Read images, PDFs and Office files; make images and video | core with images: or video: |
Media and web search |
| Talk out loud, or answer voice notes with voice | realtime:, habakkuk talk, tts: |
Voice |
| Sit in a video call and take notes | meeting |
Meetings |
| Use GitHub, Linear, Notion, a database and hundreds more | mcp:<server> |
MCP |
| Install someone's packaged skills, tools and commands | habakkuk plugins install |
Plugins |
| Control Home Assistant, talk to other agents, lend it a phone's camera | homeassistant, a2a, device nodes |
Integrations |
| Remember things and follow skills | memory, skills (default) |
Memory, Skills |
| Schedule work and hand it to other agents | schedule, delegate, board (default) |
Schedules, Multi-agent |
Toolsets#
| Toolset | Tools |
|---|---|
core |
read_file, write_file, edit_file, list_dir, exec, apply_patch, search_files, fetch_url, background processes, todo, clarify, view_image, read_document; with channels send_file and poll; image_generate, video_generate, speak, nodes_list and node_invoke when configured |
memory |
memory_save, memory_search, memory_read, memory_forget, user_profile_read, user_profile_update, session_search, memory_history |
skills |
skill_view, skill_file, skill_save |
schedule |
schedule_create and friends |
delegate |
delegate |
board |
board_* |
browser |
browser_* |
computer |
computer_* |
meeting |
meeting_join, meeting_leave, meeting_status, meeting_transcript |
homeassistant |
ha_states, ha_call_service, ha_history |
a2a |
a2a_discover, a2a_send |
mcp:<server> |
One per MCP server, named mcp__<server>__<tool> |
An agent with a home chat also gets message_home.
Tool search#
An agent whose toolsets hold more tools than tool_search_over (default 60; -1 turns it off), usually from MCP servers, is offered only the core tools plus tool_search and tool_describe. The tools it finds are added for the rest of the session.
agents:
habakkuk:
tool_search_over: 60In this section
- Files and shellThe core workspace tools: file reads and edits, exec, apply_patch, search, background processes, Docker and SSH sandboxes, and workspace checkpoints with rollback.
- BrowserLet agents drive a real web browser: a headless Chrome Habakkuk starts, or your own signed-in Chrome; the tools, URL rules, installing a browser on a server, and safety.
- Computer useLet agents see a desktop through screenshots and drive it with the mouse and keyboard: the Linux, macOS and private virtual desktop backends, and the safety rules.
- VoiceTalk to Habakkuk out loud: Live mode in the dashboard, habakkuk talk on a laptop or Raspberry Pi, voice notes in chats, and spoken replies.
- MeetingsLet an agent attend Google Meet, Zoom and Microsoft Teams calls as a named guest, read the live captions, and send notes with decisions and action items.
- Media and web searchRead images and documents, generate images and video, and search the web: hosted search on Anthropic models, or the web_search tool with Brave, Tavily, Exa, SearXNG or DuckDuckGo.
- MCPGive agents tools from any Model Context Protocol server (stdio or Streamable HTTP, with OAuth sign-in), add servers from the built-in catalog, and serve Habakkuk itself over MCP.
- Plugins and outside skillsInstall skills and plugins from GitHub, URLs, local paths and registries: the lock file, the security scan, updates and restores, and the plugin manifest.
- IntegrationsConnect Habakkuk to other programs: Home Assistant, signed webhooks, Agent2Agent, the OpenAI-compatible API, code editors over ACP, and device nodes.