> ## Documentation Index > > Fetch the complete documentation index at: [/docs/llms.txt](/content/docs/llms.txt) > > Use this file to discover all available pages before exploring further. [Skip to main content](/content/docs/devbox#content-area/index.html) Assistant Responses are generated using AI and may contain mistakes. Devboxes are managed Linux and macOS development environments for people and AI coding agents. Each Devbox is a remote machine with persistent storage, reachable over SSH or from your local IDE.Linux Devboxes run from a container image you choose and include Docker. macOS Devboxes run on Apple Silicon, with a choice of macOS and Xcode versions. Because the environment comes from a shared definition, your team and your agents work on the same setup. [**With an agent** \\ \\ Let a coding agent install the CLI and create your first Devbox.](/content/docs/devbox#getting-started/index.html) [**With the CLI** \\ \\ Install the CLI, create a Devbox, and start an agent in a session.](/content/docs/devbox#getting-started-cli/index.html) [**With the Dashboard** \\ \\ Create a Devbox in the browser, with nothing to install.](/content/docs/devbox#getting-started-dashboard/index.html) ## [​](/content/docs/devbox\#getting-started/index.html) Get Started with an Agent The quickest way to get started is to let a coding agent do it for you. 1 [Navigate to header](/content/docs/devbox#install-the-agent-skill/index.html) ### Install the agent skill Install the [Namespace devboxes skill](/content/docs/reference/devbox-cli/agent-skills/index.html) for your coding agent. - Global - Project Installs the skill for every project on this machine: ``` npx skills add namespacelabs/agent-skills --global ``` Installs the skill into the current project only. Run this from the project directory: ``` npx skills add namespacelabs/agent-skills ``` The skill gives the agent a repeatable workflow for creating Devboxes, loading source code, running commands, and cleaning up after the task. 2 [Navigate to header](/content/docs/devbox#create-a-devbox-with-the-agent/index.html) ### Create a Devbox with the agent Ask your agent to create a Devbox: Agent Prompt ``` create a devbox ``` If the [Devbox CLI](/content/docs/reference/devbox-cli/index.html) is not installed, the agent installs it and runs `devbox login`. Complete the login in your browser when prompted. ## [​](/content/docs/devbox\#getting-started-cli/index.html) Get Started with the CLI Follow these steps to install the CLI and create a Devbox from your terminal. 1 [Navigate to header](/content/docs/devbox#install-the-devbox-cli/index.html) ### Install the Devbox CLI - macOS - Linux - Windows ``` curl -fsSL get.namespace.so/devbox/install.sh | bash ``` ``` curl -fsSL get.namespace.so/devbox/install.sh | bash ``` Run the following command in PowerShell: ``` irm https://get.namespace.so/devbox/install.ps1 | iex ``` Restart your terminal if `devbox` is not available on your `PATH` after installation.Connecting over SSH also requires an [OpenSSH client](https://learn.microsoft.com/windows-server/administration/openssh/openssh_install_firstuse). Most modern Windows installations include one. Confirm the installation: ``` devbox version ``` 2 [Navigate to header](/content/docs/devbox#authenticate-with-namespace/index.html) ### Authenticate with Namespace ``` devbox login ``` The command prints a login URL and opens it in your browser. Complete the flow there, and the CLI stores a user credential in your operating system’s user configuration directory.Check the stored credential at any time: ``` devbox auth check ``` 3 [Navigate to header](/content/docs/devbox#create-a-devbox/index.html) ### Create a Devbox `devbox create` provisions a Devbox and activates it, so it is ready to connect to when the command returns. Supply its configuration interactively or as flags. - Interactive - Non-interactive The CLI prompts for a name, an image, and a machine size: ``` devbox create --checkout github.com/your-org/your-repo ``` Pass every value as a flag to skip the prompts: ``` devbox create --name my-devbox --image builtin:default --size m --checkout github.com/your-org/your-repo ``` `--checkout` clones a repository into the Devbox and requires a [connected GitHub organization](/content/docs/devbox#getting-started-dashboard/index.html). Omitting it applies the workspace default repository, and `--no_checkout` skips the checkout entirely.See [`devbox create`](/content/docs/reference/devbox-cli/create/index.html) for the full set of options, including Blueprints, ephemeral Devboxes, and specification files. 4 [Navigate to header](/content/docs/devbox#connect-to-your-devbox/index.html) ### Connect to your Devbox Connect to a [session](/content/docs/devbox/connecting#sessions/index.html) on the Devbox. A session keeps running when you close your terminal or disconnect, so work you start in it carries on without you. ``` devbox session connect --session agent ``` The CLI lists your Devboxes and their sessions, with an option to start a new session. Connecting to a stopped Devbox starts it first, and your files persist across stop and start cycles. 5 [Navigate to header](/content/docs/devbox#start-your-favorite-agent/index.html) ### Start your favorite agent Start a coding agent in the Devbox and give it a task. The agent works on the Devbox itself, with its own files, tools, and terminal: - Amp - Claude Code - Codex - Copilot - Cursor - OpenCode ``` amp ``` ``` claude ``` ``` codex ``` ``` copilot ``` ``` cursor-agent ``` ``` opencode ``` ## [​](/content/docs/devbox\#getting-started-dashboard/index.html) Get Started with the Dashboard The Dashboard needs no local installation. Follow these steps to create your first Devbox in the browser and open a shell in it. 1 [Navigate to header](/content/docs/devbox#connect-a-code-provider/index.html) ### Connect a code provider Open [Devboxes](https://cloud.namespace.so/workspace/devboxes) in the Namespace Dashboard and connect a code provider so Namespace can clone your repositories. Devboxes can check out from GitHub and [Cursor Origin](https://cursor.com/).If you have not connected a provider yet, choose one from the Devboxes page: - For GitHub, press **Connect with GitHub** and follow the instructions to install the Namespace GitHub app. - For Cursor Origin, press **Other providers**, then select Cursor Origin on the Code Providers page. After you connect a provider, use [Code Providers](https://cloud.namespace.so/workspace/code/providers) to connect another one. Connecting a provider lets Namespace clone your repositories into a Devbox, which is how you work on your own code. To look around first, select **create a Devbox from scratch** and connect a provider later. 2 [Navigate to header](/content/docs/devbox#create-a-devbox-2/index.html) ### Create a Devbox Press **\+ Create** on the Devboxes page. Give your Devbox a name or keep the generated one. Then press **Repository** and select the repository to check out. The list shows the repositories Namespace can reach through the GitHub app. If the one you want is missing, or you skipped the previous step, use the **Connect an organization** entry at the end of the list. Press **Create Devbox**. After a few seconds, your Devbox will be ready to use. 3 [Navigate to header](/content/docs/devbox#connect-and-develop/index.html) ### Connect and develop The Devbox page shows its state and its initialization log while it starts. Once the log reaches **Ready**, open the **Terminal** tab (for a shell in the Devbox without installing anything locally) and run `ls` to see the cloned files: ``` ls ``` 4 [Navigate to header](/content/docs/devbox#open-vs-code/index.html) ### Open VS Code Use the **Open VSCode** dropdown to open the Devbox in VS Code, Cursor, or VS Code for the Web. See [IDEs](/content/docs/devbox/ides/index.html) for the full list of supported editors, including JetBrains and Zed. ## [​](/content/docs/devbox\#next-steps/index.html) Next Steps [**Devbox Lifecycle** \\ \\ Create, list, stop, and delete Devboxes.](/content/docs/devbox/lifecycle/index.html) [**SSH & Sessions** \\ \\ Open a shell on a Devbox with SSH or a session.](/content/docs/devbox/connecting/index.html) [**IDEs** \\ \\ Open a Devbox in VS Code, Cursor, JetBrains, or Zed.](/content/docs/devbox/ides/index.html) [**Services** \\ \\ Keep dev servers and other processes running on a Devbox.](/content/docs/devbox/services/index.html) ## [​](/content/docs/devbox\#enterprise-support/index.html) Enterprise Support Need dedicated capacity, custom machine shapes, or specialized support for your development team? Contact our [support team](mailto:support@namespace.so) for consultation on complex development environment requirements. Last modified onOctober 16, 2026 Ctrl+I {"docsConfig":{"theme":"almond","$schema":"https://mintlify.com/docs.json","name":"Namespace Documentation","colors":{"primary":"#1C32FF","light":"#6B78FF","dark":"#1C32FF"},"logo":{"light":"https://mintcdn.com/namespace-labs/qOJQ7kaWRgoS8lyv/logo-light.svg?fit=max\\u0026auto=format\\u0026n=qOJQ7kaWRgoS8lyv\\u0026q=85\\u0026s=6827b0c81c335badc1cef13b83383e1d","dark":"https://mintcdn.com/namespace-labs/qOJQ7kaWRgoS8lyv/logo-dark.svg?fit=max\\u0026auto=format\\u0026n=qOJQ7kaWRgoS8lyv\\u0026q=85\\u0026s=63702d83d8fb259023deb79db06aabbb","href":"https://namespace.so"},"favicon":"https://mintcdn.com/namespace-labs/MoefQ379UcpNU680/favicon.svg?fit=max\\u0026auto=format\\u0026n=MoefQ379UcpNU680\\u0026q=85\\u0026s=6f14a088da55e5f41847845796737353","navbar":{"links":\[{"href":"https://namespace.so/changelog","label":"Changelog"},{"href":"https://namespace.so/support","label":"Support"}\],"primary":{"type":"button","label":"Log in","href":"https://cloud.namespace.so"}},"footer":{"socials":{"github":"https://github.com/namespacelabs","linkedin":"https://www.linkedin.com/company/namespacelabs","x":"https://x.com/namespacelabs"}},"icons":{"library":"lucide"},"contextual":{"options":\["copy","view","chatgpt","claude"\],"display":"header"},"interaction":{"drilldown":false},"metadata":{"timestamp":true},"styling":{"latex":true},"navigation":{"global":{"anchors":\[{"anchor":"Changelog","icon":"history","href":"https://namespace.so/changelog"},{"anchor":"Trust Center (SOC2)","icon":"shield-check","href":"https://trust.namespace.so/"},{"anchor":"Status","icon":"activity","href":"https://namespace-status.com/"},{"anchor":"Support","icon":"message-circle","href":"https://namespace.so/support"}\]},"pages":\[\]}},"deployment":{"deploymentMetadataValue":{"subdomain":"namespace-labs","hasAudioNarration":false,"actualSubdomain":"namespace-labs","customDomains":\["namespace.so"\],"gitSource":{"type":"github","owner":"namespacelabs","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6ae0862207896b4595e1934b","collectionId":"847aecca-4a0b-40b4-a393-e976cc214b43","liveDeploymentHistoryId":"6ae0862207896b4595e1934b","schemaVersion":"v3"},"entitlements":{"AI\_CHAT":{"status":"ENABLED"},"WEB\_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae0a8f6edbd4c098a94623c","clientVersion":"0.0.3971","searchFilterCounts":\[{"language":"default","tag":"Products","count":377},{"language":"default","tag":"CLI","count":166},{"language":"default","tag":"Command line","count":165},{"language":"default","tag":"Namespace CLI","count":131},{"language":"default","tag":"Documentation","count":104},{"language":"default","tag":"GitHub Actions","count":40},{"language":"default","tag":"Devbox CLI","count":34},{"language":"default","tag":"Integrations","count":33},{"language":"default","tag":"SDK","count":25},{"language":"default","tag":"Namespace SDK","count":23}\]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":\[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature\_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature\_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature\_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature\_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature\_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature\_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature\_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature\_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature\_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature\_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature\_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature\_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature\_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature\_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature\_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature\_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature\_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature\_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature\_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature\_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature\_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature\_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature\_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature\_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature\_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature\_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature\_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature\_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature\_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature\_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature\_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature\_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature\_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature\_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature\_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature\_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature\_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature\_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature\_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature\_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature\_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature\_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature\_enabled":true},"impressionData":false}\],"isAtlas":false,"googleFontsInlined":true},"customCss":\[{"filePath":"snippets/diagrams/styles.css","content":".ns-diagram{--ns-diagram-background:#ffffff;--ns-diagram-grid:#e5e7ee;--ns-diagram-border:#e5e7ee;--ns-diagram-card:#ffffff;--ns-diagram-neutral-zone:#fafbfc;--ns-diagram-brand-zone-start:rgba(28, 50, 255, 0.04);--ns-diagram-brand-zone-end:rgba(28, 50, 255, 0.07);--ns-diagram-brand-border:#c8ceff;--ns-diagram-heading:#202938;--ns-diagram-muted:#8892a6;--ns-diagram-copy:#4a5468;position:relative;width:100%;margin:2rem 0;padding:clamp(20px,3.5vw,32px);overflow:hidden;color:var(--ns-diagram-heading);background:var(--ns-diagram-background);border:1px solid var(--ns-diagram-border);border-radius:20px;box-shadow:0 1px 0 rgba(32,41,56,.04),0 1px 2px rgba(32,41,56,.06)}.dark .ns-diagram{--ns-diagram-background:#111827;--ns-diagram-grid:#374151;--ns-diagram-border:#374151;--ns-diagram-card:#1f2937;--ns-diagram-neutral-zone:#171f2d;--ns-diagram-brand-zone-start:rgba(107, 120, 255, 0.1);--ns-diagram-brand-zone-end:rgba(107, 120, 255, 0.16);--ns-diagram-brand-border:#4f5fc7;--ns-diagram-heading:#f3f4f6;--ns-diagram-muted:#aeb6c5;--ns-diagram-copy:#cbd5e1}.ns-diagram-grid-background{position:absolute;inset:0;pointer-events:none;background-image:radial-gradient(circle,var(--ns-diagram-grid) 1px,transparent 1px);background-size:16px 16px;opacity:.5;mask-image:linear-gradient(180deg,transparent 0,#000 10%,#000 90%,transparent 100%)}.ns-diagram-content{position:relative}.ns-diagram-caption{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border:0}.ns-diagram-mark{display:inline-flex;flex-shrink:0;align-items:center;justify-content:center;margin:0;border-radius:8px}.ns-diagram-mark-anthropic{color:#d97757;background:#fcefe8}.ns-diagram-mark-devin{color:#4338ca;background:#eef0ff}.ns-diagram-mark-cursor{color:#111827;background:#eef0f3}.ns-diagram-mark-control{color:#1c32ff;background:#e0e7ff}.ns-diagram-mark-terminal{color:#fff;background:#202938}.ns-diagram-mark-worker{color:#4338ca;background:#eef1ff}.ns-diagram-zone{position:relative;display:flex;flex-direction:column;padding:1.25rem;background:var(--ns-diagram-neutral-zone);border:1px dashed #d2d6e0;border-radius:14px}.dark .ns-diagram-zone{border-color:#4b5563}.ns-diagram-zone-brand{background:linear-gradient(180deg,var(--ns-diagram-brand-zone-start),var(--ns-diagram-brand-zone-end));border:1px solid var(--ns-diagram-brand-border)}.ns-diagram-zone-header{display:flex;align-items:center;gap:.5rem;margin-bottom:.75rem;color:var(--ns-diagram-copy);font-size:11px;font-weight:600;letter-spacing:.1em;text-transform:uppercase}.ns-diagram-zone-center{display:flex;flex:1;align-items:center}.ns-diagram-zone-center>\*{width:100%}.ns-diagram-card{position:relative;display:flex;align-items:center;gap:1rem;min-width:0;padding:1rem 1.25rem;background:var(--ns-diagram-card);border:1px solid var(--ns-diagram-border);border-radius:12px;box-shadow:0 1px 0 rgba(32,41,56,.04),0 1px 2px rgba(32,41,56,.06)}.ns-diagram-card-brand{border-color:var(--ns-diagram-brand-border)}.ns-diagram-card-copy{display:flex;min-width:0;flex-direction:column}.ns-diagram-card-label{color:var(--ns-diagram-heading);font-size:16px;font-weight:600;line-height:1.25;letter-spacing:-.01em}.ns-diagram-card-sublabel{margin-top:.125rem;color:var(--ns-diagram-muted);font-size:12px;line-height:1.35}.ns-managed-layout{display:grid;grid-template-columns:1fr auto 1.05fr;align-items:stretch}.ns-managed-connector{display:flex;width:64px;flex-direction:column;align-items:center;justify-content:center;padding:0 .25rem;color:var(--ns-diagram-muted);font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:10.5px}.ns-managed-connector>span{margin-bottom:.375rem}.ns-managed-connector-path{display:flex;width:56px;align-items:center}.ns-managed-connector-line{flex:1;height:1.5px;background:#d2d6e0}.ns-managed-connector-arrow{border-top:6px solid transparent;border-bottom:6px solid transparent;border-left:9px solid #d2d6e0}.ns-mini-connector{display:flex;flex-direction:column;align-items:center;padding:.375rem 0}.ns-mini-connector>div{width:1.5px;height:12px;background:var(--ns-diagram-brand-border)}.ns-mini-connector>span{border-top:7px solid var(--ns-diagram-brand-border);border-right:5px solid transparent;border-left:5px solid transparent}.ns-devin-devboxes,.ns-devin-sessions{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));gap:1.5rem}.ns-devin-mobile-layout{display:none}.ns-devin-connectors,.ns-devin-connectors>div{display:grid;grid-template-columns:repeat(2,minmax(0,1fr))}.ns-devin-connectors{gap:1.5rem}.ns-devin-connectors>div{padding:0 1rem}.ns-devin-connector{position:relative;display:flex;min-height:110px;align-items:center;justify-content:center;color:var(--ns-diagram-copy);font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:10px;line-height:1.25;text-align:center}.ns-devin-management-connector{min-height:70px;color:#6366f1}.ns-devin-connector-line{position:absolute;top:0;bottom:0;left:50%;width:1.5px;background:#d2d6e0;transform:translateX(-50%)}.ns-devin-management-connector .ns-devin-connector-line,.ns-diagram-connector-dashed .ns-diagram-vertical-line{width:0;background:0 0;border-left:1.5px dashed var(--ns-diagram-brand-border)}.ns-devin-connector>span,.ns-diagram-vertical-connector>span{position:relative;z-index:1;padding:0 .375rem;background:var(--ns-diagram-background)}.ns-control-plane-pill{display:flex;align-items:center;align-self:center;gap:.375rem;margin-bottom:1rem;padding:.375rem .75rem;color:#4338ca;background:#eef1ff;border:1px solid var(--ns-diagram-brand-border);border-radius:999px;font-size:12px;font-weight:500}.ns-diagram-vertical-connector{position:relative;display:flex;align-items:center;justify-content:center;color:var(--ns-diagram-copy);font-family:ui-monospace,SFMono-Regular,Menlo,Monaco,Consolas,monospace;font-size:10px;line-height:1.25;text-align:center}.ns-diagram-vertical-line{position:absolute;top:0;bottom:0;left:50%;width:1.5px;background:#d2d6e0;transform:translateX(-50%)}.ns-diagram-connector-dashed{color:#6366f1}.ns-diagram-arrow-down{position:absolute;bottom:0;left:50%;border-top:8px solid #d2d6e0;border-right:5px solid transparent;border-left:5px solid transparent;transform:translateX(-50%)}.ns-devin-management-connector .ns-diagram-arrow-down,.ns-diagram-connector-dashed .ns-diagram-arrow-down{border-top-color:var(--ns-diagram-brand-border)}.ns-bazel-connector-inset{padding:0 1rem}.ns-bazel-workers{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:1rem}@media (max-width:767px){.ns-managed-layout{grid-template-columns:1fr}.ns-managed-connector{position:relative;width:auto;min-height:64px;padding:.5rem 0}.ns-managed-connector-path{width:auto;flex-direction:column}.ns-managed-connector-line{width:1.5px;height:24px;flex:none}.ns-managed-connector-arrow{border-top:9px solid #d2d6e0;border-right:6px solid transparent;border-bottom:0;border-left:6px solid transparent}.ns-devin-connectors,.ns-devin-devboxes,.ns-devin-sessions{grid-template-columns:1fr}.ns-devin-desktop-layout{display:none}.ns-devin-mobile-layout{display:block}.ns-devin-mobile-lane+.ns-devin-mobile-lane{margin-top:1.5rem;padding-top:1.5rem;border-top:1px solid var(--ns-diagram-border)}.ns-devin-mobile-connectors{display:grid;grid-template-columns:repeat(2,minmax(0,1fr));padding:0 .5rem}.ns-devin-connector{min-height:80px}.ns-bazel-workers{grid-template-columns:1fr}}"},{"filePath":"style.css","content":":root{--namespace-radius-inline:0.25rem;--namespace-radius-control:0.375rem;--namespace-radius-container:0.5rem}#content-container,.almond-layout>div,.card,.chat-assistant-floating-input>div,.code-block,.frame,.pagination-next,.pagination-prev{border-radius:var(--namespace-radius-container)}.code-block \[data-component-part=code-block-root\],.frame>div{border-radius:inherit}#assistant-entry,#chat-assistant-textarea,#search-bar-entry,#search-input,.callout,.frame>.relative{border-radius:var(--namespace-radius-control)}.code-block-fade-overlay{border-radius:0 var(--namespace-radius-container) var(--namespace-radius-container) 0}#page-context-menu>button:first-child{border-radius:var(--namespace-radius-control) 0 0 var(--namespace-radius-control)}#page-context-menu>button:last-child{border-radius:0 var(--namespace-radius-control) var(--namespace-radius-control) 0}#content :not(pre)>code,#navigation-items li>a,#navigation-items li>button{border-radius:var(--namespace-radius-inline)}#navigation-items .nav-anchor>:is(svg, img),#navigation-items .sidebar-group-icon,#navigation-items \[data-component-part=scroll-area-content\]:has(>ul.nav-anchors),#navigation-items li>:is(a, button)>div\[class~=\\"h-\[1lh\]\\"\]:first-child{display:flex;flex-direction:column}#navigation-items \[data-component-part=scroll-area-content\]>ul.nav-anchors{order:1;margin-top:1rem;padding-top:1rem;border-top:1px solid color-mix(in srgb,currentColor 10%,transparent)}#navigation-items \[data-component-part=scroll-area-content\]>ul.sidebar-group{margin-top:.5rem}#navigation-items \[data-component-part=scroll-area-content\]>ul.sidebar-group+div{margin-top:1rem}.tab-container{overflow:hidden;padding:0 1rem 1rem;border:1px solid color-mix(in srgb,currentColor 12%,transparent);border-radius:var(--namespace-radius-container)}.tab-container \[data-component-part=tab-content\]>\[data-table-wrapper\]:last-child{margin-bottom:0;padding-bottom:0}#content .katex-display>.katex{text-align:left}.compact-table table td{min-width:0}#navigation-items ul.sidebar-group>li.space-y-px+li.space-y-px{margin-top:.75rem}#navigation-items .my-2>.sidebar-group-header{margin-bottom:.625rem;font-size:.8125rem;line-height:1.625rem;font-weight:600;letter-spacing:-.02em;text-transform:none;opacity:1}#navigation-items ul.sidebar-group>li.space-y-px>button{font-size:.8125rem;font-weight:600;letter-spacing:-.02em;background-color:transparent}#navigation-items ul.sidebar-group>li.space-y-px>button:hover,#navigation-items ul.sidebar-group>li.space-y-px>ul>li.space-y-px>button:hover{background-color:color-mix(in srgb,currentColor 6%,transparent)}#navigation-items ul.sidebar-group>li.space-y-px>ul>li.space-y-px>button,#navigation-items ul.sidebar-group>li.space-y-px>ul>li>a{padding-left:3rem!important;font-size:.8125rem;font-weight:400;letter-spacing:-.02em}#navigation-items ul.sidebar-group>li.space-y-px>ul>li.space-y-px>ul>li\[data-active-nav-item=true\]>a,#navigation-items ul.sidebar-group>li.space-y-px>ul>li\[data-active-nav-item=true\]>a{color:#121516!important;background-color:rgb(18 21 22/6%)!important}.dark #navigation-items ul.sidebar-group>li.space-y-px>ul>li.space-y-px>ul>li\[data-active-nav-item=true\]>a,.dark #navigation-items ul.sidebar-group>li.space-y-px>ul>li\[data-active-nav-item=true\]>a{color:#f4f4f5!important;background-color:rgb(255 255 255/8%)!important}#navigation-items ul.sidebar-group>li.space-y-px>ul>li.space-y-px>button{background-color:transparent}#navigation-items ul.sidebar-group>li.space-y-px>ul>li.space-y-px>button>div\[class~=\\"h-\[1lh\]\\"\]:first-child{margin-left:-1.75rem}.dark #navigation-items img\[src\*=buildkite-mark\]{filter:brightness(.7)}.dark img\[src\*=\\"/icons/apple.svg\\"\]{filter:invert(1)}.dark img.tab-icon\[src\*=\\"/icons/linux.svg\\"\]{filter:invert(.35) brightness(1.54)}#navigation-items ul.sidebar-group>li.space-y-px>ul>li.space-y-px>ul>li>a{padding-left:4rem!important;font-size:.8125rem;font-weight:400;letter-spacing:-.02em}@media (min-width:1024px){#sidebar-content{width:calc(16.5rem + 10px)}#content-container{margin-left:calc(16.5rem + 10px)}#navbar{container-type:inline-size}#navbar .nav-tabs{position:fixed;top:0;left:20rem;height:3.5rem;column-gap:2rem}#navbar div:has(>div>.nav-tabs){justify-content:flex-end}@container (max-width: 69rem){#navbar .navbar-link:has(>a\[href=\\"https://namespace.so/changelog\\"\]){display:none}}}@media (min-width:1280px){#content-container{padding-right:1.5rem;padding-left:3rem}#content-container>div{column-gap:1.5rem;justify-content:flex-start}#content-area{width:calc(100% - 13.5rem);max-width:52rem;flex:none}#content-side-layout{width:15rem;max-width:15rem;flex-basis:15rem}#content-side-layout>div{width:15rem;padding-left:1rem}#content-side-layout>div>div{width:14rem}}@media (min-width:1700px){#content-container>div{justify-content:center}}"},{"filePath":"reference/github-actions/runner-configuration.css","content":""},{"filePath":"workspaces/access.css","content":""},{"filePath":"platform/workspaces/access.css","content":""},{"filePath":"reference/devbox-cli/desktop.css","content":""}\],"page":{"pagePath":"devbox","slug":"/devbox","pageMetadata":{"title":"High-Performance Developer Environments with Devboxes","sidebarTitle":"Getting Started","description":null,"href":"/devbox/index"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\\"use strict\\";const{Fragment:\_Fragment,jsx:\_jsx,jsxs:\_jsxs}=arguments\[0\];const{useMDXComponents:\_provideComponents}=arguments\[0\];const KeepTabPosition=()=>{useEffect(()=>{const stateKey=\`\_\_namespaceKeepTabPosition\`;const releaseState=state=>{state.instances-=1;if(state.instances>0)return;state.removeListeners();if(window\[stateKey\]===state)delete window\[stateKey\]};const existingState=window\[stateKey\];if(existingState){existingState.instances+=1;return()=>releaseState(existingState)}const maxSettleTime=250;const requiredStableFrames=3;const positionTolerance=.5;let animationFrame;let observer;let settleDeadline;let stableFrames=0;let tabListToKeep;let tabListTop;const findTab=event=>{if(!(event.target instanceof Element))return null;return event.target.closest(\`.tab-container \[role='tab'\]\`)};const findScrollContainer=element=>{for(let parent=element.parentElement;parent;parent=parent.parentElement){const{overflowY}=getComputedStyle(parent);if((overflowY===\`auto\`\|\|overflowY===\`scroll\`)\\u0026\\u0026parent.scrollHeight>parent.clientHeight){return parent}}return null};const stopKeepingPosition=()=>{if(animationFrame)cancelAnimationFrame(animationFrame);animationFrame=undefined;observer?.disconnect();tabListToKeep=undefined};const restoreTabListPosition=()=>{if(!tabListToKeep?.isConnected)return 0;const offset=tabListToKeep.getBoundingClientRect().top-tabListTop;if(Math.abs(offset)\\u003cpositionTolerance)return offset;const scrollOptions={top:offset,behavior:\`instant\`};const scrollContainer=findScrollContainer(tabListToKeep);if(scrollContainer){scrollContainer.scrollBy(scrollOptions)}else{window.scrollBy(scrollOptions)}return offset};const settlePosition=()=>{const offset=restoreTabListPosition();stableFrames=Math.abs(offset)\\u003cpositionTolerance?stableFrames+1:0;if(stableFrames>=requiredStableFrames\|\|performance.now()>=settleDeadline){stopKeepingPosition();return}animationFrame=requestAnimationFrame(settlePosition)};observer=new MutationObserver(()=>{stableFrames=0;restoreTabListPosition()});const keepTabListInPlace=tab=>{stopKeepingPosition();tabListToKeep=tab.closest(\`\[role='tablist'\]\`);if(!tabListToKeep)return;tabListTop=tabListToKeep.getBoundingClientRect().top;settleDeadline=performance.now()+maxSettleTime;stableFrames=0;observer.observe(document.getElementById(\`content\`)??document.documentElement,{attributes:true,attributeFilter:\[\`aria-selected\`,\`class\`\],childList:true,subtree:true});animationFrame=requestAnimationFrame(settlePosition)};const selectWithoutNavigation=event=>{if(!event.isTrusted)return;const tab=findTab(event);if(!tab)return;keepTabListInPlace(tab);event.preventDefault();event.stopPropagation();tab.click();restoreTabListPosition()};const selectWithKeyboard=event=>{if(!event.isTrusted)return;const tab=findTab(event);const tabList=tab?.closest(\`\[role='tablist'\]\`);if(!tab\|\|!tabList)return;const tabs=Array.from(tabList.querySelectorAll(\`:scope > \[role='tab'\]\`));const currentIndex=tabs.indexOf(tab);let nextIndex;switch(event.key){case\`ArrowLeft\`:nextIndex=(currentIndex-1+tabs.length)%tabs.length;break;case\`ArrowRight\`:nextIndex=(currentIndex+1)%tabs.length;break;case\`Home\`:nextIndex=0;break;case\`End\`:nextIndex=tabs.length-1;break;case\`Enter\`:case\` \`:nextIndex=currentIndex;break;default:return}keepTabListInPlace(tab);event.preventDefault();event.stopPropagation();tabs\[nextIndex\]?.click();tabs\[nextIndex\]?.focus({preventScroll:true});restoreTabListPosition()};document.addEventListener(\`click\`,selectWithoutNavigation,true);document.addEventListener(\`keydown\`,selectWithKeyboard,true);const state={instances:1,removeListeners:()=>{stopKeepingPosition();document.removeEventListener(\`click\`,selectWithoutNavigation,true);document.removeEventListener(\`keydown\`,selectWithKeyboard,true)}};window\[stateKey\]=state;return()=>releaseState(state)},\[\]);return null};function \_createMdxContent(props){const \_components={a:\`a\`,code:\`code\`,li:\`li\`,p:\`p\`,pre:\`pre\`,span:\`span\`,strong:\`strong\`,ul:\`ul\`,...\_provideComponents(),...props.components},{Card,CardGroup,CodeBlock,Frame,Heading,Info,OptimizedImage,Step,Steps,Tab,Tabs,\_MdxComponentBoundary}=\_components;if(!Card)\_missingMdxReference(\`Card\`,true);if(!CardGroup)\_missingMdxReference(\`CardGroup\`,true);if(!CodeBlock)\_missingMdxReference(\`CodeBlock\`,true);if(!Frame)\_missingMdxReference(\`Frame\`,true);if(!Heading)\_missingMdxReference(\`Heading\`,true);if(!Info)\_missingMdxReference(\`Info\`,true);if(!OptimizedImage)\_missingMdxReference(\`OptimizedImage\`,true);if(!Step)\_missingMdxReference(\`Step\`,true);if(!Steps)\_missingMdxReference(\`Steps\`,true);if(!Tab)\_missingMdxReference(\`Tab\`,true);if(!Tabs)\_missingMdxReference(\`Tabs\`,true);if(!\_MdxComponentBoundary)\_missingMdxReference(\`\_MdxComponentBoundary\`,true);return \_jsxs(\_Fragment,{children:\[\_jsx(\_MdxComponentBoundary,{name:\`KeepTabPosition\`,children:\_jsx(KeepTabPosition,{})}),\`\\n\`,\_jsx(\_components.p,{children:\`Devboxes are managed Linux and macOS development environments for people and AI coding agents. Each Devbox is a remote machine with persistent storage, reachable over SSH or from your local IDE.\`}),\`\\n\`,\_jsx(\_components.p,{children:\`Linux Devboxes run from a container image you choose and include Docker. macOS Devboxes run on Apple Silicon, with a choice of macOS and Xcode versions. Because the environment comes from a shared definition, your team and your agents work on the same setup.\`}),\`\\n\`,\_jsxs(CardGroup,{cols:3,children:\[\_jsx(Card,{title:\`With an agent\`,icon:\`bot\`,href:\`#getting-started\`,children:\_jsx(\_components.p,{children:\`Let a coding agent install the CLI and create your first Devbox.\`})}),\_jsx(Card,{title:\`With the CLI\`,icon:\`terminal\`,href:\`#getting-started-cli\`,children:\_jsx(\_components.p,{children:\`Install the CLI, create a Devbox, and start an agent in a session.\`})}),\_jsx(Card,{title:\`With the Dashboard\`,icon:\`layout-dashboard\`,href:\`#getting-started-dashboard\`,children:\_jsx(\_components.p,{children:\`Create a Devbox in the browser, with nothing to install.\`})})\]}),\`\\n\`,\_jsx(Heading,{level:\`2\`,id:\`getting-started\`,children:\`Get Started with an Agent\`}),\`\\n\`,\_jsx(\_components.p,{children:\`The quickest way to get started is to let a coding agent do it for you.\`}),\`\\n\`,\_jsxs(Steps,{titleSize:\`h3\`,children:\[\_jsxs(Step,{title:\`Install the agent skill\`,id:\`install-the-agent-skill\`,children:\[\_jsxs(\_components.p,{children:\[\`Install the \`,\_jsx(\_components.a,{href:\`/reference/devbox-cli/agent-skills\`,children:\`Namespace devboxes skill\`}),\` for your coding agent.\`\]}),\_jsxs(Tabs,{children:\[\_jsxs(Tab,{title:\`Global\`,id:\`global\`,children:\[\_jsx(\_components.p,{children:\`Installs the skill for every project on this machine:\`}),\_jsx(CodeBlock,{filename:\`\`,numberOfLines:\`1\`,language:\`shellscript\`,children:\_jsx(\_components.pre,{className:\`shiki shiki-themes github-light-default dark-plus\`,style:{backgroundColor:\`#ffffff\`,\\"--shiki-dark-bg\\":\`#0B0C0E\`,color:\`#1f2328\`,\\"--shiki-dark\\":\`#D4D4D4\`},language:\`shellscript\`,children:\_jsxs(\_components.code,{language:\`shellscript\`,numberOfLines:\`1\`,children:\[\_jsxs(\_components.span,{className:\`line\`,children:\[\_jsx(\_components.span,{style:{color:\`#953800\`,\\"--shiki-dark\\":\`#DCDCAA\`},children:\`npx\`}),\_jsx(\_components.span,{style:{color:\`#0A3069\`,\\"--shiki-dark\\":\`#CE9178\`},children:\` skills\`}),\_jsx(\_components.span,{style:{color:\`#0A3069\`,\\"--shiki-dark\\":\`#CE9178\`},children:\` add\`}),\_jsx(\_components.span,{style:{color:\`#0A3069\`,\\"--shiki-dark\\":\`#CE9178\`},children:\` namespacelabs/agent-skills\`}),\_jsx(\_components.span,{style:{color:\`#0550AE\`,\\"--shiki-dark\\":\`#569CD6\`},children:\` --global\`})\]}),\`\\n\`\]})})})\]}),\_jsxs(Tab,{title:\`Project\`,id:\`project\`,children:\[\_jsx(\_components.p,{children:\`Installs the skill into the current project only. Run this from the project directory:\`}),\_jsx(CodeBlock,{filename:\`\`,numberOfLines:\`1\`,language:\`shellscript\`,children:\_jsx(\_components.pre,{className:\`shiki shiki-themes github-light-default dark-plus\`,style:{backgroundColor:\`#ffffff\`,\\"--shiki-dark-bg\\":\`#0B0C0E\`,color:\`#1f2328\`,\\"--shiki-dark\\":\`#D4D4D4\`},language:\`shellscript\`,children:\_jsxs(\_components.code,{language:\`shellscript\`,numberOfLines:\`1\`,children:\[\_jsxs(\_components.span,{className:\`line\`,children:\[\_jsx(\_components.span,{style:{color:\`#953800\`,\\"--shiki-dark\\":\`#DCDCAA\`},children:\`npx\`}),\_jsx(\_components.span,{style:{color:\`#0A3069\`,\\"--shiki-dark\\":\`#CE9178\`},children:\` skills\`}),\_jsx(\_components.span,{style:{color:\`#0A3069\`,\\"--shiki-dark\\":\`#CE9178\`},children:\` add\`}),\_jsx(\_components.span,{style:{color:\`#0A3069\`,\\"--shiki-dark\\":\`#CE9178\`},children:\` namespacelabs/agent-skills\`})\]}),\`\\n\`\]})})})\]})\]}),\_jsx(\_components.p,{children:\`The skill gives the agent a repeatable workflow for creating Devboxes, loading source code, running commands, and cleaning up after the task.\`})\]}),\_jsxs(Step,{title:\`Create a Devbox with the agent\`,id:\`create-a-devbox-with-the-agent\`,children:\[\_jsx(\_components.p,{children:\`Ask your agent to create a Devbox:\`}),\_jsx(CodeBlock,{filename:\`Agent Prompt\`,wrap:\`true\`,numberOfLines:\`2\`,language:\`text\`,children:\_jsx(\_components.pre,{className:\`shiki shiki-themes github-light-default dark-plus\`,style:{backgroundColor:\`#ffffff\`,\\"--shiki-dark-bg\\":\`#0B0C0E\`,color:\`#1f2328\`,\\"--shiki-dark\\":\`#D4D4D4\`},language:\`text\`,children:\_jsxs(\_components.code,{language:\`text\`,numberOfLines:\`2\`,children:\[\_jsx(\_components.span,{className:\`line\`,children:\_jsx(\_components.span,{children:\`create a devbox\`})}),\`\\n\`,\_jsx(\_components.span,{className:\`line\`,children:\_jsx(\_components.span,{})})\]})})}),\_jsx(Info,{children:\_jsxs(\_components.p,{children:\[\`If the \`,\_jsx(\_components.a,{href:\`/reference/devbox-cli\`,children:\`Devbox CLI\`}),\` is not installed, the agent installs it and runs \`,\_jsx(\_components.code,{children:\`devbox login\`}),\`. Complete the login in your browser when prompted.\`\]})})\]})\]}),\`\\n\`,\_jsx(Heading,{level:\`2\`,id:\`getting-started-cli\`,children:\`Get Started with the CLI\`}),\`\\n\`,\_jsx(\_components.p,{children:\`Follow these steps to install the CLI and create a Devbox from your terminal.\`}),\`\\n\`,\_jsxs(Steps,{titleSize:\`h3\`,children:\[\_jsxs(Step,{id:\`install-the-devbox-cli\`,title:\`Install the Devbox CLI\`,children:\[\_jsxs(Tabs,{children:\[\_jsx(Tab,{title:\`macOS\`,icon:\`https://mintcdn.com/namespace-labs/YnODJWPvsMShiQQC/images/icons/apple.svg?fit=max\\u0026auto=format\\u0026n=YnODJWPvsMShiQQC\\u0026q=85\\u0026s=1076263ef0a75ced2146cc606bb3871b\`,\\"data-og-width\\":\`24\`,width:\`24\`,\\"data-og-height\\":\`24\`,height:\`24\`,\\"data-path\\":\`images/icons/apple.svg\`,\\"data-optimize\\":\`true\`,\\"data-opv\\":\`3\`,srcset:\`https://mintcdn.com/namespace-labs/YnODJWPvsMShiQQC/images/icons/apple.svg?w=280\\u0026fit=max\\u0026auto=format\\u0026n=YnODJWPvsMShiQQC\\u0026q=85\\u0026s=7555ff0991cd13010eefbb5d24443f1b 280w, https://mintcdn.com/namespace-labs/YnODJWPvsMShiQQC/images/icons/apple.svg?w=560\\u0026fit=max\\u0026auto=format\\u0026n=YnODJWPvsMShiQQC\\u0026q=85\\u0026s=7ee03ce5777d8d9abd89f53bdf76496e 560w, https://mintcdn.com/namespace-labs/YnODJWPvsMShiQQC/images/icons/apple.svg?w=840\\u0026fit=max\\u0026auto=format\\u0026n=YnODJWPvsMShiQQC\\u0026q=85\\u0026s=ac67ccb8fc31ce43a5bd5b02faf8a27c 840w, https://mintcdn.com/namespace-labs/YnODJWPvsMShiQQC/images/icons/apple.svg?w=1100\\u0026fit=max\\u0026auto=format\\u0026n=YnODJWPvsMShiQQC\\u0026q=85\\u0026s=9f34ac2375edecb14b7c86abd109f1b3 1100w, https://mintcdn.com/namespace-labs/YnODJWPvsMShiQQC/images/icons/apple.svg?w=1650\\u0026fit=max\\u0026auto=format\\u0026n=YnODJWPvsMShiQQC\\u0026q=85\\u0026s=83d0b672e2b5a05074b830d25bae3a7d 1650w, https://mintcdn.com/namespace-labs/YnODJWPvsMShiQQC/images/icons/apple.svg?w=2500\\u0026fit=max\\u0026auto=format\\u0026n=YnODJWPvsMShiQQC\\u0026q=85\\u0026s=126b8c44feb3d1d6878e8fe8ad9f64b0 2500w\`,id:\`macos\`,children:\_jsx(CodeBlock,{filename:\`\`,numberOfLines:\`1\`,language:\`shellscript\`,children:\_jsx(\_components.pre,{className:\`shiki shiki-themes github-light-default dark-plus\`,style:{backgroundColor:\`#ffffff\`,\\"--shiki-dark-bg\\":\`#0B0C0E\`,color:\`#1f2328\`,\\"--shiki-dark\\":\`#D4D4D4\`},language:\`shellscript\`,children:\_jsxs(\_components.code,{language:\`shellscript\`,numberOfLines:\`1\`,children:\[\_jsxs(\_components.span,{className:\`line\`,children:\[\_jsx(\_components.span,{style:{color:\`#953800\`,\\"--shiki-dark\\":\`#DCDCAA\`},children:\`curl\`}),\_jsx(\_components.span,{style:{color:\`#0550AE\`,\\"--shiki-dark\\":\`#569CD6\`},children:\` -fsSL\`}),\_jsx(\_components.span,{style:{color:\`#0A3069\`,\\"--shiki-dark\\":\`#CE9178\`},children:\` get.namespace.so/devbox/install.sh\`}),\_jsx(\_components.span,{style:{color:\`#CF222E\`,\\"--shiki-dark\\":\`#D4D4D4\`},children:\` \|\`}),\_jsx(\_components.span,{style:{color:\`#953800\`,\\"--shiki-dark\\":\`#DCDCAA\`},children:\` bash\`})\]}),\`\\n\`\]})})})}),\_jsx(Tab,{title:\`Linux\`,icon:\`https://mintcdn.com/namespace-labs/oYH7Nv8-CZwFf1Cg/images/icons/linux.svg?fit=max\\u0026auto=format\\u0026n=oYH7Nv8-CZwFf1Cg\\u0026q=85\\u0026s=c5144976477dfafc5a0ae2cb8fdf090c\`,\\"data-og-width\\":\`24\`,width:\`24\`,\\"data-og-height\\":\`24\`,height:\`24\`,\\"data-path\\":\`images/icons/linux.svg\`,\\"data-optimize\\":\`true\`,\\"data-opv\\":\`3\`,srcset:\`https://mintcdn.com/namespace-labs/oYH7Nv8-CZwFf1Cg/images/icons/linux.svg?w=280\\u0026fit=max\\u0026auto=format\\u0026n=oYH7Nv8-CZwFf1Cg\\u0026q=85\\u0026s=807a591e0eff1abb8dd622fd2a276df6 280w, https://mintcdn.com/namespace-labs/oYH7Nv8-CZwFf1Cg/images/icons/linux.svg?w=560\\u0026fit=max\\u0026auto=format\\u0026n=oYH7Nv8-CZwFf1Cg\\u0026q=85\\u0026s=8be3915bb27cff87028461279f6c257f 560w, https://mintcdn.com/namespace-labs/oYH7Nv8-CZwFf1Cg/images/icons/linux.svg?w=840\\u0026fit=max\\u0026auto=format\\u0026n=oYH7Nv8-CZwFf1Cg\\u0026q=85\\u0026s=26da4b4181cb9229bcba58e179838385 840w, https://mintcdn.com/namespace-labs/oYH7Nv8-CZwFf1Cg/images/icons/linux.svg?w=1100\\u0026fit=max\\u0026auto=format\\u0026n=oYH7Nv8-CZwFf1Cg\\u0026q=85\\u0026s=e3ec1c56795533795c1c2ba816fbb6ad 1100w, https://mintcdn.com/namespace-labs/oYH7Nv8-CZwFf1Cg/images/icons/linux.svg?w=1650\\u0026fit=max\\u0026auto=format\\u0026n=oYH7Nv8-CZwFf1Cg\\u0026q=85\\u0026s=cfd201cb3c8fafa72aca2896b1f3bbf8 1650w, https://mintcdn.com/namespace-labs/oYH7Nv8-CZwFf1Cg/images/icons/linux.svg?w=2500\\u0026fit=max\\u0026auto=format\\u0026n=oYH7Nv8-CZwFf1Cg\\u0026q=85\\u0026s=f8d64bf95d85f6e7a35e69e94a945224 2500w\`,id:\`linux\`,children:\_jsx(CodeBlock,{filename:\`\`,numberOfLines:\`1\`,language:\`shellscript\`,children:\_jsx(\_components.pre,{className:\`shiki shiki-themes github-light-default dark-plus\`,style:{backgroundColor:\`#ffffff\`,\\"--shiki-dark-bg\\":\`#0B0C0E\`,color:\`#1f2328\`,\\"--shiki-dark\\":\`#D4D4D4\`},language:\`shellscript\`,children:\_jsxs(\_components.code,{language:\`shellscript\`,numberOfLines:\`1\`,children:\[\_jsxs(\_components.span,{className:\`line\`,children:\[\_jsx(\_components.span,{style:{color:\`#953800\`,\\"--shiki-dark\\":\`#DCDCAA\`},children:\`curl\`}),\_jsx(\_components.span,{style:{color:\`#0550AE\`,\\"--shiki-dark\\":\`#569CD6\`},children:\` -fsSL\`}),\_jsx(\_components.span,{style:{color:\`#0A3069\`,\\"--shiki-dark\\":\`#CE9178\`},children:\` get.namespace.so/devbox/install.sh\`}),\_jsx(\_components.span,{style:{color:\`#CF222E\`,\\"--shiki-dark\\":\`#D4D4D4\`},children:\` \|\`}),\_jsx(\_components.span,{style:{color:\`#953800\`,\\"--shiki-dark\\":\`#DCDCAA\`},children:\` bash\`})\]}),\`\\n\`\]})})})}),\_jsxs(Tab,{title:\`Windows\`,icon:\`https://mintcdn.com/namespace-labs/YnODJWPvsMShiQQC/images/icons/windows.svg?fit=max\\u0026auto=format\\u0026n=YnODJWPvsMShiQQC\\u0026q=85\\u0026s=63c0bb0e51580dcbd2cbef4b1801f545\`,\\"data-og-width\\":\`4875\`,width:\`4875\`,\\"data-og-height\\":\`4875\`,height:\`4875\`,\\"data-path\\":\`images/icons/windows.svg\`,\\"data-optimize\\":\`true\`,\\"data-opv\\":\`3\`,srcset:\`https://mintcdn.com/namespace-labs/YnODJWPvsMShiQQC/images/icons/windows.svg?w=280\\u0026fit=max\\u0026auto=format\\u0026n=YnODJWPvsMShiQQC\\u0026q=85\\u0026s=30ba549f9d69a9598ed7dca48a84cd40 280w, https://mintcdn.com/namespace-labs/YnODJWPvsMShiQQC/images/icons/windows.svg?w=560\\u0026fit=max\\u0026auto=format\\u0026n=YnODJWPvsMShiQQC\\u0026q=85\\u0026s=d21e09a37895068b8d9a5ce5b825dd69 560w, https://mintcdn.com/namespace-labs/YnODJWPvsMShiQQC/images/icons/windows.svg?w=840\\u0026fit=max\\u0026auto=format\\u0026n=YnODJWPvsMShiQQC\\u0026q=85\\u0026s=2c5b556c9b9da01ee8f9c0320c81bdc3 840w, https://mintcdn.com/namespace-labs/YnODJWPvsMShiQQC/images/icons/windows.svg?w=1100\\u0026fit=max\\u0026auto=format\\u0026n=YnODJWPvsMShiQQC\\u0026q=85\\u0026s=e7f70da6051b2e59c9f239112eca0a24 1100w, https://mintcdn.com/namespace-labs/YnODJWPvsMShiQQC/images/icons/windows.svg?w=1650\\u0026fit=max\\u0026auto=format\\u0026n=YnODJWPvsMShiQQC\\u0026q=85\\u0026s=5ebd7295949375646362cc436c039adf 1650w, https://mintcdn.com/namespace-labs/YnODJWPvsMShiQQC/images/icons/windows.svg?w=2500\\u0026fit=max\\u0026auto=format\\u0026n=YnODJWPvsMShiQQC\\u0026q=85\\u0026s=53adf4de496b50f349a11a10f4c25ff7 2500w\`,id:\`windows\`,children:\[\_jsx(\_components.p,{children:\`Run the following command in PowerShell:\`}),\_jsx(CodeBlock,{filename:\`\`,numberOfLines:\`1\`,language:\`powershell\`,children:\_jsx(\_components.pre,{className:\`shiki shiki-themes github-light-default dark-plus\`,style:{backgroundColor:\`#ffffff\`,\\"--shiki-dark-bg\\":\`#0B0C0E\`,color:\`#1f2328\`,\\"--shiki-dark\\":\`#D4D4D4\`},language:\`powershell\`,children:\_jsxs(\_components.code,{language:\`powershell\`,numberOfLines:\`1\`,children:\[\_jsxs(\_components.span,{className:\`line\`,children:\[\_jsx(\_components.span,{style:{color:\`#1F2328\`,\\"--shiki-dark\\":\`#D4D4D4\`},children:\`irm https:\`}),\_jsx(\_components.span,{style:{color:\`#CF222E\`,\\"--shiki-dark\\":\`#D4D4D4\`},children:\`//\`}),\_jsx(\_components.span,{style:{color:\`#1F2328\`,\\"--shiki-dark\\":\`#D4D4D4\`},children:\`get.namespace.so\`}),\_jsx(\_components.span,{style:{color:\`#CF222E\`,\\"--shiki-dark\\":\`#D4D4D4\`},children:\`/\`}),\_jsx(\_components.span,{style:{color:\`#1F2328\`,\\"--shiki-dark\\":\`#D4D4D4\`},children:\`devbox\`}),\_jsx(\_components.span,{style:{color:\`#CF222E\`,\\"--shiki-dark\\":\`#D4D4D4\`},children:\`/\`}),\_jsx(\_components.span,{style:{color:\`#1F2328\`,\\"--shiki-dark\\":\`#D4D4D4\`},children:\`install.ps1 \`}),\_jsx(\_components.span,{style:{color:\`#CF222E\`,\\"--shiki-dark\\":\`#D4D4D4\`},children:\`\|\`}),\_jsx(\_components.span,{style:{color:\`#1F2328\`,\\"--shiki-dark\\":\`#D4D4D4\`},children:\` iex\`})\]}),\`\\n\`\]})})}),\_jsxs(\_components.p,{children:\[\`Restart your terminal if \`,\_jsx(\_components.code,{children:\`devbox\`}),\` is not available on your \`,\_jsx(\_components.code,{children:\`PATH\`}),\` after installation.\`\]}),\_jsxs(\_components.p,{children:\[\`Connecting over SSH also requires an \`,\_jsx(\_components.a,{href:\`https://learn.microsoft.com/windows-server/administration/openssh/openssh\_install\_firstuse\`,children:\`OpenSSH client\`}),\`. Most modern Windows installations include one.\`\]})\]})\]}),\_jsx(\_components.p,{children:\`Confirm the installation:\`}),\_jsx(CodeBlock,{filename:\`\`,numberOfLines:\`1\`,language:\`shellscript\`,children:\_jsx(\_components.pre,{className:\`shiki shiki-themes github-light-default dark-plus\`,style:{backgroundColor:\`#ffffff\`,\\"--shiki-dark-bg\\":\`#0B0C0E\`,color:\`#1f2328\`,\\"--shiki-dark\\":\`#D4D4D4\`},language:\`shellscript\`,children:\_jsxs(\_components.code,{language:\`shellscript\`,numberOfLines:\`1\`,children:\[\_jsxs(\_components.span,{className:\`line\`,children:\[\_jsx(\_components.span,{style:{color:\`#953800\`,\\"--shiki-dark\\":\`#DCDCAA\`},children:\`devbox\`}),\_jsx(\_components.span,{style:{color:\`#0A3069\`,\\"--shiki-dark\\":\`#CE9178\`},children:\` version\`})\]}),\`\\n\`\]})})})\]}),\_jsxs(Step,{title:\`Authenticate with Namespace\`,id:\`authenticate-with-namespace\`,children:\[\_jsx(CodeBlock,{filename:\`\`,numberOfLines:\`1\`,language:\`shellscript\`,children:\_jsx(\_components.pre,{className:\`shiki shiki-themes github-light-default dark-plus\`,style:{backgroundColor:\`#ffffff\`,\\"--shiki-dark-bg\\":\`#0B0C0E\`,color:\`#1f2328\`,\\"--shiki-dark\\":\`#D4D4D4\`},language:\`shellscript\`,children:\_jsxs(\_components.code,{language:\`shellscript\`,numberOfLines:\`1\`,children:\[\_jsxs(\_components.span,{className:\`line\`,children:\[\_jsx(\_components.span,{style:{color:\`#953800\`,\\"--shiki-dark\\":\`#DCDCAA\`},children:\`devbox\`}),\_jsx(\_components.span,{style:{color:\`#0A3069\`,\\"--shiki-dark\\":\`#CE9178\`},children:\` login\`})\]}),\`\\n\`\]})})}),\_jsx(\_components.p,{children:\`The command prints a login URL and opens it in your browser. Complete the flow there, and the CLI stores a user credential in your operating system’s user configuration directory.\`}),\_jsx(\_components.p,{children:\`Check the stored credential at any time:\`}),\_jsx(CodeBlock,{filename:\`\`,numberOfLines:\`1\`,language:\`shellscript\`,children:\_jsx(\_components.pre,{className:\`shiki shiki-themes github-light-default dark-plus\`,style:{backgroundColor:\`#ffffff\`,\\"--shiki-dark-bg\\":\`#0B0C0E\`,color:\`#1f2328\`,\\"--shiki-dark\\":\`#D4D4D4\`},language:\`shellscript\`,children:\_jsxs(\_components.code,{language:\`shellscript\`,numberOfLines:\`1\`,children:\[\_jsxs(\_components.span,{className:\`line\`,children:\[\_jsx(\_components.span,{style:{color:\`#953800\`,\\"--shiki-dark\\":\`#DCDCAA\`},children:\`devbox\`}),\_jsx(\_components.span,{style:{color:\`#0A3069\`,\\"--shiki-dark\\":\`#CE9178\`},children:\` auth\`}),\_jsx(\_components.span,{style:{color:\`#0A3069\`,\\"--shiki-dark\\":\`#CE9178\`},children:\` check\`})\]}),\`\\n\`\]})})})\]}),\_jsxs(Step,{title:\`Create a Devbox\`,id:\`create-a-devbox\`,children:\[\_jsxs(\_components.p,{children:\[\_jsx(\_components.code,{children:\`devbox create\`}),\` provisions a Devbox and activates it, so it is ready to connect to when the command returns. Supply its configuration interactively or as flags.\`\]}),\_jsxs(Tabs,{children:\[\_jsxs(Tab,{title:\`Interactive\`,id:\`interactive\`,children:\[\_jsx(\_components.p,{children:\`The CLI prompts for a name, an image, and a machine size:\`}),\_jsx(CodeBlock,{filename:\`\`,numberOfLines:\`1\`,language:\`shellscript\`,children:\_jsx(\_components.pre,{className:\`shiki shiki-themes github-light-default dark-plus\`,style:{backgroundColor:\`#ffffff\`,\\"--shiki-dark-bg\\":\`#0B0C0E\`,color:\`#1f2328\`,\\"--shiki-dark\\":\`#D4D4D4\`},language:\`shellscript\`,children:\_jsxs(\_components.code,{language:\`shellscript\`,numberOfLines:\`1\`,children:\[\_jsxs(\_components.span,{className:\`line\`,children:\[\_jsx(\_components.span,{style:{color:\`#953800\`,\\"--shiki-dark\\":\`#DCDCAA\`},children:\`devbox\`}),\_jsx(\_components.span,{style:{color:\`#0A3069\`,\\"--shiki-dark\\":\`#CE9178\`},children:\` create\`}),\_jsx(\_components.span,{style:{color:\`#0550AE\`,\\"--shiki-dark\\":\`#569CD6\`},children:\` --checkout\`}),\_jsx(\_components.span,{style:{color:\`#0A3069\`,\\"--shiki-dark\\":\`#CE9178\`},children:\` github.com/your-org/your-repo\`})\]}),\`\\n\`\]})})})\]}),\_jsxs(Tab,{title:\`Non-interactive\`,id:\`non-interactive\`,children:\[\_jsx(\_components.p,{children:\`Pass every value as a flag to skip the prompts:\`}),\_jsx(CodeBlock,{filename:\`\`,numberOfLines:\`1\`,language:\`shellscript\`,children:\_jsx(\_components.pre,{className:\`shiki shiki-themes github-light-default dark-plus\`,style:{backgroundColor:\`#ffffff\`,\\"--shiki-dark-bg\\":\`#0B0C0E\`,color:\`#1f2328\`,\\"--shiki-dark\\":\`#D4D4D4\`},language:\`shellscript\`,children:\_jsxs(\_components.code,{language:\`shellscript\`,numberOfLines:\`1\`,children:\[\_jsxs(\_components.span,{className:\`line\`,children:\[\_jsx(\_components.span,{style:{color:\`#953800\`,\\"--shiki-dark\\":\`#DCDCAA\`},children:\`devbox\`}),\_jsx(\_components.span,{style:{color:\`#0A3069\`,\\"--shiki-dark\\":\`#CE9178\`},children:\` create\`}),\_jsx(\_components.span,{style:{color:\`#0550AE\`,\\"--shiki-dark\\":\`#569CD6\`},children:\` --name\`}),\_jsx(\_components.span,{style:{color:\`#0A3069\`,\\"--shiki-dark\\":\`#CE9178\`},children:\` my-devbox\`}),\_jsx(\_components.span,{style:{color:\`#0550AE\`,\\"--shiki-dark\\":\`#569CD6\`},children:\` --image\`}),\_jsx(\_components.span,{style:{color:\`#0A3069\`,\\"--shiki-dark\\":\`#CE9178\`},children:\` builtin:default\`}),\_jsx(\_components.span,{style:{color:\`#0550AE\`,\\"--shiki-dark\\":\`#569CD6\`},children:\` --size\`}),\_jsx(\_components.span,{style:{color:\`#0A3069\`,\\"--shiki-dark\\":\`#CE9178\`},children:\` m\`}),\_jsx(\_components.span,{style:{color:\`#0550AE\`,\\"--shiki-dark\\":\`#569CD6\`},children:\` --checkout\`}),\_jsx(\_components.span,{style:{color:\`#0A3069\`,\\"--shiki-dark\\":\`#CE9178\`},children:\` github.com/your-org/your-repo\`})\]}),\`\\n\`\]})})})\]})\]}),\_jsxs(\_components.p,{children:\[\_jsx(\_components.code,{children:\`--checkout\`}),\` clones a repository into the Devbox and requires a \`,\_jsx(\_components.a,{href:\`#getting-started-dashboard\`,children:\`connected GitHub organization\`}),\`. Omitting it applies the workspace default repository, and \`,\_jsx(\_components.code,{children:\`--no\_checkout\`}),\` skips the checkout entirely.\`\]}),\_jsxs(\_components.p,{children:\[\`See \`,\_jsx(\_components.a,{href:\`/reference/devbox-cli/create\`,children:\_jsx(\_components.code,{children:\`devbox create\`})}),\` for the full set of options, including Blueprints, ephemeral Devboxes, and specification files.\`\]})\]}),\_jsxs(Step,{title:\`Connect to your Devbox\`,id:\`connect-to-your-devbox\`,children:\[\_jsxs(\_components.p,{children:\[\`Connect to a \`,\_jsx(\_components.a,{href:\`/devbox/connecting#sessions\`,children:\`session\`}),\` on the Devbox. A session keeps running when you close your terminal or disconnect, so work you start in it carries on without you.\`\]}),\_jsx(CodeBlock,{filename:\`\`,numberOfLines:\`1\`,language:\`shellscript\`,children:\_jsx(\_components.pre,{className:\`shiki shiki-themes github-light-default dark-plus\`,style:{backgroundColor:\`#ffffff\`,\\"--shiki-dark-bg\\":\`#0B0C0E\`,color:\`#1f2328\`,\\"--shiki-dark\\":\`#D4D4D4\`},language:\`shellscript\`,children:\_jsxs(\_components.code,{language:\`shellscript\`,numberOfLines:\`1\`,children:\[\_jsxs(\_components.span,{className:\`line\`,children:\[\_jsx(\_components.span,{style:{color:\`#953800\`,\\"--shiki-dark\\":\`#DCDCAA\`},children:\`devbox\`}),\_jsx(\_components.span,{style:{color:\`#0A3069\`,\\"--shiki-dark\\":\`#CE9178\`},children:\` session\`}),\_jsx(\_components.span,{style:{color:\`#0A3069\`,\\"--shiki-dark\\":\`#CE9178\`},children:\` connect\`}),\_jsx(\_components.span,{style:{color:\`#0550AE\`,\\"--shiki-dark\\":\`#569CD6\`},children:\` --session\`}),\_jsx(\_components.span,{style:{color:\`#0A3069\`,\\"--shiki-dark\\":\`#CE9178\`},children:\` agent\`})\]}),\`\\n\`\]})})}),\_jsx(\_components.p,{children:\`The CLI lists your Devboxes and their sessions, with an option to start a new session.\`}),\_jsx(Info,{children:\_jsx(\_components.p,{children:\`Connecting to a stopped Devbox starts it first, and your files persist across stop and start cycles.\`})})\]}),\_jsxs(Step,{title:\`Start your favorite agent\`,id:\`start-your-favorite-agent\`,children:\[\_jsx(\_components.p,{children:\`Start a coding agent in the Devbox and give it a task. The agent works on the Devbox itself, with its own files, tools, and terminal:\`}),\_jsxs(Tabs,{children:\[\_jsx(Tab,{title:\`Amp\`,id:\`amp\`,children:\_jsx(CodeBlock,{filename:\`\`,numberOfLines:\`1\`,language:\`shellscript\`,children:\_jsx(\_components.pre,{className:\`shiki shiki-themes github-light-default dark-plus\`,style:{backgroundColor:\`#ffffff\`,\\"--shiki-dark-bg\\":\`#0B0C0E\`,color:\`#1f2328\`,\\"--shiki-dark\\":\`#D4D4D4\`},language:\`shellscript\`,children:\_jsxs(\_components.code,{language:\`shellscript\`,numberOfLines:\`1\`,children:\[\_jsx(\_components.span,{className:\`line\`,children:\_jsx(\_components.span,{style:{color:\`#953800\`,\\"--shiki-dark\\":\`#DCDCAA\`},children:\`amp\`})}),\`\\n\`\]})})})}),\_jsx(Tab,{title:\`Claude Code\`,id:\`claude-code\`,children:\_jsx(CodeBlock,{filename:\`\`,numberOfLines:\`1\`,language:\`shellscript\`,children:\_jsx(\_components.pre,{className:\`shiki shiki-themes github-light-default dark-plus\`,style:{backgroundColor:\`#ffffff\`,\\"--shiki-dark-bg\\":\`#0B0C0E\`,color:\`#1f2328\`,\\"--shiki-dark\\":\`#D4D4D4\`},language:\`shellscript\`,children:\_jsxs(\_components.code,{language:\`shellscript\`,numberOfLines:\`1\`,children:\[\_jsx(\_components.span,{className:\`line\`,children:\_jsx(\_components.span,{style:{color:\`#953800\`,\\"--shiki-dark\\":\`#DCDCAA\`},children:\`claude\`})}),\`\\n\`\]})})})}),\_jsx(Tab,{title:\`Codex\`,id:\`codex\`,children:\_jsx(CodeBlock,{filename:\`\`,numberOfLines:\`1\`,language:\`shellscript\`,children:\_jsx(\_components.pre,{className:\`shiki shiki-themes github-light-default dark-plus\`,style:{backgroundColor:\`#ffffff\`,\\"--shiki-dark-bg\\":\`#0B0C0E\`,color:\`#1f2328\`,\\"--shiki-dark\\":\`#D4D4D4\`},language:\`shellscript\`,children:\_jsxs(\_components.code,{language:\`shellscript\`,numberOfLines:\`1\`,children:\[\_jsx(\_components.span,{className:\`line\`,children:\_jsx(\_components.span,{style:{color:\`#953800\`,\\"--shiki-dark\\":\`#DCDCAA\`},children:\`codex\`})}),\`\\n\`\]})})})}),\_jsx(Tab,{title:\`Copilot\`,id:\`copilot\`,children:\_jsx(CodeBlock,{filename:\`\`,numberOfLines:\`1\`,language:\`shellscript\`,children:\_jsx(\_components.pre,{className:\`shiki shiki-themes github-light-default dark-plus\`,style:{backgroundColor:\`#ffffff\`,\\"--shiki-dark-bg\\":\`#0B0C0E\`,color:\`#1f2328\`,\\"--shiki-dark\\":\`#D4D4D4\`},language:\`shellscript\`,children:\_jsxs(\_components.code,{language:\`shellscript\`,numberOfLines:\`1\`,children:\[\_jsx(\_components.span,{className:\`line\`,children:\_jsx(\_components.span,{style:{color:\`#953800\`,\\"--shiki-dark\\":\`#DCDCAA\`},children:\`copilot\`})}),\`\\n\`\]})})})}),\_jsx(Tab,{title:\`Cursor\`,id:\`cursor\`,children:\_jsx(CodeBlock,{filename:\`\`,numberOfLines:\`1\`,language:\`shellscript\`,children:\_jsx(\_components.pre,{className:\`shiki shiki-themes github-light-default dark-plus\`,style:{backgroundColor:\`#ffffff\`,\\"--shiki-dark-bg\\":\`#0B0C0E\`,color:\`#1f2328\`,\\"--shiki-dark\\":\`#D4D4D4\`},language:\`shellscript\`,children:\_jsxs(\_components.code,{language:\`shellscript\`,numberOfLines:\`1\`,children:\[\_jsx(\_components.span,{className:\`line\`,children:\_jsx(\_components.span,{style:{color:\`#953800\`,\\"--shiki-dark\\":\`#DCDCAA\`},children:\`cursor-agent\`})}),\`\\n\`\]})})})}),\_jsx(Tab,{title:\`OpenCode\`,id:\`opencode\`,children:\_jsx(CodeBlock,{filename:\`\`,numberOfLines:\`1\`,language:\`shellscript\`,children:\_jsx(\_components.pre,{className:\`shiki shiki-themes github-light-default dark-plus\`,style:{backgroundColor:\`#ffffff\`,\\"--shiki-dark-bg\\":\`#0B0C0E\`,color:\`#1f2328\`,\\"--shiki-dark\\":\`#D4D4D4\`},language:\`shellscript\`,children:\_jsxs(\_components.code,{language:\`shellscript\`,numberOfLines:\`1\`,children:\[\_jsx(\_components.span,{className:\`line\`,children:\_jsx(\_components.span,{style:{color:\`#953800\`,\\"--shiki-dark\\":\`#DCDCAA\`},children:\`opencode\`})}),\`\\n\`\]})})})})\]})\]})\]}),\`\\n\`,\_jsx(Heading,{level:\`2\`,id:\`getting-started-dashboard\`,children:\`Get Started with the Dashboard\`}),\`\\n\`,\_jsx(\_components.p,{children:\`The Dashboard needs no local installation. Follow these steps to create your first Devbox in the browser and open a shell in it.\`}),\`\\n\`,\_jsxs(Steps,{titleSize:\`h3\`,children:\[\_jsxs(Step,{title:\`Connect a code provider\`,id:\`connect-a-code-provider\`,children:\[\_jsxs(\_components.p,{children:\[\`Open \`,\_jsx(\_components.a,{href:\`https://cloud.namespace.so/workspace/devboxes\`,children:\`Devboxes\`}),\` in the Namespace Dashboard and connect a code provider so Namespace can clone your repositories. Devboxes can check out from GitHub and \`,\_jsx(\_components.a,{href:\`https://cursor.com\`,children:\`Cursor Origin\`}),\`.\`\]}),\_jsx(\_components.p,{children:\`If you have not connected a provider yet, choose one from the Devboxes page:\`}),\_jsxs(\_components.ul,{children:\[\`\\n\`,\_jsxs(\_components.li,{children:\[\`For GitHub, press \`,\_jsx(\_components.strong,{children:\`Connect with GitHub\`}),\` and follow the instructions to install the Namespace GitHub app.\`\]}),\`\\n\`,\_jsxs(\_components.li,{children:\[\`For Cursor Origin, press \`,\_jsx(\_components.strong,{children:\`Other providers\`}),\`, then select Cursor Origin on the Code Providers page.\`\]}),\`\\n\`\]}),\_jsxs(\_components.p,{children:\[\`After you connect a provider, use \`,\_jsx(\_components.a,{href:\`https://cloud.namespace.so/workspace/code/providers\`,children:\`Code Providers\`}),\` to connect another one.\`\]}),\_jsx(Frame,{style:{maxWidth:800,marginInline:\`auto\`},children:\_jsx(OptimizedImage,{src:\`https://mintcdn.com/namespace-labs/DmrnXcQln8ee4bAT/images/devboxes/devbox-connect-provider.webp?fit=max\\u0026auto=format\\u0026n=DmrnXcQln8ee4bAT\\u0026q=85\\u0026s=49167a06f6ffd7805977b90ecc09afbe\`,alt:\`Devboxes empty state with options to connect GitHub, select another provider, or create a Devbox from scratch\`,width:1552,height:809,\\"data-og-width\\":\`1552\`,\\"data-og-height\\":\`809\`,\\"data-path\\":\`images/devboxes/devbox-connect-provider.webp\`,\\"data-optimize\\":\`true\`,\\"data-opv\\":\`3\`,srcset:\`https://mintcdn.com/namespace-labs/DmrnXcQln8ee4bAT/images/devboxes/devbox-connect-provider.webp?w=280\\u0026fit=max\\u0026auto=format\\u0026n=DmrnXcQln8ee4bAT\\u0026q=85\\u0026s=409136b715a6b257b6c87e415c55017b 280w, https://mintcdn.com/namespace-labs/DmrnXcQln8ee4bAT/images/devboxes/devbox-connect-provider.webp?w=560\\u0026fit=max\\u0026auto=format\\u0026n=DmrnXcQln8ee4bAT\\u0026q=85\\u0026s=03732daadc9cff9312a7665c1fd14d29 560w, https://mintcdn.com/namespace-labs/DmrnXcQln8ee4bAT/images/devboxes/devbox-connect-provider.webp?w=840\\u0026fit=max\\u0026auto=format\\u0026n=DmrnXcQln8ee4bAT\\u0026q=85\\u0026s=90bba0f3663e1f0fee2c084a8ce2177d 840w, https://mintcdn.com/namespace-labs/DmrnXcQln8ee4bAT/images/devboxes/devbox-connect-provider.webp?w=1100\\u0026fit=max\\u0026auto=format\\u0026n=DmrnXcQln8ee4bAT\\u0026q=85\\u0026s=8bab5df6f863299d559fcf6aba96da9f 1100w, https://mintcdn.com/namespace-labs/DmrnXcQln8ee4bAT/images/devboxes/devbox-connect-provider.webp?w=1650\\u0026fit=max\\u0026auto=format\\u0026n=DmrnXcQln8ee4bAT\\u0026q=85\\u0026s=163044e4bfa73089d12ee24e72d0cec6 1650w, https://mintcdn.com/namespace-labs/DmrnXcQln8ee4bAT/images/devboxes/devbox-connect-provider.webp?w=2500\\u0026fit=max\\u0026auto=format\\u0026n=DmrnXcQln8ee4bAT\\u0026q=85\\u0026s=e1b40b91b73c04c8e0d60e952dffa902 2500w\`})}),\_jsx(Info,{children:\_jsxs(\_components.p,{children:\[\`Connecting a provider lets Namespace clone your repositories into a Devbox, which is how you work on your own code. To look around first, select \`,\_jsx(\_components.strong,{children:\`create a Devbox from scratch\`}),\` and connect a provider later.\`\]})})\]}),\_jsxs(Step,{title:\`Create a Devbox\`,id:\`create-a-devbox-2\`,children:\[\_jsxs(\_components.p,{children:\[\`Press \`,\_jsx(\_components.strong,{children:\`+ Create\`}),\` on the Devboxes page.\`\]}),\_jsx(Frame,{style:{maxWidth:800,marginInline:\`auto\`},children:\_jsx(OptimizedImage,{src:\`https://mintcdn.com/namespace-labs/gFazvjcdlAyUqYv5/images/devboxes/devbox-create-1.webp?fit=max\\u0026auto=format\\u0026n=gFazvjcdlAyUqYv5\\u0026q=85\\u0026s=85c14353f6fe5e4c0c7d49618adc9084\`,alt:\`The Devboxes page with the + Create button in the top right\`,width:1600,height:636,\\"data-og-width\\":\`1600\`,\\"data-og-height\\":\`636\`,\\"data-path\\":\`images/devboxes/devbox-create-1.webp\`,\\"data-optimize\\":\`true\`,\\"data-opv\\":\`3\`,srcset:\`https://mintcdn.com/namespace-labs/gFazvjcdlAyUqYv5/images/devboxes/devbox-create-1.webp?w=280\\u0026fit=max\\u0026auto=format\\u0026n=gFazvjcdlAyUqYv5\\u0026q=85\\u0026s=7d989e23b090d326da0108bf7934898b 280w, https://mintcdn.com/namespace-labs/gFazvjcdlAyUqYv5/images/devboxes/devbox-create-1.webp?w=560\\u0026fit=max\\u0026auto=format\\u0026n=gFazvjcdlAyUqYv5\\u0026q=85\\u0026s=b10eeb3b3b0c0edd86cadab7ce0844f2 560w, https://mintcdn.com/namespace-labs/gFazvjcdlAyUqYv5/images/devboxes/devbox-create-1.webp?w=840\\u0026fit=max\\u0026auto=format\\u0026n=gFazvjcdlAyUqYv5\\u0026q=85\\u0026s=d0b92dfae28149cab5bca43d5a1121a5 840w, https://mintcdn.com/namespace-labs/gFazvjcdlAyUqYv5/images/devboxes/devbox-create-1.webp?w=1100\\u0026fit=max\\u0026auto=format\\u0026n=gFazvjcdlAyUqYv5\\u0026q=85\\u0026s=4475af6a664b8a46bb895d6d16d6b7a3 1100w, https://mintcdn.com/namespace-labs/gFazvjcdlAyUqYv5/images/devboxes/devbox-create-1.webp?w=1650\\u0026fit=max\\u0026auto=format\\u0026n=gFazvjcdlAyUqYv5\\u0026q=85\\u0026s=acacd259f36dd34eb3abac225878dba0 1650w, https://mintcdn.com/namespace-labs/gFazvjcdlAyUqYv5/images/devboxes/devbox-create-1.webp?w=2500\\u0026fit=max\\u0026auto=format\\u0026n=gFazvjcdlAyUqYv5\\u0026q=85\\u0026s=1a771e27141ec21e43fc52a9f3fd5908 2500w\`})}),\_jsxs(\_components.p,{children:\[\`Give your Devbox a name or keep the generated one. Then press \`,\_jsx(\_components.strong,{children:\`Repository\`}),\` and select the repository to check out.\`\]}),\_jsx(Frame,{style:{maxWidth:600,marginInline:\`auto\`},children:\_jsx(OptimizedImage,{src:\`https://mintcdn.com/namespace-labs/gFazvjcdlAyUqYv5/images/devboxes/devbox-create-2.webp?fit=max\\u0026auto=format\\u0026n=gFazvjcdlAyUqYv5\\u0026q=85\\u0026s=72a722e85c2b11b70779f8a0edd323aa\`,alt:\`The New devbox dialog with the repository list expanded\`,width:1600,height:1180,\\"data-og-width\\":\`1600\`,\\"data-og-height\\":\`1180\`,\\"data-path\\":\`images/devboxes/devbox-create-2.webp\`,\\"data-optimize\\":\`true\`,\\"data-opv\\":\`3\`,srcset:\`https://mintcdn.com/namespace-labs/gFazvjcdlAyUqYv5/images/devboxes/devbox-create-2.webp?w=280\\u0026fit=max\\u0026auto=format\\u0026n=gFazvjcdlAyUqYv5\\u0026q=85\\u0026s=3bb184be4509aa0e7d609ea8121a6d15 280w, https://mintcdn.com/namespace-labs/gFazvjcdlAyUqYv5/images/devboxes/devbox-create-2.webp?w=560\\u0026fit=max\\u0026auto=format\\u0026n=gFazvjcdlAyUqYv5\\u0026q=85\\u0026s=044f3217192ce6252bdccb31b018f477 560w, https://mintcdn.com/namespace-labs/gFazvjcdlAyUqYv5/images/devboxes/devbox-create-2.webp?w=840\\u0026fit=max\\u0026auto=format\\u0026n=gFazvjcdlAyUqYv5\\u0026q=85\\u0026s=11f81b4d92781185e7d797faf17ad1ac 840w, https://mintcdn.com/namespace-labs/gFazvjcdlAyUqYv5/images/devboxes/devbox-create-2.webp?w=1100\\u0026fit=max\\u0026auto=format\\u0026n=gFazvjcdlAyUqYv5\\u0026q=85\\u0026s=e8042ecf7649d775482534773fadeadc 1100w, https://mintcdn.com/namespace-labs/gFazvjcdlAyUqYv5/images/devboxes/devbox-create-2.webp?w=1650\\u0026fit=max\\u0026auto=format\\u0026n=gFazvjcdlAyUqYv5\\u0026q=85\\u0026s=eb7827fdefe447d966b7f66524e25c74 1650w, https://mintcdn.com/namespace-labs/gFazvjcdlAyUqYv5/images/devboxes/devbox-create-2.webp?w=2500\\u0026fit=max\\u0026auto=format\\u0026n=gFazvjcdlAyUqYv5\\u0026q=85\\u0026s=ec851f2c4c64f37a5ece54b65191c3f4 2500w\`})}),\_jsx(Info,{children:\_jsxs(\_components.p,{children:\[\`The list shows the repositories Namespace can reach through the GitHub app. If the one you want is missing, or you skipped the previous step, use the \`,\_jsx(\_components.strong,{children:\`Connect an organization\`}),\` entry at the end of the list.\`\]})}),\_jsxs(\_components.p,{children:\[\`Press \`,\_jsx(\_components.strong,{children:\`Create Devbox\`}),\`. After a few seconds, your Devbox will be ready to use.\`\]})\]}),\_jsxs(Step,{title:\`Connect and develop\`,id:\`connect-and-develop\`,children:\[\_jsx(\_components.p,{children:\`The Devbox page shows its state and its initialization log while it starts.\`}),\_jsx(Frame,{style:{maxWidth:600,marginInline:\`auto\`},children:\_jsx(OptimizedImage,{src:\`https://mintcdn.com/namespace-labs/gFazvjcdlAyUqYv5/images/devboxes/devbox-dashboard.webp?fit=max\\u0026auto=format\\u0026n=gFazvjcdlAyUqYv5\\u0026q=85\\u0026s=5fa9d5837d59c30592ad60e06d4e8b91\`,alt:\`Devbox dashboard with initialization log\`,width:1600,height:1282,\\"data-og-width\\":\`1600\`,\\"data-og-height\\":\`1282\`,\\"data-path\\":\`images/devboxes/devbox-dashboard.webp\`,\\"data-optimize\\":\`true\`,\\"data-opv\\":\`3\`,srcset:\`https://mintcdn.com/namespace-labs/gFazvjcdlAyUqYv5/images/devboxes/devbox-dashboard.webp?w=280\\u0026fit=max\\u0026auto=format\\u0026n=gFazvjcdlAyUqYv5\\u0026q=85\\u0026s=291e355d90d24858ed06c3a5645c9c9e 280w, https://mintcdn.com/namespace-labs/gFazvjcdlAyUqYv5/images/devboxes/devbox-dashboard.webp?w=560\\u0026fit=max\\u0026auto=format\\u0026n=gFazvjcdlAyUqYv5\\u0026q=85\\u0026s=2a8041c150a4217b80a0ae2f5eaf09d3 560w, https://mintcdn.com/namespace-labs/gFazvjcdlAyUqYv5/images/devboxes/devbox-dashboard.webp?w=840\\u0026fit=max\\u0026auto=format\\u0026n=gFazvjcdlAyUqYv5\\u0026q=85\\u0026s=c63834d0d0ff2104077883f7b59f2b6a 840w, https://mintcdn.com/namespace-labs/gFazvjcdlAyUqYv5/images/devboxes/devbox-dashboard.webp?w=1100\\u0026fit=max\\u0026auto=format\\u0026n=gFazvjcdlAyUqYv5\\u0026q=85\\u0026s=cc169f5b32c24398c6956a2810b0a720 1100w, https://mintcdn.com/namespace-labs/gFazvjcdlAyUqYv5/images/devboxes/devbox-dashboard.webp?w=1650\\u0026fit=max\\u0026auto=format\\u0026n=gFazvjcdlAyUqYv5\\u0026q=85\\u0026s=89a49ab40c8e44875638d8076a47975b 1650w, https://mintcdn.com/namespace-labs/gFazvjcdlAyUqYv5/images/devboxes/devbox-dashboard.webp?w=2500\\u0026fit=max\\u0026auto=format\\u0026n=gFazvjcdlAyUqYv5\\u0026q=85\\u0026s=6033fb88d3bde9489e86fc2a3cc6f86f 2500w\`})}),\_jsxs(\_components.p,{children:\[\`Once the log reaches \`,\_jsx(\_components.strong,{children:\`Ready\`}),\`, open the \`,\_jsx(\_components.strong,{children:\`Terminal\`}),\` tab (for a shell in the Devbox without installing anything locally) and run \`,\_jsx(\_components.code,{children:\`ls\`}),\` to see the cloned files:\`\]}),\_jsx(CodeBlock,{filename:\`\`,numberOfLines:\`1\`,language:\`shellscript\`,children:\_jsx(\_components.pre,{className:\`shiki shiki-themes github-light-default dark-plus\`,style:{backgroundColor:\`#ffffff\`,\\"--shiki-dark-bg\\":\`#0B0C0E\`,color:\`#1f2328\`,\\"--shiki-dark\\":\`#D4D4D4\`},language:\`shellscript\`,children:\_jsxs(\_components.code,{language:\`shellscript\`,numberOfLines:\`1\`,children:\[\_jsx(\_components.span,{className:\`line\`,children:\_jsx(\_components.span,{style:{color:\`#953800\`,\\"--shiki-dark\\":\`#DCDCAA\`},children:\`ls\`})}),\`\\n\`\]})})})\]}),\_jsx(Step,{title:\`Open VS Code\`,id:\`open-vs-code\`,children:\_jsxs(\_components.p,{children:\[\`Use the \`,\_jsx(\_components.strong,{children:\`Open VSCode\`}),\` dropdown to open the Devbox in VS Code, Cursor, or VS Code for the Web. See \`,\_jsx(\_components.a,{href:\`/devbox/ides\`,children:\`IDEs\`}),\` for the full list of supported editors, including JetBrains and Zed.\`\]})})\]}),\`\\n\`,\_jsx(Heading,{level:\`2\`,id:\`next-steps\`,children:\`Next Steps\`}),\`\\n\`,\_jsxs(CardGroup,{cols:2,children:\[\_jsx(Card,{title:\`Devbox Lifecycle\`,icon:\`refresh-cw\`,href:\`/devbox/lifecycle\`,children:\_jsx(\_components.p,{children:\`Create, list, stop, and delete Devboxes.\`})}),\_jsx(Card,{title:\`SSH \\u0026 Sessions\`,icon:\`terminal\`,href:\`/devbox/connecting\`,children:\_jsx(\_components.p,{children:\`Open a shell on a Devbox with SSH or a session.\`})}),\_jsx(Card,{title:\`IDEs\`,icon:\`code\`,href:\`/devbox/ides\`,children:\_jsx(\_components.p,{children:\`Open a Devbox in VS Code, Cursor, JetBrains, or Zed.\`})}),\_jsx(Card,{title:\`Services\`,icon:\`server\`,href:\`/devbox/services\`,children:\_jsx(\_components.p,{children:\`Keep dev servers and other processes running on a Devbox.\`})})\]}),\`\\n\`,\_jsx(Heading,{level:\`2\`,id:\`enterprise-support\`,children:\`Enterprise Support\`}),\`\\n\`,\_jsxs(\_components.p,{children:\[\`Need dedicated capacity, custom machine shapes, or specialized support for your development team? Contact our \`,\_jsx(\_components.a,{href:\`mailto:support@namespace.so\`,children:\`support team\`}),\` for consultation on complex development environment requirements.\`\]})\]})}function MDXContent(props={}){const{wrapper:MDXLayout}={...\_provideComponents(),...props.components};return MDXLayout?\_jsx(MDXLayout,{...props,children:\_jsx(\_createMdxContent,{...props})}):\_createMdxContent(props)}return{KeepTabPosition,default:MDXContent};function \_missingMdxReference(id,component){throw new Error(\`Expected \`+(component?\`component\`:\`object\`)+\\" \`\\"+id+\\"\` to be defined: you likely forgot to import, pass, or provide it.\\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"High-Performance Developer Environments with Devboxes","sidebarTitle":"Getting Started","description":null,"href":"/devbox/index"}}},"mdxSourceWithNoJs":null,"noJsSplices":\[\[154,3821,"null;function \_creat"\]\]},"mdxExtracts":{"tableOfContents":\[{"title":"Get Started with an Agent","slug":"getting-started","depth":2,"children":\[{"title":"Install the agent skill","slug":"install-the-agent-skill","depth":3,"children":\[\]},{"title":"Create a Devbox with the agent","slug":"create-a-devbox-with-the-agent","depth":3,"children":\[\]}\]},{"title":"Get Started with the CLI","slug":"getting-started-cli","depth":2,"children":\[{"title":"Install the Devbox CLI","slug":"install-the-devbox-cli","depth":3,"children":\[\]},{"title":"Authenticate with Namespace","slug":"authenticate-with-namespace","depth":3,"children":\[\]},{"title":"Create a Devbox","slug":"create-a-devbox","depth":3,"children":\[\]},{"title":"Connect to your Devbox","slug":"connect-to-your-devbox","depth":3,"children":\[\]},{"title":"Start your favorite agent","slug":"start-your-favorite-agent","depth":3,"children":\[\]}\]},{"title":"Get Started with the Dashboard","slug":"getting-started-dashboard","depth":2,"children":\[{"title":"Connect a code provider","slug":"connect-a-code-provider","depth":3,"children":\[\]},{"title":"Create a Devbox","slug":"create-a-devbox-2","depth":3,"children":\[\]},{"title":"Connect and develop","slug":"connect-and-develop","depth":3,"children":\[\]},{"title":"Open VS Code","slug":"open-vs-code","depth":3,"children":\[\]}\]},{"title":"Next Steps","slug":"next-steps","depth":2,"children":\[\]},{"title":"Enterprise Support","slug":"enterprise-support","depth":2,"children":\[\]}\],"codeExamples":{}},"jsLinks":\["/docs/\_mintlify/custom/namespace-labs/fa018fe02fd436c8/navigation.js","/docs/\_mintlify/custom/namespace-labs/4276600b7cb636ff/legacy-anchor-redirects.js"\],"subdomain":"namespace-labs","siteName":"Namespace Documentation","title":"High-Performance Developer Environments with Devboxes - Namespace Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-26T10:46:18.091Z","gitLastModified":"2026-10-16T14:23:13.000Z","originalFileLocation":"devbox/index.mdx"},"headHtml":"\\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\\"isDarkMode\\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\\u0026\\u0026p!=='dark'\\u0026\\u0026p!=='system')p=\\"system\\"}var r=p==='system'?(matchMedia(\\"(prefers-color-scheme: dark)\\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\\"data-theme-preference\\",p)})();\\u003c/script>\\u003cmeta data-mint-head name=\\"application-name\\" content=\\"Namespace Documentation\\">\\u003cmeta data-mint-head name=\\"generator\\" content=\\"Mintlify\\">\\u003clink data-mint-head rel=\\"icon\\" type=\\"image/png\\" sizes=\\"192x192\\" href=\\"/docs/mintlify-assets/\_mintlify/favicons/namespace-labs/kZKeJ4zhJEuE6\_kI/\_generated/favicon/android-chrome-192x192.png\\" media=\\"(prefers-color-scheme: light)\\">\\u003clink data-mint-head rel=\\"apple-touch-icon\\" type=\\"image/png\\" sizes=\\"180x180\\" href=\\"/docs/mintlify-assets/\_mintlify/favicons/namespace-labs/kZKeJ4zhJEuE6\_kI/\_generated/favicon/apple-touch-icon.png\\">\\u003clink data-mint-head rel=\\"icon\\" type=\\"image/png\\" sizes=\\"16x16\\" href=\\"/docs/mintlify-assets/\_mintlify/favicons/namespace-labs/kZKeJ4zhJEuE6\_kI/\_generated/favicon/favicon-16x16.png\\" media=\\"(prefers-color-scheme: light)\\">\\u003clink data-mint-head rel=\\"icon\\" type=\\"image/png\\" sizes=\\"32x32\\" href=\\"/docs/mintlify-assets/\_mintlify/favicons/namespace-labs/kZKeJ4zhJEuE6\_kI/\_generated/favicon/favicon-32x32.png\\" media=\\"(prefers-color-scheme: light)\\">\\u003clink data-mint-head rel=\\"shortcut icon\\" type=\\"image/x-icon\\" href=\\"/docs/mintlify-assets/\_mintlify/favicons/namespace-labs/kZKeJ4zhJEuE6\_kI/\_generated/favicon/favicon.ico\\" media=\\"(prefers-color-scheme: light)\\">\\u003clink data-mint-head rel=\\"icon\\" type=\\"image/png\\" sizes=\\"192x192\\" href=\\"/docs/mintlify-assets/\_mintlify/favicons/namespace-labs/kZKeJ4zhJEuE6\_kI/\_generated/favicon-dark/android-chrome-192x192.png\\" media=\\"(prefers-color-scheme: dark)\\">\\u003clink data-mint-head rel=\\"icon\\" type=\\"image/png\\" sizes=\\"16x16\\" href=\\"/docs/mintlify-assets/\_mintlify/favicons/namespace-labs/kZKeJ4zhJEuE6\_kI/\_generated/favicon-dark/favicon-16x16.png\\" media=\\"(prefers-color-scheme: dark)\\">\\u003clink data-mint-head rel=\\"icon\\" type=\\"image/png\\" sizes=\\"32x32\\" href=\\"/docs/mintlify-assets/\_mintlify/favicons/namespace-labs/kZKeJ4zhJEuE6\_kI/\_generated/favicon-dark/favicon-32x32.png\\" media=\\"(prefers-color-scheme: dark)\\">\\u003clink data-mint-head rel=\\"shortcut icon\\" type=\\"image/x-icon\\" href=\\"/docs/mintlify-assets/\_mintlify/favicons/namespace-labs/kZKeJ4zhJEuE6\_kI/\_generated/favicon-dark/favicon.ico\\" media=\\"(prefers-color-scheme: dark)\\">\\u003cmeta data-mint-head property=\\"og:title\\" content=\\"High-Performance Developer Environments with Devboxes - Namespace Documentation\\">\\u003cmeta data-mint-head property=\\"og:site\_name\\" content=\\"Namespace Documentation\\">\\u003cmeta data-mint-head property=\\"og:url\\" content=\\"https://namespace.so/docs/devbox\\">\\u003cmeta data-mint-head property=\\"og:type\\" content=\\"website\\">\\u003cmeta data-mint-head property=\\"og:image\\" content=\\"https://namespace-labs.mintlify.app/\_mintlify/api/og/v2?division=Devboxes\\u0026amp;title=High-Performance+Developer+Environments+with+Devboxes\\u0026amp;theme=1f89d53762a6d5304d1c63c4\\u0026amp;signature=5273db9d0dcc0067441caa39d40610b2f5e0013b33fa3f4d64b1e4b219bc2112\\">\\u003cmeta data-mint-head property=\\"og:image:width\\" content=\\"1200\\">\\u003cmeta data-mint-head property=\\"og:image:height\\" content=\\"630\\">\\u003cmeta data-mint-head name=\\"twitter:card\\" content=\\"summary\_large\_image\\">\\u003cmeta data-mint-head name=\\"twitter:title\\" content=\\"High-Performance Developer Environments with Devboxes - Namespace Documentation\\">\\u003cmeta data-mint-head name=\\"twitter:image\\" content=\\"https://namespace-labs.mintlify.app/\_mintlify/api/og/v2?division=Devboxes\\u0026amp;title=High-Performance+Developer+Environments+with+Devboxes\\u0026amp;theme=1f89d53762a6d5304d1c63c4\\u0026amp;signature=5273db9d0dcc0067441caa39d40610b2f5e0013b33fa3f4d64b1e4b219bc2112\\">\\u003cmeta data-mint-head name=\\"twitter:image:width\\" content=\\"1200\\">\\u003cmeta data-mint-head name=\\"twitter:image:height\\" content=\\"630\\">\\u003cmeta data-mint-head name=\\"msapplication-config\\" content=\\"/docs/mintlify-assets/\_mintlify/favicons/namespace-labs/kZKeJ4zhJEuE6\_kI/\_generated/favicon/browserconfig.xml\\">\\u003cmeta data-mint-head name=\\"apple-mobile-web-app-title\\" content=\\"Namespace Documentation\\">\\u003cmeta data-mint-head name=\\"msapplication-TileColor\\" content=\\"#1C32FF\\">\\u003clink data-mint-head rel=\\"canonical\\" href=\\"https://namespace.so/docs/devbox\\">\\u003clink data-mint-head rel=\\"alternate\\" type=\\"application/xml\\" href=\\"/docs/sitemap.xml\\">\\u003clink data-mint-head rel=\\"alternate\\" type=\\"text/markdown\\" href=\\"/docs/devbox.md\\">\\u003cscript data-mint-head type=\\"application/ld+json\\">{\\"@context\\":\\"https://schema.org\\",\\"@graph\\":\[{\\"@type\\":\\"Organization\\",\\"@id\\":\\"https://namespace.so/#organization\\",\\"name\\":\\"Namespace Documentation\\",\\"url\\":\\"https://namespace.so\\",\\"logo\\":{\\"@type\\":\\"ImageObject\\",\\"url\\":\\"https://mintcdn.com/namespace-labs/qOJQ7kaWRgoS8lyv/logo-light.svg?fit=max\\u0026auto=format\\u0026n=qOJQ7kaWRgoS8lyv\\u0026q=85\\u0026s=6827b0c81c335badc1cef13b83383e1d\\"}},{\\"@type\\":\\"WebSite\\",\\"@id\\":\\"https://namespace.so/docs#website\\",\\"name\\":\\"Namespace Documentation\\",\\"url\\":\\"https://namespace.so/docs\\",\\"publisher\\":{\\"@id\\":\\"https://namespace.so/#organization\\"}},{\\"@type\\":\\"WebPage\\",\\"@id\\":\\"https://namespace.so/docs/devbox#webpage\\",\\"url\\":\\"https://namespace.so/docs/devbox\\",\\"name\\":\\"High-Performance Developer Environments with Devboxes\\",\\"dateModified\\":\\"2026-10-16T14:23:13.000Z\\",\\"isPartOf\\":{\\"@id\\":\\"https://namespace.so/docs#website\\"},\\"breadcrumb\\":{\\"@id\\":\\"https://namespace.so/docs/devbox#breadcrumb\\"}},{\\"@type\\":\\"BreadcrumbList\\",\\"@id\\":\\"https://namespace.so/docs/devbox#breadcrumb\\",\\"itemListElement\\":\[{\\"@type\\":\\"ListItem\\",\\"position\\":1,\\"name\\":\\"Products\\",\\"item\\":\\"https://namespace.so/docs/solutions/github-actions/index\\"},{\\"@type\\":\\"ListItem\\",\\"position\\":2,\\"name\\":\\"Devboxes\\",\\"item\\":\\"https://namespace.so/docs/devbox/index\\"},{\\"@type\\":\\"ListItem\\",\\"position\\":3,\\"name\\":\\"High-Performance Developer Environments with Devboxes\\",\\"item\\":\\"https://namespace.so/docs/devbox\\"}\]},{\\"@type\\":\[\\"Article\\",\\"TechArticle\\"\],\\"@id\\":\\"https://namespace.so/docs/devbox#article\\",\\"headline\\":\\"High-Performance Developer Environments with Devboxes\\",\\"name\\":\\"High-Performance Developer Environments with Devboxes\\",\\"url\\":\\"https://namespace.so/docs/devbox\\",\\"mainEntityOfPage\\":{\\"@id\\":\\"https://namespace.so/docs/devbox#webpage\\"},\\"dateModified\\":\\"2026-10-16T14:23:13.000Z\\",\\"publisher\\":{\\"@id\\":\\"https://namespace.so/#organization\\"},\\"isPartOf\\":{\\"@id\\":\\"https://namespace.so/docs#website\\"}}\]}\\u003c/script>\\u003cscript data-mint-head type=\\"application/ld+json\\">{\\"@context\\":\\"https://schema.org\\",\\"@type\\":\\"WebSite\\",\\"name\\":\\"Namespace Documentation\\",\\"creator\\":{\\"@type\\":\\"Organization\\",\\"name\\":\\"Mintlify\\",\\"url\\":\\"https://mintlify.com\\"}}\\u003c/script>","siteName":"Namespace Documentation","nav":{"global":{"anchors":\[{"anchor":"Changelog","icon":"history","href":"https://namespace.so/changelog"},{"anchor":"Trust Center (SOC2)","icon":"shield-check","href":"https://trust.namespace.so/"},{"anchor":"Status","icon":"activity","href":"https://namespace-status.com/"},{"anchor":"Support","icon":"message-circle","href":"https://namespace.so/support"}\]},"products":\[{"product":"Products","description":"Turnkey products built on the Namespace platform","tabs":\[{"tab":"Documentation","icon":"book-open","pages":\[{"title":"Namespace Documentation","sidebarTitle":"Overview","href":""},{"group":"Products","pages":\[{"group":"GitHub Actions","icon":"github","pages":\[{"title":"Accelerate your GitHub Actions with Namespace","sidebarTitle":"Getting Started","href":"/solutions/github-actions/index"},{"group":"Cache Volumes","pages":\[{"title":"Caching in GitHub Actions","sidebarTitle":"Overview","href":"/solutions/github-actions/caching/index"},{"title":"Container Images","href":"/solutions/github-actions/caching/container-images"},{"title":"Git Checkouts","href":"/solutions/github-actions/caching/git-checkouts"},{"title":"Toolchains","sidebarTitle":"Toolchains","href":"/solutions/github-actions/caching/toolchains"},{"title":"Actions","sidebarTitle":"Actions","href":"/solutions/github-actions/caching/actions"},{"title":"Build System Integrations","sidebarTitle":"Build Systems","href":"/solutions/github-actions/caching/build-systems"},{"title":"Troubleshooting cache volumes","sidebarTitle":"Troubleshooting","href":"/solutions/github-actions/caching/troubleshooting"}\]},{"title":"Fast repository checkouts with Git snapshots","sidebarTitle":"Git Snapshots","href":"/solutions/github-actions/git-snapshots"},{"title":"Optimizing Docker build performance","sidebarTitle":"Docker Builds","href":"/solutions/github-actions/docker-builds"},{"title":"Custom base images for GitHub Actions","sidebarTitle":"Custom Base Images","href":"/solutions/github-actions/custom-base-images/index"},{"group":"Debugging","pages":\[{"title":"Debugging GitHub Actions","sidebarTitle":"Overview","href":"/solutions/github-actions/debugging/index"},{"title":"Interactive Access","href":"/solutions/github-actions/debugging/interactive-access"},{"title":"Remote Display","href":"/solutions/github-actions/debugging/remote-display"},{"title":"Performance Metrics","href":"/solutions/github-actions/debugging/performance-metrics"},{"title":"Advanced Logging","href":"/solutions/github-actions/debugging/logging"},{"title":"Out of memory (OOM) detection","sidebarTitle":"OOM Detection","href":"/solutions/github-actions/debugging/oom-detection"},{"title":"Crash Dumps","href":"/solutions/github-actions/debugging/crash-dumps"},{"title":"Queue Time","href":"/solutions/github-actions/debugging/queue-time"}\]},{"group":"Runner Controls","pages":\[{"title":"Runner Controls","sidebarTitle":"Overview","href":"/solutions/github-actions/runner-controls"},{"title":"Concurrent runners","href":"/solutions/github-actions/runner-controls/concurrent-runners"},{"title":"Job Ordering \\u0026 Priority","sidebarTitle":"Job Ordering","href":"/solutions/github-actions/runner-controls/job-ordering"},{"title":"Privileged Workflows","sidebarTitle":"Privileged Workflows","href":"/solutions/github-actions/runner-controls/privileged-workflows"},{"title":"Landlock","sidebarTitle":"Landlock","href":"/solutions/github-actions/runner-controls/landlock"},{"title":"Swap Space","sidebarTitle":"Swap Space","href":"/solutions/github-actions/runner-controls/swap"},{"title":"Tailscale","sidebarTitle":"Tailscale","href":"/solutions/github-actions/runner-controls/tailscale"},{"title":"Access Levels","sidebarTitle":"Access Levels","href":"/solutions/github-actions/runner-controls/access-levels"},{"title":"Running jobs in containers","sidebarTitle":"Containerized Jobs","href":"/solutions/github-actions/runner-controls/containerized-jobs"}\]},{"title":"Optimizing Usage","href":"/solutions/github-actions/optimizing-usage"},{"title":"Runner Labels","sidebarTitle":"Runner Labels","href":"/reference/github-actions/runner-configuration"},{"group":"Actions","expanded":false,"pages":\[{"title":"nscloud-setup","href":"/reference/github-actions/nscloud-setup"},{"title":"nscloud-setup-buildx-action","href":"/reference/github-actions/nscloud-setup-buildx-action"},{"title":"nscloud-cluster-action","href":"/reference/github-actions/nscloud-cluster-action"},{"title":"nscloud-cache-action","href":"/reference/github-actions/nscloud-cache-action"},{"title":"nscloud-checkout-action","href":"/reference/github-actions/nscloud-checkout-action"},{"title":"nscloud-expose-kubernetes-action","href":"/reference/github-actions/nscloud-expose-kubernetes-action"},{"title":"breakpoint-action","href":"/reference/github-actions/breakpoint"},{"title":"upload-artifact","href":"/reference/github-actions/upload-artifact"},{"title":"download-artifact","href":"/reference/github-actions/download-artifact"},{"title":"setup-turbocache","description":null,"href":"/reference/github-actions/setup-turbocache"}\]}\]},{"group":"Devboxes","icon":"container","pages":\[{"title":"High-Performance Developer Environments with Devboxes","sidebarTitle":"Getting Started","href":"/devbox/index"},{"group":"Managing Devboxes","expanded":false,"pages":\[{"title":"Devbox Lifecycle","sidebarTitle":"Lifecycle","description":"Follow a Devbox through its life: create it, find it again, stop and resume it, and delete it when you are done.","href":"/devbox/lifecycle"},{"title":"Devbox Blueprints","sidebarTitle":"Blueprints","href":"/devbox/blueprint"},{"title":"Devbox Services","sidebarTitle":"Services","href":"/devbox/services"},{"title":"Shareable URLs","href":"/devbox/url"},{"title":"Custom Images","href":"/devbox/images"}\]},{"group":"Working in a Devbox","expanded":false,"pages":\[{"title":"Connecting to a Devbox","sidebarTitle":"SSH \\u0026 Sessions","href":"/devbox/connecting"},{"title":"Executing Commands","href":"/devbox/exec"},{"title":"Running long tasks","sidebarTitle":"Long Running Tasks","href":"/guides/devbox/long-running-tasks"},{"title":"Computer Controls","sidebarTitle":"Computer Use","href":"/devbox/computer-use"},{"title":"Remote Desktop","sidebarTitle":"Remote Desktop","href":"/devbox/remote-desktop"},{"title":"Open IDE","href":"/devbox/ides"}\]},{"group":"Managed Agents","tag":"Integrations","expanded":false,"pages":\[{"title":"Amp Orbs","sidebarTitle":"Amp Orbs","href":"/integrations/amp"},{"title":"Claude Managed Agents","sidebarTitle":"Claude Managed Agents","href":"/integrations/claude"},{"title":"Cursor Cloud Agents","sidebarTitle":"Cursor Cloud Agents","href":"/integrations/cursor"},{"title":"Devin on Devboxes","sidebarTitle":"Devin","href":"/integrations/devin"}\]}\]},{"group":"Bazel","icon":"hammer","pages":\[{"title":"Speed up your Bazel builds with Namespace","sidebarTitle":"Introduction","href":"/bazel/index"},{"title":"Bazel cache","sidebarTitle":"Caching","href":"/bazel/cache"},{"title":"Bazel Remote Execution","sidebarTitle":"Remote Build Execution","href":"/bazel/execution"},{"title":"Bazel observability","sidebarTitle":"Observability","href":"/bazel/observability"}\]},{"group":"Docker Builders","icon":"container","pages":\[{"title":"Speed up your Docker Builds with Namespace","sidebarTitle":"Getting Started","href":"/solutions/docker-builders/index"},{"title":"Container Registry","href":"/solutions/docker-builders/registry"},{"title":"Docker Build Observability","sidebarTitle":"Tracing \\u0026 Logs","href":"/solutions/docker-builders/tracing-and-logs"}\]},{"group":"Buildkite Agents","icon":"workflow","pages":\[{"title":"Run Buildkite Jobs on Namespace","sidebarTitle":"Getting Started","href":"/solutions/buildkite-agents/index"},{"title":"Managing Buildkite Queues","sidebarTitle":"Managing Queues","href":"/solutions/buildkite-agents/managing-queues"},{"title":"Configure Buildkite Agents","sidebarTitle":"Configuration","href":"/solutions/buildkite-agents/configuration"},{"title":"Fast repository checkouts with Git snapshots","sidebarTitle":"Git Snapshots","href":"/solutions/buildkite-agents/git-snapshots"}\]}\]},{"group":"Platform","pages":\[{"group":"Compute","icon":"cpu","pages":\[{"title":"Compute Platform","sidebarTitle":"Overview","href":"/architecture/compute/index"},{"title":"Linux","href":"/architecture/compute/linux"},{"title":"macOS","href":"/architecture/compute/macos"},{"title":"Windows","href":"/architecture/compute/windows"},{"title":"Observability","href":"/architecture/compute/observability"},{"title":"SSH / Remote Display with Namespace Compute","sidebarTitle":"SSH / Remote Display","href":"/architecture/compute/ssh-remote-display"},{"title":"Machine Shapes","href":"/architecture/compute/machine-shapes"},{"title":"Resource Limits","href":"/architecture/compute/resource-limits"}\]},{"group":"Storage","icon":"database","pages":\[{"title":"Storage","sidebarTitle":"Overview","href":"/architecture/storage/index"},{"title":"Cache Volumes","href":"/architecture/storage/cache-volumes"},{"title":"Container Registry","href":"/architecture/storage/container-registry"},{"title":"Artifact Storage","href":"/architecture/storage/artifact-storage"},{"title":"Secrets","href":"/architecture/storage/secrets"}\]},{"group":"Networking","icon":"network","pages":\[{"title":"Networking","sidebarTitle":"Overview","href":"/architecture/networking/index"},{"title":"Ingress","href":"/architecture/networking/ingress"},{"title":"Network Performance Optimizations","sidebarTitle":"Performance","href":"/architecture/networking/performance"},{"title":"Network Security","sidebarTitle":"Security","href":"/architecture/networking/security"},{"title":"Egress policies","href":"/security/egress-policy"}\]}\]},{"group":"Administration","pages":\[{"group":"Workspaces","icon":"briefcase-business","pages":\[{"title":"Workspaces","sidebarTitle":"Overview","href":"/workspaces/index"},{"title":"Workspace Access Controls","sidebarTitle":"Access","href":"/workspaces/access"},{"title":"Billing \\u0026 Included Amounts","sidebarTitle":"Billing and limits","href":"/workspaces/billing-and-limits"},{"title":"Data Residency for Workspaces","sidebarTitle":"Data residency","href":"/workspaces/data-residency"},{"title":"Security \\u0026 Compliance","sidebarTitle":"Security","href":"/workspaces/security"},{"title":"Audit Logs","sidebarTitle":"Audit logging","href":"/security/auditlog"},{"title":"Permissions","href":"/security/permissions"}\]},{"group":"Federation","icon":"shield-check","pages":\[{"title":"Workload Federation","sidebarTitle":"Overview","href":"/federation/index"},{"title":"Workload Federation with AWS","sidebarTitle":"AWS","href":"/federation/aws"},{"title":"Workload Federation with GCP","sidebarTitle":"GCP","href":"/federation/gcp"},{"title":"Workload Federation with OpenID Connect","sidebarTitle":"OpenID","href":"/federation/openid"},{"title":"Identity Federation with GitHub Actions","sidebarTitle":"Github Actions","href":"/federation/github-actions"},{"title":"Identity Federation with CircleCI","sidebarTitle":"CircleCI","href":"/federation/circleci"},{"title":"Identity Federation with RWX","sidebarTitle":"RWX","href":"/federation/rwx"}\]},{"group":"Dashboard","icon":"layout-dashboard","pages":\[{"title":"GitHub Actions Overview","sidebarTitle":"GitHub Actions","href":"/dashboard/github-actions"},{"title":"Builds UI","sidebarTitle":"Builds","href":"/dashboard/builds"},{"title":"Registry UI","sidebarTitle":"Registry","href":"/dashboard/registry"},{"title":"Usage Explorer","href":"/dashboard/usage-explorer"}\]}\]}\]},{"tab":"Integrations","icon":"blocks","pages":\[{"title":"Integrations","href":"/integrations/turborepo"}\]},{"tab":"CLI","icon":"square-terminal","pages":\[{"title":"CLI","href":"/reference/cli"}\]},{"tab":"SDK","icon":"braces","pages":\[{"title":"SDK","href":"/reference/sdk"}\]},{"tab":"MCP","icon":"plug","pages":\[{"title":"MCP","href":"/reference/mcp"}\]}\]},{"product":"Platform","description":"Lower-level primitives to build your own","pages":\[{"title":"Platform","href":"/platform"}\]}\]},"title":"High-Performance Developer Environments with Devboxes - Namespace Documentation","buildId":"dpl\_GvhK4qVXq51DpfYJLCtPpYNN4YHN","deploymentId":"dpl\_GvhK4qVXq51DpfYJLCtPpYNN4YHN","dynamics":\["07c022d89b","a74be98ba7"\],"chunks":\["Frame-5VlDM5Io.js","DynamicMarkdown-DO1Fz7ar.js","zoom-image-lightbox-uyuQJRFs.js","lightbox-handle-r17bVUz3.js"\]}