# Offsite

> Offsite is an agentic development environment. A host (macOS or Linux) runs
> coding-agent and terminal sessions in tmux; native macOS and iOS
> clients attach to them live. Sessions are host-owned, so they survive client
> disconnects, network changes, sleep and reboot. Offsite starts the real
> `claude`, `codex` and `grok` CLIs under the user's own subscription — it is
> not a wrapper and no token passes through it.

Offsite has no account, no telemetry and no model of its own.

Start with https://offsite.sh/docs/agents/for-agents for a single-page briefing, or
https://offsite.sh/docs/llms-full.txt for the complete documentation in one request.

## Start here

- [The big picture](https://offsite.sh/docs/start/big-picture): Why Offsite exists, what runs where, and how the loop from prompt to test closes on the device in your hand.
- [Your first session](https://offsite.sh/docs/start/first-session): From a paired host to a working agent, through workspaces, the board, and what happens when you walk away.
- [Install & set up](https://offsite.sh/docs/start/install): Install the Mac app from your invitation, set up This Mac as your first host, and pair your iPhone by scanning a QR code.
- [Hosts, sessions and clients](https://offsite.sh/docs/start/overview): The three pieces every other page in these docs builds on.
- [Prerequisites](https://offsite.sh/docs/start/prerequisites): What you need before installing Offsite, per platform, with what Offsite sets up for you automatically.
- [Updating Offsite](https://offsite.sh/docs/start/updating): How the app and the host update, what the version numbers mean, and what to do when a host is older than your app.
- [What macOS will ask you](https://offsite.sh/docs/start/what-macos-asks): Every system prompt and notification you may see while setting up Offsite on a Mac, in order, with the reason and what you get for it.

## Hosts

- [Always reachable](https://offsite.sh/docs/hosts/always-reachable): Making a host survive a reboot and answer before anyone logs in — what it installs and what it costs.
- [Managing several hosts](https://offsite.sh/docs/hosts/fleet): Running more than one host, switching between them, and what "warm" means in the host list.
- [Keep the host awake](https://offsite.sh/docs/hosts/keep-awake): Stopping a Mac host from sleeping while your agents work — for a set time or until you allow sleep again, from each host's row.
- [A Linux host](https://offsite.sh/docs/hosts/linux): Running Offsite on a Linux box or VPS — requirements, the CPU check that keeps Claude happy, and what a Linux host carries.
- [A second Mac as a host](https://offsite.sh/docs/hosts/remote-mac): Setting up another Mac over SSH — what that machine needs, and why Remote Login is only needed once.
- [This Mac as a host](https://offsite.sh/docs/hosts/this-mac): Turning the Mac you are sitting at into a host — what the setup does, what it does not touch, and what the name means.

## Workspaces & sessions

- [Agent sessions](https://offsite.sh/docs/work/agent-sessions): Running the real Claude, Codex and Grok CLIs — permission modes, models, and how a card follows the CLI's own session commands.
- [Agents that steer Offsite](https://offsite.sh/docs/work/agents-steer-offsite): Tell Claude to start Codex with the model you name, fork a session, hand off for a fresh context, read what another session found, or close a card, from the Mac or the iPhone.
- [Hand off and ask](https://offsite.sh/docs/work/handoff-and-ask): Moving context between agent sessions, and why one session can never type into another.
- [The Icebox](https://offsite.sh/docs/work/icebox): Parking an agent session off the board with its conversation, and getting it back where it was.
- [Repository Setup](https://offsite.sh/docs/work/repository-setup): Setup and Run buttons for the main checkout of a repository. Save the commands that install and start your apps, by hand or with an agent.
- [Cards that name themselves](https://offsite.sh/docs/work/self-naming): Every agent session names its own card and keeps a one-line recap current, so the board stays readable and a notification tells you which agent wants you.
- [Sessions and why they survive](https://offsite.sh/docs/work/sessions): What a session actually is on the host, what kills it, and what does not.
- [Workspaces](https://offsite.sh/docs/work/workspaces): One folder, one board, its own sessions — and why a workspace does not need to be a git repository.
- [Worktrees](https://offsite.sh/docs/work/worktrees): Give a task its own branch, folder, agents and ports, so several agents work on one repository at the same time.
- [Create a worktree](https://offsite.sh/docs/work/worktrees/create): Start a worktree as a plain branch, from a task with an agent, or from a GitHub issue or pull request. Agents can create them too.
- [Finish and clean up](https://offsite.sh/docs/work/worktrees/finish): Bring a worktree's work into the base from its Git card, with pull requests, checks and conflicts handed to an agent, then delete it and keep the disk tidy.
- [How worktrees are built](https://offsite.sh/docs/work/worktrees/how-it-works): What happens on disk when Offsite creates a worktree. A git worktree, copy-on-write clones for what git ignores, a port window from the branch name, and nothing deleted without you.
- [Run apps side by side](https://offsite.sh/docs/work/worktrees/ports): Every worktree gets its own window of 100 ports. Your dev servers, APIs and databases run in several worktrees at once, and the Browser card opens the right one.
- [Worktree Setup](https://offsite.sh/docs/work/worktrees/setup): Say once what every new worktree gets before its agent starts. Smart Copy, commands, apps to run, clean-up steps, written by you or worked out by an agent.

## The board

- [Marking up what you send](https://offsite.sh/docs/board/annotate): Circle it, number it, write one line per number. The agent gets the marked image and your notes as text, instead of guessing what "the blue one" meant.
- [The board](https://offsite.sh/docs/board/board): Why Offsite uses a grid instead of tabs, how cards move between board, tabs and Icebox, and what Tidy board does.
- [Focus mode and the card strip](https://offsite.sh/docs/board/fullscreen): Giving one card the whole window without losing sight of the others.
- [Keyboard control](https://offsite.sh/docs/board/keyboard): Driving the board without the mouse — and why every Offsite shortcut contains Command.
- [Tabs](https://offsite.sh/docs/board/tabs): The tab bar for cards you want reachable but not on screen.
- [Dark mode, light mode and themes](https://offsite.sh/docs/board/themes): Appearance, the built-in themes, and the difference between app colours and terminal colours.
- [Sending files to a session](https://offsite.sh/docs/board/upload): Getting screenshots, logs and documents from your Mac or phone into an agent's hands.

## Cards & tools

- [The Agent Browser card](https://offsite.sh/docs/cards/agent-browser): A real browser on your host that your agent drives directly, with no extension or automation stack to install. You can watch it work and take over whenever you want.
- [The Browser card](https://offsite.sh/docs/cards/browser): Your own browser, on the device in your hand, pointed at the dev servers on your host, with a tunnel per port, tabs synced across your devices, dev tools, and a way to mark what is wrong and hand it to an agent.
- [Deploy to this phone](https://offsite.sh/docs/cards/deploy-to-phone): Building an iOS app on the host and installing it on the iPhone in your hand — no TestFlight, no cable.
- [The Files card](https://offsite.sh/docs/cards/files): Browsing and editing files on the host, with tabs, live updates when the agent writes, and a real diff when your edit and the agent's collide.
- [The Git card](https://offsite.sh/docs/cards/git): Reviewing what your agent changed, staging it, committing and pushing — from any device.
- [The Simulator card](https://offsite.sh/docs/cards/simulator): A live iOS Simulator from the host, mirrored onto your board and driven with your taps.
- [Workspace Actions](https://offsite.sh/docs/cards/workspace-actions): Saved commands and agent prompts per workspace — run them by tap, on a schedule, or when the host restarts.

## Testing

- [Testing what you build](https://offsite.sh/docs/testing/testing): Four ways the thing your agent just built reaches the device in your hand.

## Phone

- [The iOS command bar](https://offsite.sh/docs/mobile/command-bar): The row above the keyboard that makes a terminal usable with thumbs.
- [The iPhone and iPad app](https://offsite.sh/docs/mobile/iphone): The same sessions, the same board, sized for a device you hold.
- [Notifications](https://offsite.sh/docs/mobile/notifications): What Offsite tells you about, on which device, and why it is not screen scraping.
- [Voice input](https://offsite.sh/docs/mobile/voice): Dictating prompts on iPhone, with live transcription and a fallback for bad networks.
- [Worktrees on the iPhone](https://offsite.sh/docs/mobile/worktrees): Create, open, run and finish worktrees from your phone, with the same setup, ports and Git card as on the Mac.

## Connectivity

- [Device access](https://offsite.sh/docs/connect/devices): See whether a device is authorised on a host, revoke its access in two clicks, and what a revoked device shows.
- [Pairing devices](https://offsite.sh/docs/connect/pairing): How a phone or a second Mac gets access to a host, with a QR code, a host code, or one question after a password login.
- [How your devices reach your host](https://offsite.sh/docs/connect/paths): Every path to your host raced against each other, a new race when one drops, a live move off the relay, and a pill that names the path in use.
- [The relay](https://offsite.sh/docs/connect/relay): What the relay is, exactly what it can and cannot see, and how to switch it off.

## Computer Use

- [Computer Use](https://offsite.sh/docs/computer-use/computer-use): Letting an agent see and drive the host's screen — off by default, locked per session, revocable.

## Under the hood

- [Architecture](https://offsite.sh/docs/reference/architecture): What runs where, how clients and host talk, and why the design has the properties it has.
- [What Offsite puts on your machine](https://offsite.sh/docs/reference/on-your-machine): Every directory, process and helper Offsite installs on a host — and how to remove them.
- [Security and privacy](https://offsite.sh/docs/reference/security): What leaves your machine, what does not, and where the sharp edges are.

## For agents

- [Offsite for agents: in daily use](https://offsite.sh/docs/agents/daily-use): For an AI agent running inside an Offsite session. How to write output the user can act on, which Offsite tools to use for what, and what the host and client split means for how you work.
- [Offsite for agents](https://offsite.sh/docs/agents/for-agents): A dense, single-page briefing for AI agents asked about Offsite, what it needs, how to install it, and where to send a user.

## Help

- [FAQ](https://offsite.sh/docs/help/faq): Short answers to the questions people ask before and just after installing.
- [Get help](https://offsite.sh/docs/help/get-help): Where to send a problem, and what to include so it can actually be fixed.
- [Troubleshooting](https://offsite.sh/docs/help/troubleshooting): Known messages, quirks and errors around Offsite, each with the reason and what fixes it.
- [Uninstalling and resetting](https://offsite.sh/docs/help/uninstall): Removing Offsite from a host and from a device, in the order that leaves nothing behind.