Repository navigation
Home

Dive is a desktop chat app for macOS, Windows and Linux. It works with AI models that run on your own computer, with the pi coding agent, and with cloud models from OpenAI, Anthropic, Mistral and Google if you add your own API keys. The app runs a small server that only your computer can reach, and it keeps your conversations, settings, notes and library index in a folder called dive in your home folder.
This wiki is for anyone who uses Dive or wants to extend it, and for developers and AI agents who work on its code. Writing a skill needs only a text editor. Building a tool takes some code, and those pages explain each step.
- Install Dive.
- Pick a mode. Choosing a mode compares all five, and each one has a step-by-step tutorial.
- Read Tools and skills. The rest of the wiki uses those two words carefully, and the page takes a few minutes.
A mode decides what Dive talks to. Switch between them with the mode icons in the top bar. Each mode keeps its own conversations, chosen model and appearance.
| Mode | What it talks to | Good for | Tutorial |
|---|---|---|---|
| llama.cpp |
llama-server running GGUF model files on your computer |
Running local models directly. Dive can download models and start the server for you | llama.cpp mode |
| Pi | The pi coding agent, installed separately | Agent work on your files and in the terminal, using pi's own tools, skills and extensions | Pi mode |
| Cloud | OpenAI, Anthropic, Mistral or Google Gemini, with your API keys | Models hosted by those companies | Cloud mode |
| LM Studio | The local server in LM Studio | Models you already manage in LM Studio | LM Studio mode |
| Ollama | Ollama | Models you already run with Ollama | Ollama mode |
llama.cpp, Pi and Cloud are switched on the first time you open Dive. To add LM Studio or Ollama, open Settings, choose the MODES tab and tick them.
Pi mode works differently from the other four. Dive becomes a window onto pi, and pi brings its own tools, skills and extensions. Everything in Dive's TOOLS and SKILLS tabs belongs to the other four modes. Pi mode shows how to add things for pi.
A tool is an action the model can take. Each tool has a name, a description and a list of inputs. When the model calls one, Dive runs the tool's code and hands the result back to the model. The wikipedia tool fetches an article, for example, and calculator works out a sum.
A skill is a set of written instructions: a folder with a SKILL.md file, sometimes with reference files beside it. The model reads a skill when your request matches what the skill is for, then follows the instructions. A skill runs no code on its own. Dive, pi and Claude Code all read the same skill format, so one skill folder can serve all three.
Settings has a tab for each. TOOLS lists the native tools that come with Dive, the external tools you install yourself, your custom tools and, at the bottom, MCP servers. SKILLS lists your Agent Skills. Tools and skills covers the difference in full.
- Installing Dive: download, first launch, and where Dive keeps your data
- Choosing a mode: what each mode needs and what it can do
- Tutorials: llama.cpp, Pi, Cloud, LM Studio, Ollama
- Tools and skills: what each one is and how to tell them apart
- How the model uses tools: tool calls, Agent Mode, confirmations, and what you see while a tool runs
- Native tools: every tool that comes with Dive, with an example for each
-
Slash commands: run a tool or load a skill by typing
/in the message box - Settings for tools and skills: the TOOLS and SKILLS tabs, section by section
-
Create a skill: write a
SKILL.md, test it and switch it on - Create a tool: choose between a custom tool, an external tool and an MCP server
- Create a custom tool: a shell command or a piece of JavaScript, added in Settings
- Create an external tool: a Node.js plugin that adds tools and slash commands
- Connect an MCP server: use the tools of any Model Context Protocol server
- Sharing with pi and Claude Code: keep one copy of each skill for every app
- Safety: what tools can reach on your computer, and the checks Dive applies
- Architecture: the processes, the request flow and a map of the code, for developers and AI agents
- Data folder and settings: every file Dive writes and which settings belong to each mode
- Troubleshooting: common problems and how to fix them
- Glossary: the terms used in this wiki
Start with Architecture. The docs folder in the repository goes further into each part: the HTTP API, the security model and the tests. Wiki pages link to the matching document where that helps.
These pages describe Dive 5.0.8. Download the latest version from Releases. If something here doesn't match what you see in the app, open an issue.
These pages describe Dive 5.0.8. Source code: DuckTapeKiller/dive. Spotted a mistake? Open an issue.
Get started
Tools and skills
Build your own
Share and stay safe
How Dive works
Help