# Offsite > Offsite is an agentic development environment. A host (macOS or Linux) runs > coding-agent and terminal sessions in tmux; native macOS, iOS and watchOS > 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://docs.offsite.sh/agents/for-agents/ for a single-page briefing, or https://docs.offsite.sh/llms-full.txt for the complete documentation in one request. ## Start here - [The big picture](https://docs.offsite.sh/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://docs.offsite.sh/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://docs.offsite.sh/start/install/): Download the Mac app, set up This Mac as your first host, and pair your iPhone by scanning a QR code. - [Hosts, sessions and clients](https://docs.offsite.sh/start/overview/): The three pieces every other page in these docs builds on. - [Prerequisites](https://docs.offsite.sh/start/prerequisites/): What you need before installing Offsite, per platform, with what Offsite sets up for you automatically. - [Updating Offsite](https://docs.offsite.sh/start/updating/): How the app and the host update, why their versions have to match, and what a mismatch looks like. - [What macOS will ask you](https://docs.offsite.sh/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://docs.offsite.sh/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://docs.offsite.sh/hosts/fleet/): Running more than one host, switching between them, and what "warm" means in the host list. - [Keep the host awake](https://docs.offsite.sh/hosts/keep-awake/): Stopping a Mac host from sleeping while your agents work — timed, reversible, and visible in the toolbar. - [A Linux host](https://docs.offsite.sh/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://docs.offsite.sh/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://docs.offsite.sh/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://docs.offsite.sh/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. - [Hand off and ask](https://docs.offsite.sh/work/handoff-and-ask/): Moving context between agent sessions — and why one session can never type into another. - [The Icebox](https://docs.offsite.sh/work/icebox/): Parking an agent session off the board without ending it — and getting it back where it was. - [Cards that name themselves](https://docs.offsite.sh/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://docs.offsite.sh/work/sessions/): What a session actually is on the host, what kills it, and what does not. - [Workspaces](https://docs.offsite.sh/work/workspaces/): One folder, one board, its own sessions — and why a workspace does not need to be a git repository. - [Worktrees](https://docs.offsite.sh/work/worktrees/): One branch, one folder, one agent per task — worktrees let several agents work on the same repository at the same time. ## The board - [Marking up what you send](https://docs.offsite.sh/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://docs.offsite.sh/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://docs.offsite.sh/board/fullscreen/): Giving one card the whole window without losing sight of the others. - [Keyboard control](https://docs.offsite.sh/board/keyboard/): Driving the board without the mouse — and why every Offsite shortcut contains Command. - [Tabs](https://docs.offsite.sh/board/tabs/): The tab bar for cards you want reachable but not on screen. - [Dark mode, light mode and themes](https://docs.offsite.sh/board/themes/): Appearance, the built-in themes, and the difference between app colours and terminal colours. - [Sending files to a session](https://docs.offsite.sh/board/upload/): Getting screenshots, logs and documents from your Mac or phone into an agent's hands. ## Cards & tools - [The Agent Browser card](https://docs.offsite.sh/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://docs.offsite.sh/cards/browser/): Your own browser, on the device in your hand, pointed at the dev server on your host, with tabs, dev tools, and a way to mark what is wrong and hand it to an agent. - [Deploy to this phone](https://docs.offsite.sh/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://docs.offsite.sh/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://docs.offsite.sh/cards/git/): Reviewing what your agent changed, staging it, committing and pushing — from any device. - [The Simulator card](https://docs.offsite.sh/cards/simulator/): A live iOS Simulator from the host, mirrored onto your board and driven with your taps. - [Workspace Actions](https://docs.offsite.sh/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://docs.offsite.sh/testing/testing/): Three ways the thing your agent just built reaches the device in your hand. ## Phone & Watch - [The iOS command bar](https://docs.offsite.sh/mobile/command-bar/): The row above the keyboard that makes a terminal usable with thumbs. - [The iPhone and iPad app](https://docs.offsite.sh/mobile/iphone/): The same sessions, the same board, sized for a device you hold. - [Notifications](https://docs.offsite.sh/mobile/notifications/): What Offsite tells you about, on which device, and why it is not screen scraping. - [Voice input](https://docs.offsite.sh/mobile/voice/): Dictating prompts on iPhone and Watch, with live transcription and a fallback for bad networks. - [Apple Watch](https://docs.offsite.sh/mobile/watch/): Answering an agent from your wrist — notifications, tap answers, dictation and a live complication. ## Connectivity - [Pairing devices](https://docs.offsite.sh/connect/pairing/): How a device is authorised to reach a host — the QR code, the one-time token, and why one code pairs one device. - [How your devices reach your host](https://docs.offsite.sh/connect/paths/): Three possible paths, raced against each other, switched live — and a pill that always names the winner. - [The relay](https://docs.offsite.sh/connect/relay/): What the relay is, exactly what it can and cannot see, and how to switch it off. ## Computer Use - [Computer Use](https://docs.offsite.sh/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://docs.offsite.sh/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://docs.offsite.sh/reference/on-your-machine/): Every directory, process and helper Offsite installs on a host — and how to remove them. - [Security and privacy](https://docs.offsite.sh/reference/security/): What leaves your machine, what does not, and where the sharp edges are. ## For agents - [Offsite for agents](https://docs.offsite.sh/agents/for-agents/): A dense, single-page briefing for AI agents asked about Offsite or running inside it. ## Help - [FAQ](https://docs.offsite.sh/help/faq/): Short answers to the questions people ask before and just after installing. - [Get help](https://docs.offsite.sh/help/get-help/): Where to send a problem, and what to include so it can actually be fixed. - [Troubleshooting](https://docs.offsite.sh/help/troubleshooting/): Known messages, quirks and errors around Offsite, each with the reason and what fixes it. - [Uninstalling and resetting](https://docs.offsite.sh/help/uninstall/): Removing Offsite from a host and from a device, in the order that leaves nothing behind.