Skip to content

Native tools

DuckTapeKiller edited this page Sep 13, 2026 · 1 revision

Dive comes with 29 native tools. They work in llama.cpp, LM Studio, Ollama and Cloud mode; Pi mode uses pi's own tools. This page lists every one, with what it does, what it needs, whether it starts switched on, and whether it asks you first.

In the tables, required inputs are in bold. "Asks first" means a permission dialog opens before every run, as described in How the model uses tools.

Switching tools on and off

Each mode has its own switches in Settings > TOOLS > NATIVE TOOLS. The list there has 27 tools: in 5.0.8 it leaves out browse_read and browse_act, so those two keep their defaults, browse_read on and browse_act off.

The INPUT column adds a button above the message box that types a tool's slash command for you. Only 17 tools have that option; see Slash commands.

Research and reference

Tool What it does Inputs Starts Asks first Slash command
wikipedia Looks up one Wikipedia article query, language On No /wiki, /wikipedia
britannica Searches Encyclopaedia Britannica query On No /britannica
larousse Searches the French Larousse Encyclopédie query On No /larousse
scholarpedia Searches Scholarpedia, a peer-reviewed encyclopedia of specialist science query On No /scholarpedia
wiktionary Looks up dictionary definitions word, language On No /wiktionary
deep_etymology Cross-references etymology and dictionary sources: origins, cognates, false cognates and false friends word, language On No /etymology, /deep_etymology
book_search Searches several book databases at once and returns one merged table query, language, provider On No /book, /isbn, /book_search
duckduckgo A quick web search that returns a numbered list of results query, max_results On No /duckduckgo
deep_research A full research pipeline in one call that returns an evidence dossier query, queries, max_sources, academic On No /deep_research
academic_search Searches OpenAlex, Crossref, arXiv, Semantic Scholar and PubMed, with no keys needed query, year_from, year_to, max_results, providers On No /academic_search
fetch_paper Fetches a paper by DOI, arXiv link or URL, reads it, and saves the open-access PDF url_or_doi, save On No /fetch_paper
fact_check Checks a claim against Wikipedia and the web claim, language On No /factcheck, /fact_check
web_scraper Returns the readable text of a page url On No /scrape, /web_scraper

Browser

Tool What it does Inputs Starts Asks first Slash command
browse_read Opens a page in a real browser, running its JavaScript, and reads it action, url, selector, session, show On No None
browse_act Clicks, types, presses a key, selects an option or scrolls on the open page action, target, text, key, amount, session Off Yes None

Working memory

Tool What it does Inputs Starts Asks first Slash command
local_notes Reads or appends to the note open in the Notes panel action, content On No /notes, /local_notes
remember_lesson Saves a lesson for every future chat in the current mode lesson On No /remember, /remember_lesson
task_plan Keeps a checklist for a task with several steps action, steps, plan_id, step, status, note On No None

Utility

Tool What it does Inputs Starts Asks first Slash command
calculator Works out a maths expression expression On No /calc, /calculator
time_and_date Gives the current time, date and weekday, for a time zone if you name one timezone On No /time, /time_and_date
http_request Calls web APIs: any method, headers, body, timeout and cookie sessions url, method, headers, body, timeout_ms, follow_redirects, session On No None

Code and system

Tool What it does Inputs Starts Asks first Slash command
shell_command Runs a shell command command, timeout_seconds, cwd Off Yes /shell
run_code Runs JavaScript in an isolated worker code, timeout_ms On Yes None
run_python Runs a Python script code, timeout_seconds On Yes None
file_operations Reads and writes files in the workspace folder action, path, content, pattern On No None
code_search Searches and reads files in your allowed folders, without changing them action, path, pattern, glob, start_line, end_line, max_results On No None
git_tools Inspects a git repository without changing it action, repo, ref, path_filter, count, start_line, end_line On No None
macos_control Controls your Mac: AppleScript, opening things, notifications, processes action, script, target, app, title, message, filter, pid, force Off Yes None

Extension

Tool What it does Inputs Starts Asks first Slash command
propose_plugin Drafts an external tool for you to review. It never runs the draft name, description, code Off No None

Notes on particular tools

deep_research

deep_research is the tool Dive steers factual questions to. In one call it works out several research angles, consults encyclopedias (Wikipedia, Britannica, the Larousse Encyclopédie, Store norske leksikon, and Scholarpedia for science) when they fit, and searches the web and scholarly sources. It checks pages against bot walls and relevance, throws away unusable evidence, prefers a spread of sources, and always leaves out Grokipedia. When a page is gone or blocked it falls back to the Wayback Machine or archive.ph, and labels that evidence as archived. The model receives a compact evidence dossier and is told to separate corroborated facts from single-source claims.

When several people or topics match a question, the model lists them under "Possible matches", and each name becomes a button that runs the research again for that one.

book_search

book_search asks Open Library, Google Books, Goodreads and StoryGraph in parallel, and also Hardcover, LibraryThing and a Calibre server once you add their details in Settings > TOOLS > BOOK SEARCH PROVIDERS. The query can be a title, an author or an ISBN. The result is a ready-made table that the model is told to copy into its reply unchanged.

The browser tools

browse_read opens pages in a Chromium browser that Dive controls, so it works on sites that only render in a browser. It can open a page, return its text, list the links, buttons and fields on it, take a screenshot, go back, list sessions and close them. A session keeps its cookies between calls. A screenshot is only shown to the model when the call asks for that with show.

browse_act clicks, types, presses keys, selects options and scrolls on the page that browse_read opened, and asks you before every action. Both tools treat everything on a page as untrusted content, never as instructions. You can watch and use the same browser in the agent browser panel, opened with the globe icon in the side panel.

Files and code

  • file_operations only works inside ~/dive/workspace. It can list, read, write, append, delete, make folders, show file information and find files by pattern.

  • code_search and git_tools only read. They reach ~/dive/workspace plus the folders you list in ~/dive/allowed-dirs.json:

    {
      "directories": ["~/Projects/my-app"]
    }
  • shell_command waits 5 seconds by default, and up to 300 when the model asks for longer. Its working folder must be your home folder or an allowed folder.

  • run_python uses the system python3, or the virtual environment set as pythonVenv in ~/dive/coding-settings.json.

  • fetch_paper saves open-access PDFs to ~/dive/workspace/papers.

Working memory

  • local_notes works on the note currently open in the Notes panel. Notes are Markdown files in ~/dive/notes.
  • remember_lesson appends to ~/dive/lessons/<mode>-lessons.md, and each lesson must be under 500 characters. Every line in that file, apart from # comments, goes into that mode's system prompt. Edit the lessons in Settings > PROMPTS > LESSONS.
  • task_plan keeps a checklist with steps marked done, failed or skipped, so you can follow the model's progress.

propose_plugin

propose_plugin writes a draft into ~/dive/plugin-drafts/<name>, where nothing loads it. The draft appears in Settings > TOOLS under EXTERNAL TOOLS as a draft awaiting your approval, and it only runs after you approve it. See Create an external tool.

For developers

  • Definitions: ALL_SKILLS in skills.js. Implementations: skills/. Dispatch: the switch in executeSkill().
  • Default switches: defaultSkillsConfig() in server.js. Tools that ask first: GATED_BUILTIN_SKILLS in skills.js.
  • The descriptions and examples in Settings, and in Ollama's text prompt, come from ALL_BUILTIN_SKILLS_INFO in assets/js/01-core.js, so a new tool needs an entry there to get a switch.
  • Slash commands and the INPUT allowlist: slash_commands.js.

Read next

Clone this wiki locally