# LeapMux > A workspace for a fleet of coding agents. Run Claude Code, Codex, and more side by side, each in its own git worktree and branch, with end-to-end-encrypted traffic to your agents. ## User Manual ### Getting Started - [Introduction](https://leapmux.dev/docs/getting-started/introduction/): What LeapMux is, the problem it solves, who it is for, the coding agents it supports, and how this manual is organized. - [Concepts & Architecture](https://leapmux.dev/docs/getting-started/concepts/): How LeapMux is built: the Hub, Worker, and Frontend, the solo and distributed deployment shapes, and the org, workspace, tile, tab, and worktree model. - [Installation](https://leapmux.dev/docs/getting-started/installation/): Ways to install LeapMux: the desktop app for macOS, Linux, and Windows, the leapmux binary, and Docker images for a self-hosted server and agent machines. - [Quick Start](https://leapmux.dev/docs/getting-started/quick-start/): Go from zero to a working coding agent in minutes: launch LeapMux in solo mode, open an agent, send your first message, and open a terminal beside it. ### Using LeapMux - [Accounts & Authentication](https://leapmux.dev/docs/using/accounts/): Getting into LeapMux as a user: when you need an account, creating the first one, signing up and logging in, email verification, OAuth, and your profile. - [Organizations & Members](https://leapmux.dev/docs/using/organizations/): What an organization is in LeapMux, how it appears in the URL, the Owner, Admin, and Member roles and what each can do, and how to manage members and orgs. - [Workspaces](https://leapmux.dev/docs/using/workspaces/): The top-level container in LeapMux for tiled agent, terminal, and file tabs: create, rename, delete, organize, share, and switch between workspaces. - [Tabs & Layout](https://leapmux.dev/docs/using/tabs-and-layout/): Build a workspace layout in LeapMux: divide the canvas into tiles, fill them with agent, terminal, and file tabs, arrange splits and grids, and float panes. - [Coding Agents](https://leapmux.dev/docs/using/coding-agents/): Run coding-assistant CLIs like Claude Code and Codex in LeapMux: open an agent, chat, read tool calls, answer permission prompts, and switch models mid-session. - [Worktrees & Branches](https://leapmux.dev/docs/using/worktrees-and-branches/): Run many agents on one repo without conflicts using git worktrees: pick a branch or worktree when opening a tab, change it, push, and protect uncommitted work. - [Terminals](https://leapmux.dev/docs/using/terminals/): Full shell terminals in LeapMux that run on a Worker and stream over the end-to-end-encrypted channel: open one, use it, and keep it across reconnects. - [File Browser](https://leapmux.dev/docs/using/file-browser/): The git-aware file browser and read-only viewer in LeapMux: browse the tree with live git status, open files as tabs, and view inline diffs, even remotely. - [Collaboration & Presence](https://leapmux.dev/docs/using/collaboration/): How LeapMux keeps a workspace layout in sync across your devices in near-real-time, what a read-only share exposes, and how the turn-end sound is chosen. - [Settings & Preferences](https://leapmux.dev/docs/using/settings/): Every setting in the Preferences and Profile dialogs: appearance, terminal theme, diff view, turn-end sound, fonts, profile, password, and OAuth links. - [Keyboard Shortcuts](https://leapmux.dev/docs/using/keyboard-shortcuts/): How the VS Code-style shortcut system works in LeapMux, every default key binding by context, and the override format for customizing them. ### Running & Operating - [Running LeapMux](https://leapmux.dev/docs/operating/running-leapmux/): Operator guide to the solo, hub, worker, and dev modes: what each does, how to launch it, where it stores data, and how to run under Docker or a proxy. - [Configuration](https://leapmux.dev/docs/operating/configuration/): The complete configuration reference for the LeapMux Hub and Worker: how settings resolve, every config key and default, storage backends, and encryption mode. - [Managing Workers](https://leapmux.dev/docs/operating/managing-workers/): How a Worker connects out to a Hub, how to register and approve one, how Worker status shows in the UI, and how TOFU key pinning guards against a malicious Hub. - [Admin CLI](https://leapmux.dev/docs/operating/admin-cli/): Use leapmux admin to manage a Hub database and encryption keys directly: create users, reset passwords, mint and revoke tokens, add OAuth, and rotate keys. - [Authentication Providers](https://leapmux.dev/docs/operating/authentication-providers/): Configure OAuth/OIDC single sign-on for a LeapMux Hub so users can log in with GitHub, Google, Apple, or any standards-compliant OpenID Connect provider. - [Encryption & Data](https://leapmux.dev/docs/operating/encryption-and-data/): What LeapMux stores and encrypts at rest, how to rotate encryption keys, how database migrations work, and how to back up and restore a Hub safely. - [Security & Threat Model](https://leapmux.dev/docs/operating/security/): LeapMux trust model and end-to-end encryption: how browser-to-agent traffic is protected, how Worker identity is pinned, and the steps to operate it safely. - [Remote Control CLI](https://leapmux.dev/docs/operating/remote-control-cli/): Drive LeapMux from a script, CI job, or another agent with leapmux remote: open tabs, message agents, type into terminals, reshape layouts, and stream events. ### Reference - [CLI Reference](https://leapmux.dev/docs/reference/cli-reference/): A quick-lookup cheat-sheet for the leapmux command line: every daemon mode and its flags, the version command, and the environment variables LeapMux reads. - [Troubleshooting](https://leapmux.dev/docs/reference/troubleshooting/): A symptom-to-fix reference for LeapMux: common problems with their likely cause and the exact fix, grouped by area, using real flags and messages. - [FAQ](https://leapmux.dev/docs/reference/faq/): Short answers to the questions asked most often about LeapMux, each linking to the chapter that covers the topic in full. - [Glossary](https://leapmux.dev/docs/reference/glossary/): Short, alphabetical definitions of the terms used throughout the LeapMux manual, each linking to the chapter that covers it in depth. - [Legal](https://leapmux.dev/docs/reference/legal/): License, trademark, third-party attribution, and privacy information for LeapMux, including a summary of the FSL-1.1-ALv2 license terms. --- Generated on 2026-06-26 16:29:48 UTC Site: https://leapmux.dev/