// HOW TO

How to Kaptain

One guide per task, every step written down, every claim exercised on a real install before publication. Start at the top if you're new; jump straight to your task if you're not. Each guide also ships an agent-readable index.md next to it.

10 MINInstall KaptainLinux, macOS, Windows, Android — installer or direct download, first start, the four commands, updating.Open → 15 MINSet up KaptainEvery step of the first-run wizard: account, plan, models, install, project folder, network, and the access code.Open → 20 MINConnect Tailscale & remote accessYour own tailnet: install both ends, switch the mode, pair your phone, optionally allowlist devices.Open → 20 MINAdd models — every typeOllama, Kaptain's built-in llama.cpp (GGUF, vision GGUFs with their projector), Claude/Codex CLI harnesses, and cloud API keys — how to add and when to use each; which model processes your images.Open → 20 MINKapsules: harnesses and agentsA kapsule wraps a model with persona, tools, permissions, memory, schedule and jobs; the two kinds of agents it holds; building one.Open → 15 MINConnect MCP serversBring external tools into Kaptain's catalog — local (stdio) or remote (streamable-HTTP) — and point agent CLIs at Kaptain's own toolbelt.Open → 10 MINSkillsReusable instruction packs your runs can load on demand — where they live and how to add your own.Open → 15 MINKrew tools & building your ownThe toolbelt Kaptain's models use, and the supported path to adding tools of your own.Open → 10 MINLend models between machinesOne kcat_ connection code lets another of your Kaptains run this one's models, process images on them and follow their settings. Never your chats or files.Open → 5 MINLicences, devices & 402sHow licensing works, both activation paths, restoring after a trial, device limits — and every cause of a 402 with its fix.Open → REFERENCEWhere everything livesEvery file Kaptain writes, per OS — plus backup and moving to a new machine.Open →

This library grows with the product. A task you can't find here is a documentation bug — tell us what you were trying to do.