Sailfork docs
Host code on Sailfork, work from the terminal, and let AI agents open pull requests through caissons, the API and MCP.
Sailfork is a git host for people and AI agents: repositories, pull requests, issues, CI, and caissons, which are working copies on the server that an agent edits without cloning. Work is pushed over HTTPS or SSH, reviewed in pull requests and checked by CI runs. The person reviewing sees which pull requests an agent opened.
Get started
- Quickstart Install the CLI, sign in, create or push a repository, open your first pull request and find where to go next.
- How Sailfork works The parts of Sailfork in one page, from accounts and repositories to caissons, CI runs, sandboxes and tokens, with a link to each full page.
- Install the CLI Install the sailfork command line, sign in, connect git, switch accounts, keep it current, and script it with JSON output, environment variables and exit codes.
Repositories
- Repositories Create a repository, choose who can see it, clone and browse it, change its settings, and delete or restore it, from the web app, the CLI and the API.
- Git over HTTPS and SSH Clone and push with plain git over HTTPS or SSH, sign in with a token or an SSH key, push an existing repository, and fix the errors a push can return.
- Branches and protection List and delete branches, keep the default branch safe, and set the rules a pull request must meet before it merges, including branch rules, required checks, owners, protected paths, the merge queue and tag protection.
- Releases Publish a tag with notes and downloadable files from the web app, the CLI or the API, and link to the files from installers and scripts.
- Move from GitHub Import repositories from GitHub with their history, issues and pull requests, keep a mirror in sync, and see what happens to your Actions workflows.
- Mirrors Keep a repository in step with a copy on GitHub or another git server, or make it follow a remote, and fix a mirror that stops.
Collaboration
- Pull requests Open a pull request, follow its checks and reviews, and merge it from the web app, the CLI or a script.
- Code review Ask for a review, comment on lines of a diff, approve or request changes, and settle threads from the web app or the CLI.
- Issues File, triage, assign and close issues, and filter them by status, label and milestone, from the web app or the CLI.
- Search Find code, symbol definitions, issues and pull requests from the web app or the CLI, and know what each search covers.
- Notifications and activity See what needs you in the inbox, by email and from the CLI, follow events live, send webhooks and take back an action.
Agents
- Working with agents Sign a coding agent in, give it work, and see what it did, from the CLI, the MCP server or the REST API.
- Caissons Read and edit a repository on Sailfork with no local clone, then commit and open a pull request, from the CLI, MCP or the REST API.
- MCP server Connect Claude, ChatGPT, Cursor or VS Code to Sailfork over MCP, so an assistant can edit in caissons, open pull requests and read issues and CI.
- Apps Give your reviewer, CI provider or agent platform its own bot account, install it on repositories, and act through short-lived installation tokens.
- Agent tests The eleven tasks a small model runs against sailfork.com over MCP and the CLI, how each is checked, and the results.
CI and compute
Organizations
- Organizations Create an organization, invite people, group them into teams and set the rules its repositories follow.
- Roles and permissions Who can read, push, merge and administer, for people, organization members, collaborators, signed-out visitors, tokens and agents.
- Plans, billing and usage What each plan includes, what is free during early access, how to pay, and how to read your metered usage.
Account
CLI
- Overview Every sailfork command, the flags they all share, output formats, exit codes and environment variables.
- Sign-in and setup Sign in, check what a token may do, manage tokens and SSH keys, and keep the CLI up to date.
- Repositories Create, clone and edit repositories, work with branches, commits and releases, search, and move repositories from GitHub.
- Pull requests and issues Open, review and merge pull requests, work issues, and see what needs you from the terminal.
- Caissons and agents Edit a repository on the server through a caisson, serve MCP tools, install agent skills and call the API directly.
- CI and sandboxes Inspect, rerun and dispatch CI runs, run code in sandboxes on your Drydock machines, and read metered usage.
- Organizations Create organizations, list members, and send or answer invitations.
REST API
- Overview JSON over HTTPS under /api, with access tokens, scopes, errors, paging and the routes people use most.
- Repositories Create, read, change, protect and share repositories over REST, and read their commits, files, branches and diffs.
- Releases List, create, edit and delete releases, upload and download their files, and look up the latest CLI build.
- Search Search code across repositories, find symbol definitions and references, list public repositories, resolve people, and check server health.
- Pull requests List, open, review, comment on and merge pull requests, and read their diffs, checks and briefs, over the REST API.
- Issues Create, triage, claim and close issues over REST, and manage labels, milestones, repository notes, attachments and agent work.
- Caissons Open a caisson, read and edit its files, run searches and scripts, commit, open a pull request and handle review, all over REST.
- CI Connect CI compute, manage secrets and environments, start, watch, cancel and rerun workflow runs, and read logs, artifacts and caches over REST.
- Sandboxes Register Drydock hosts, start sandboxes, run commands, move files, open preview links and manage sandbox settings, secrets and cloud overflow over REST.
- Organizations Create and manage organizations, members, teams, invitations, blocks, domains, usage, plans and the audit log over REST.
- Account Read and change your own account over REST, including access tokens, SSH keys, webhooks, notifications, the event feed, undo, blocks and CLI and MCP sign-in.
Reference
- Limits Every size, count, time and rate limit Sailfork enforces, with the real numbers.
- Rate limits Every request rate limit Sailfork enforces, what a 429 looks like, and how to back off.
- Keyboard shortcuts Every key the web app answers to, by page, and how to open the list in the app.
- Troubleshooting The problems people hit most with sign-in, git, the CLI, CI, caissons, sandboxes and moving repositories, and the fix for each.
For agents
Everything a coding agent needs to work on Sailfork, in the order to set it up. The full guide is Working with agents.
Hand your agent one prompt
Paste this into Claude Code, Codex, Cursor or any coding agent. It reads the docs index, installs the CLI and the skills, and works through setup, stopping where a person is needed.
Read https://status.sailfork.com/llms.txt.
Install the sailfork CLI with `curl -fsSL https://status.sailfork.com/install | sh`, run `sailfork skill install`, then run `sailfork onboard status --json` and follow the next command it gives until setup is done. Install the skills
Two skills ship inside the CLI, so they always match its commands: sailfork (pull requests, issues and CI) and caisson (editing a repository on the server with no clone).
sailfork skill install # ~/.claude/skills, every project on this machine
sailfork skill install --project # this repository's .claude/skills, shared through git
sailfork skill install --dir ~/.codex/skills # any other agent's skills folder Connect the MCP server
The remote server signs in through the browser. The local one runs over stdio as the account sailfork auth login signed in. Other clients and the read-only and per-toolset addresses are on MCP server.
claude mcp add --transport http sailfork https://status.sailfork.com/mcp
claude mcp add sailfork -- sailfork mcp Start every session with context
As a session-start hook, this prints the pull requests, reviews and issues waiting in the current clone. The settings to add are on Working with agents.
sailfork hook session-start Give it the docs
| What | Address |
|---|---|
| Index of every page, for an agent to pick from | https://status.sailfork.com/llms.txt |
| Every page in one file | https://status.sailfork.com/llms-full.txt |
| One page as Markdown | Add .md to its address, as in https://status.sailfork.com/docs/ci.md, or send Accept: text/markdown |
| Every CLI command and flag as JSON | sailfork commands --json, and sailfork schema <command> for what it prints |
Get help
Answers about signing in, SSH keys, billing and your data are in Help. For anything else, write to us.