Documentation
Everything about the TrailSail app and the trailSailServer package. New here? Start with Getting started.
Getting started
Install TrailSail on your Mac and the server package on the Mac that runs the models, pair them with a six-word code, and get your first streamed reply.
Server setup
What the trailSailServer installer does on the Mac that runs the models: Splash, the llama.cpp router, SearXNG, API keys and Tailscale publishing.
Pairing
How pairing works in TrailSail: a six-word code, single use, valid for ten minutes, that hands the keys to one device and can be revoked later.
The Server panel
Run your model server from the app: start, stop and restart engines, switch and install models, read logs and rotate keys in Settings → Server.
The trailSailServer CLI
The trailSailServer command line: every action in the Server panel as a command on the server, from status and logs to models, pairing and keys.
Updates
How TrailSail and the server package update themselves, how every release is signed, and how to turn the daily update check on or off.
Licences
Who needs a TrailSail Business licence, what the signed licence file is, how to add it, and how the server counts people by Tailscale login.
Projects
Attach a folder to a chat so the model can read and edit your code, with the project and its git branch shown in the chat header.
Developer tools
TrailSail's developer tools, from git and tests to databases, Docker and a browser, each set to allow, ask or deny per tool and per action.
Agents
Run sub-agents in parallel from a chat: each gets its own tools, step limit and thinking effort, with a rail to watch, open or cancel them.
Notes & memory
How memory works in TrailSail: notes kept as plain markdown files, the end-of-chat wrap-up, and the Notes panel for reading and editing them.
Terminal
A real zsh terminal docked in the chat window, opened in the project folder with one shortcut, alongside the model you are working with.
Context
How TrailSail measures the prompt against the model's context window, when it compacts older messages, and how thinking effort is set.
Sync
Keep TrailSail on several Macs aligned through one iCloud Drive folder: what syncs between them, and why API keys never leave each Mac.
Keyboard shortcuts
The keyboard shortcuts for TrailSail on macOS: new chat, search, settings, the terminal, the model manager and the rest, shown as keycaps.
Manual setup
Set up the model server by hand without the trailSailServer package: Splash, the llama.cpp router, SearXNG and Strata, published with Tailscale.