Namespace Command Line Tools - Namespace Documentation

Documentation Index

Fetch the complete documentation index at: /docs/llms.txt

Use this file to discover all available pages before exploring further.

Skip to main content

Assistant

Responses are generated using AI and may contain mistakes.

Namespace has two command line tools. nsc drives the Namespace platform, and devbox drives Devboxes. They are installed separately, and each one authenticates against your workspace on its own.

Namespace CLI \ \ Install nsc and run the platform from your terminal.

Devbox CLI \ \ Install devbox to create and work in Devboxes.

Get started

Namespace CLI
Devbox CLI

curl -fsSL https://get.namespace.so/cloud/install.sh | sh
nsc login

# Start an ephemeral instance, then open a shell in it
nsc create
nsc ssh <instance-id>

See Installation for Homebrew, npm, Hermit, and Windows.

curl -fsSL get.namespace.so/devbox/install.sh | bash
devbox login

# Create a Devbox, then open a shell in it
devbox create --name my-devbox
devbox ssh my-devbox

See Installation for macOS, Linux, and Windows.

Common tasks

Both tools cover the same shape of work on different resources.

Task	Namespace CLI	Devbox CLI
Log in	`nsc login`	`devbox login`
Create	`nsc create`	`devbox create`
List what is running	`nsc list`	`devbox list`
Open a shell	`nsc ssh`	`devbox ssh`
Run one command	`nsc run`	`devbox exec`
Tear down	`nsc destroy`	`devbox delete`

If you want to drive Namespace from code instead of a terminal, see the API and SDKs.

Last modified onSeptember 25, 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":"reference/cli","slug":"/reference/cli","pageMetadata":{"title":"Namespace Command Line Tools","sidebarTitle":"Overview","icon":"terminal","description":null,"href":"/reference/cli/index"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Card,CardGroup,CodeBlock,Heading,Info,Tab,Table,Tabs}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Namespace has two command line tools. `,_jsx(_components.code,{children:`nsc`}),` drives the Namespace platform, and `,_jsx(_components.code,{children:`devbox`}),` drives Devboxes. They are installed separately, and each one authenticates against your `,_jsx(_components.a,{href:`/workspaces`,children:`workspace`}),` on its own.`]}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Namespace CLI`,icon:`square-terminal`,href:`/reference/cli/installation`,children:_jsxs(_components.p,{children:[`Install `,_jsx(_components.code,{children:`nsc`}),` and run the platform from your terminal.`]})}),_jsx(Card,{title:`Devbox CLI`,icon:`container`,href:`/reference/devbox-cli/installation`,children:_jsxs(_components.p,{children:[`Install `,_jsx(_components.code,{children:`devbox`}),` to create and work in Devboxes.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`get-started`,children:`Get started`}),`\n`,_jsxs(Tabs,{children:[_jsxs(Tab,{title:`Namespace CLI`,id:`namespace-cli`,children:[_jsx(CodeBlock,{filename:``,numberOfLines:`6`,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:`6`,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:` https://get.namespace.so/cloud/install.sh\`}),\_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` |`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` sh`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`nsc`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` login`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Start an ephemeral instance, then open a shell in it`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`nsc`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` create`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`nsc`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ssh`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` \u003c`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`instance-i`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`d`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`>`})]}),`\n`]})})}),_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/reference/cli/installation`,children:`Installation`}),` for Homebrew, npm, Hermit, and Windows.`]})]}),_jsxs(Tab,{title:`Devbox CLI`,id:`devbox-cli`,children:[_jsx(CodeBlock,{filename:``,numberOfLines:`6`,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:`6`,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(_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.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Create a Devbox, then open a shell in it`})}),`\n`,_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`})]}),`\n`,_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:` ssh`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` my-devbox`})]}),`\n`]})})}),_jsxs(_components.p,{children:[`See `,_jsx(_components.a,{href:`/reference/devbox-cli/installation`,children:`Installation`}),` for macOS, Linux, and Windows.`]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`common-tasks`,children:`Common tasks`}),`\n`,_jsx(_components.p,{children:`Both tools cover the same shape of work on different resources.`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Task`}),_jsx(_components.th,{children:`Namespace CLI`}),_jsx(_components.th,{children:`Devbox CLI`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Log in`}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/reference/cli/login`,children:_jsx(_components.code,{children:`nsc login`})})}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/reference/devbox-cli/auth#devbox-auth-login`,children:_jsx(_components.code,{children:`devbox login`})})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Create`}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/reference/cli/create`,children:_jsx(_components.code,{children:`nsc create`})})}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/reference/devbox-cli/create`,children:_jsx(_components.code,{children:`devbox create`})})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`List what is running`}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/reference/cli/list`,children:_jsx(_components.code,{children:`nsc list`})})}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/reference/devbox-cli/list`,children:_jsx(_components.code,{children:`devbox list`})})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Open a shell`}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/reference/cli/ssh`,children:_jsx(_components.code,{children:`nsc ssh`})})}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/reference/devbox-cli/ssh`,children:_jsx(_components.code,{children:`devbox ssh`})})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Run one command`}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/reference/cli/run`,children:_jsx(_components.code,{children:`nsc run`})})}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/reference/devbox-cli/exec`,children:_jsx(_components.code,{children:`devbox exec`})})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Tear down`}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/reference/cli/destroy`,children:_jsx(_components.code,{children:`nsc destroy`})})}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/reference/devbox-cli/delete`,children:_jsx(_components.code,{children:`devbox delete`})})})]})]})]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`If you want to drive Namespace from code instead of a terminal, see the `,_jsx(_components.a,{href:`/reference/sdk`,children:`API and SDKs`}),`.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{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":"Namespace Command Line Tools","sidebarTitle":"Overview","icon":"terminal","description":null,"href":"/reference/cli/index"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Get started","slug":"get-started","depth":2,"children":[]},{"title":"Common tasks","slug":"common-tasks","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":"Namespace Command Line Tools - Namespace Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-26T10:46:17.592Z","gitLastModified":"2026-09-25T10:29:59.000Z","originalFileLocation":"reference/cli/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=\"Namespace Command Line Tools - 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/reference/cli\\">\\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=Documentation\\u0026amp;title=Namespace+Command+Line+Tools\\u0026amp;theme=1f89d53762a6d5304d1c63c4\\u0026amp;signature=c3a3a4cb6b0eff14389698af48bd2a071e00010c0777bd96849ebe1cccf88f1b\\">\\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=\"Namespace Command Line Tools - Namespace Documentation\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://namespace-labs.mintlify.app/\_mintlify/api/og/v2?division=Documentation\\u0026amp;title=Namespace+Command+Line+Tools\\u0026amp;theme=1f89d53762a6d5304d1c63c4\\u0026amp;signature=c3a3a4cb6b0eff14389698af48bd2a071e00010c0777bd96849ebe1cccf88f1b\\">\\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/reference/cli\\">\\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/reference/cli.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/reference/cli#webpage\\",\\"url\\":\\"https://namespace.so/docs/reference/cli\\",\\"name\\":\\"Namespace Command Line Tools\",\"dateModified\":\"2026-09-25T10:29:59.000Z\",\"isPartOf\":{\"@id\":\"https://namespace.so/docs#website\\"}},{\\"@type\\":\[\\"Article\\",\\"TechArticle\\"\],\\"@id\\":\\"https://namespace.so/docs/reference/cli#article\\",\\"headline\\":\\"Namespace Command Line Tools\",\"name\":\"Namespace Command Line Tools\",\"url\":\"https://namespace.so/docs/reference/cli\\",\\"mainEntityOfPage\\":{\\"@id\\":\\"https://namespace.so/docs/reference/cli#webpage\\"},\\"dateModified\\":\\"2026-09-25T10:29:59.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":"Documentation","href":""}]},{"tab":"Integrations","icon":"blocks","pages":[{"title":"Integrations","href":"/integrations/turborepo"}]},{"tab":"CLI","icon":"square-terminal","pages":[{"title":"Namespace Command Line Tools","sidebarTitle":"Overview","icon":"terminal","href":"/reference/cli"},{"group":"Command line","pages":[{"group":"Namespace CLI","icon":"square-terminal","expanded":false,"pages":[{"title":"Installation","description":null,"href":"/reference/cli/installation"},{"group":"Setup and authentication","icon":"wrench","pages":[{"title":"nsc install","href":"/reference/cli/install"},{"title":"nsc completion","href":"/reference/cli/completion"},{"title":"nsc login","href":"/reference/cli/login"},{"title":"nsc logout","href":"/reference/cli/logout"},{"title":"nsc workspace describe","href":"/reference/cli/workspace-describe"},{"title":"nsc workspace concurrency","href":"/reference/cli/workspace-concurrency"}]},{"group":"Manage instances","icon":"server","pages":[{"title":"nsc create","href":"/reference/cli/create"},{"title":"nsc list","href":"/reference/cli/list"},{"title":"nsc describe","href":"/reference/cli/describe"},{"title":"nsc extend","href":"/reference/cli/extend"},{"title":"nsc destroy","href":"/reference/cli/destroy"},{"title":"nsc scratch ssh","href":"/reference/cli/scratch-ssh"}]},{"group":"Connect and inspect","icon":"terminal","pages":[{"title":"nsc ssh","href":"/reference/cli/ssh"},{"title":"nsc proxy","href":"/reference/cli/proxy"},{"title":"nsc rdp","href":"/reference/cli/rdp"},{"title":"nsc vnc","href":"/reference/cli/vnc"},{"title":"nsc logs","href":"/reference/cli/logs"},{"title":"nsc top","href":"/reference/cli/top"}]},{"group":"Run commands and workloads","icon":"play","pages":[{"title":"nsc run","href":"/reference/cli/run"},{"title":"nsc exec-scoped","href":"/reference/cli/exec-scoped"},{"title":"nsc kubectl","href":"/reference/cli/kubectl"}]},{"group":"Artifact","icon":"package","pages":[{"title":"nsc artifact list","href":"/reference/cli/artifact-list"},{"title":"nsc artifact upload","href":"/reference/cli/artifact-upload"},{"title":"nsc artifact download","href":"/reference/cli/artifact-download"},{"title":"nsc artifact describe","href":"/reference/cli/artifact-describe"},{"title":"nsc artifact extend","href":"/reference/cli/artifact-extend"},{"title":"nsc artifact expire","href":"/reference/cli/artifact-expire"},{"title":"nsc artifact cache-url","href":"/reference/cli/artifact-cache-url"}]},{"group":"Auth","icon":"key-round","pages":[{"title":"nsc auth check-login","href":"/reference/cli/auth-check-login"},{"title":"nsc auth generate-dev-token","href":"/reference/cli/auth-generate-dev-token"},{"title":"nsc auth issue-id-token","href":"/reference/cli/auth-issue-id-token"},{"title":"nsc auth issue-client-cert","href":"/reference/cli/auth-issue-client-cert"},{"title":"nsc auth exchange-oidc-token","href":"/reference/cli/auth-exchange-oidc-token"},{"title":"nsc auth exchange-aws-cognito-token","href":"/reference/cli/auth-exchange-aws-cognito-token"},{"title":"nsc auth exchange-circleci-token","href":"/reference/cli/auth-exchange-circleci-token"},{"title":"nsc auth trust-aws-cognito-identity-pool","href":"/reference/cli/auth-trust-aws-cognito-identity-pool"},{"title":"nsc auth trust-relationships","href":"/reference/cli/auth-trust-relationships"},{"title":"nsc auth trust-relationships list","href":"/reference/cli/auth-trust-relationships-list"},{"title":"nsc auth trust-relationships add","href":"/reference/cli/auth-trust-relationships-add"},{"title":"nsc auth trust-relationships update","href":"/reference/cli/auth-trust-relationships-update"},{"title":"nsc auth trust-relationships remove","href":"/reference/cli/auth-trust-relationships-remove"},{"title":"nsc aws assume-role","href":"/reference/cli/aws-assume-role"}]},{"group":"Base image","icon":"layers","pages":[{"title":"nsc base-image upload","href":"/reference/cli/base-image-upload"},{"title":"nsc base-image optimize","href":"/reference/cli/base-image-optimize"},{"title":"nsc base-image build-github-image","href":"/reference/cli/base-image-build-github-image"}]},{"group":"Bazel","icon":"boxes","pages":[{"title":"nsc bazel create-token","href":"/reference/cli/bazel-create-token"},{"title":"nsc bazel invocation list","href":"/reference/cli/bazel-invocation-list"},{"title":"nsc bazel invocation report","href":"/reference/cli/bazel-invocation-report"},{"title":"nsc bazel setup","href":"/reference/cli/bazel-setup"}]},{"group":"Build","icon":"hammer","pages":[{"title":"nsc build","href":"/reference/cli/build"},{"title":"nsc build logs","href":"/reference/cli/build-logs"},{"title":"nsc build resolve","href":"/reference/cli/build-resolve"}]},{"group":"Buildkite","icon":"/images/buildkite-agents/buildkite-mark.svg","pages":[{"title":"nsc buildkite queue","href":"/reference/cli/buildkite-queue"},{"title":"nsc buildkite queue list","href":"/reference/cli/buildkite-queue-list"},{"title":"nsc buildkite queue describe","href":"/reference/cli/buildkite-queue-describe"},{"title":"nsc buildkite queue update","href":"/reference/cli/buildkite-queue-update"}]},{"group":"Cache","icon":"database","pages":[{"title":"nsc cache bazel setup","href":"/reference/cli/bazel-cache-setup"},{"title":"nsc cache buck2 setup","href":"/reference/cli/cache-buck2-setup"},{"title":"nsc cache gradle setup","href":"/reference/cli/gradle-cache-setup"},{"title":"nsc cache gradle create-token","href":"/reference/cli/cache-gradle-create-token"},{"title":"nsc cache pants setup","href":"/reference/cli/pants-cache-setup"},{"title":"nsc cache sccache setup","href":"/reference/cli/sccache-setup"},{"title":"nsc cache sccache create-token","href":"/reference/cli/cache-sccache-create-token"},{"title":"nsc cache turborepo setup","href":"/reference/cli/cache-turborepo-setup"},{"title":"nsc cache turborepo list","href":"/reference/cli/cache-turborepo-list"}]},{"group":"Docker","icon":"container","pages":[{"title":"nsc docker login","href":"/reference/cli/docker-login"},{"title":"nsc docker attach-context","href":"/reference/cli/docker-attach"},{"title":"nsc docker remote","href":"/reference/cli/docker-remote"},{"title":"nsc docker buildx setup","href":"/reference/cli/docker-buildx-setup"},{"title":"nsc docker buildx status","href":"/reference/cli/docker-buildx-status"},{"title":"nsc docker buildx cleanup","href":"/reference/cli/docker-buildx-cleanup"}]},{"group":"Egress","icon":"shield","pages":[{"title":"nsc egress policy list","href":"/reference/cli/egress-policy-list"},{"title":"nsc egress policy describe","href":"/reference/cli/egress-policy-describe"},{"title":"nsc egress policy create","href":"/reference/cli/egress-policy-create"},{"title":"nsc egress policy update","href":"/reference/cli/egress-policy-update"},{"title":"nsc egress logs","href":"/reference/cli/egress-logs"}]},{"group":"Expose","icon":"radio-tower","pages":[{"title":"nsc expose container","href":"/reference/cli/expose"},{"title":"nsc expose kubernetes","href":"/reference/cli/expose-kubernetes"}]},{"group":"Git checkout","icon":"git-branch","pages":[{"title":"nsc git-checkout update-submodules","href":"/reference/cli/update-submodules"}]},{"group":"GitHub","icon":"github","pages":[{"title":"nsc github profile","href":"/reference/cli/github-profile"},{"title":"nsc github profile create","href":"/reference/cli/github-profile-create"},{"title":"nsc github profile list","href":"/reference/cli/github-profile-list"},{"title":"nsc github profile describe","href":"/reference/cli/github-profile-describe"},{"title":"nsc github profile update","href":"/reference/cli/github-profile-update"},{"title":"nsc github profile delete","href":"/reference/cli/github-profile-delete"},{"title":"nsc github profile test-build-base-image","href":"/reference/cli/github-profile-test-build-base-image"},{"title":"nsc github profile rebuild-base-image","href":"/reference/cli/github-profile-rebuild-base-image"},{"title":"nsc github base-image list","href":"/reference/cli/github-base-image-list"},{"title":"nsc github base-image describe","href":"/reference/cli/github-base-image-describe"},{"title":"nsc github job list","href":"/reference/cli/github-job-list"},{"title":"nsc github job describe","href":"/reference/cli/github-job-describe"}]},{"group":"Ingress","icon":"network","pages":[{"title":"nsc ingress list","href":"/reference/cli/ingress-list"},{"title":"nsc ingress generate-access-token","href":"/reference/cli/ingress-generate-access-token"}]},{"group":"Instance","icon":"server","pages":[{"title":"nsc instance history","href":"/reference/cli/instance-history"},{"title":"nsc instance report","href":"/reference/cli/instance-report"},{"title":"nsc instance metadata read","href":"/reference/cli/instance-metadata"},{"title":"nsc instance port-forward","href":"/reference/cli/instance-port-forward"},{"title":"nsc instance download","href":"/reference/cli/instance-download"},{"title":"nsc instance upload","href":"/reference/cli/instance-upload"}]},{"group":"Integrations","icon":"plug","pages":[{"title":"nsc integrations tailscale list","href":"/reference/cli/integrations-tailscale-list"},{"title":"nsc integrations tailscale set","href":"/reference/cli/integrations-tailscale-set"},{"title":"nsc integrations tailscale remove","href":"/reference/cli/integrations-tailscale-remove"}]},{"group":"Kubeconfig","icon":"file-key","pages":[{"title":"nsc kubeconfig write","href":"/reference/cli/kubeconfig-write"}]},{"group":"Registry","icon":"archive","pages":[{"title":"nsc registry list","href":"/reference/cli/registry-list"},{"title":"nsc registry describe","href":"/reference/cli/registry-describe"},{"title":"nsc registry share","href":"/reference/cli/registry-share"},{"title":"nsc registry update-image-expiration","href":"/reference/cli/registry-update-image-expiration"},{"title":"nsc registry default-expiration","href":"/reference/cli/registry-default-expiration"},{"title":"nsc registry policy","href":"/reference/cli/registry-policy"},{"title":"nsc registry policy get","href":"/reference/cli/registry-policy-get"},{"title":"nsc registry policy set","href":"/reference/cli/registry-policy-set"}]},{"group":"Reservation","icon":"calendar-clock","pages":[{"title":"nsc reservation list","href":"/reference/cli/reservation-list"},{"title":"nsc reservation describe","href":"/reference/cli/reservation-describe"},{"title":"nsc reservation wait","href":"/reference/cli/reservation-wait"},{"title":"nsc reservation cancel","href":"/reference/cli/reservation-cancel"}]},{"group":"Token","icon":"key","pages":[{"title":"nsc token create","href":"/reference/cli/token-create"},{"title":"nsc token list","href":"/reference/cli/token-list"},{"title":"nsc token refresh","href":"/reference/cli/token-refresh"},{"title":"nsc token revoke","href":"/reference/cli/token-revoke"}]},{"group":"Vault","icon":"lock-keyhole","pages":[{"title":"nsc vault list","href":"/reference/cli/vault-list"},{"title":"nsc vault add","href":"/reference/cli/vault-add"},{"title":"nsc vault set","href":"/reference/cli/vault-set"},{"title":"nsc vault delete","href":"/reference/cli/vault-delete"},{"title":"nsc vault export","href":"/reference/cli/vault-export"}]},{"group":"Version","icon":"badge-info","pages":[{"title":"nsc version","href":"/reference/cli/version"},{"title":"nsc version check","href":"/reference/cli/version-check"},{"title":"nsc version ensure","href":"/reference/cli/version-ensure"},{"title":"nsc version update","href":"/reference/cli/version-update"}]},{"group":"Volume","icon":"hard-drive","pages":[{"title":"nsc volume list","href":"/reference/cli/volume-list"},{"title":"nsc volume release","href":"/reference/cli/volume-release"}]}]},{"group":"Devbox CLI","icon":"square-terminal","expanded":false,"pages":[{"group":"Setup","icon":"wrench","expanded":false,"pages":[{"title":"Installation","href":"/reference/devbox-cli/installation"},{"title":"Agent Skills","href":"/reference/devbox-cli/agent-skills"},{"title":"devbox auth","sidebarTitle":"auth","href":"/reference/devbox-cli/auth"},{"title":"devbox update","sidebarTitle":"update","href":"/reference/devbox-cli/update"},{"title":"devbox version","sidebarTitle":"version","href":"/reference/devbox-cli/version"},{"title":"devbox completion","sidebarTitle":"completion","href":"/reference/devbox-cli/completion"},{"title":"devbox site-latency","sidebarTitle":"site-latency","href":"/reference/devbox-cli/site-latency"}]},{"group":"Manage Devboxes","icon":"server","pages":[{"title":"devbox create","sidebarTitle":"create","href":"/reference/devbox-cli/create"},{"title":"Devbox spec file","sidebarTitle":"spec file","href":"/reference/devbox-cli/spec-file"},{"title":"devbox list","sidebarTitle":"list","href":"/reference/devbox-cli/list"},{"title":"devbox stop","sidebarTitle":"stop","href":"/reference/devbox-cli/stop"},{"title":"devbox delete","sidebarTitle":"delete","href":"/reference/devbox-cli/delete"}]},{"group":"Connect and run","icon":"terminal","pages":[{"title":"devbox desktop","sidebarTitle":"desktop","href":"/reference/devbox-cli/desktop"},{"title":"devbox configure-ssh","sidebarTitle":"configure-ssh","href":"/reference/devbox-cli/configure-ssh"},{"title":"devbox ssh","sidebarTitle":"ssh","href":"/reference/devbox-cli/ssh"},{"title":"devbox session","sidebarTitle":"session","href":"/reference/devbox-cli/session"},{"title":"devbox exec","sidebarTitle":"exec","href":"/reference/devbox-cli/exec"},{"title":"devbox logs","sidebarTitle":"logs","href":"/reference/devbox-cli/logs"},{"title":"devbox service","sidebarTitle":"service","href":"/reference/devbox-cli/service"},{"title":"devbox open-ide","sidebarTitle":"open-ide","href":"/reference/devbox-cli/open-ide"}]},{"group":"Ports and URLs","icon":"network","pages":[{"title":"devbox port-forward","sidebarTitle":"port-forward","href":"/reference/devbox-cli/port-forward"},{"title":"devbox url","sidebarTitle":"url","href":"/reference/devbox-cli/url"}]},{"group":"Images","icon":"layers","pages":[{"title":"devbox image build","sidebarTitle":"image build","href":"/reference/devbox-cli/image-build"},{"title":"devbox image wire","sidebarTitle":"image wire","href":"/reference/devbox-cli/image-wire"},{"title":"devbox image list","sidebarTitle":"image list","href":"/reference/devbox-cli/image-list"},{"title":"devbox image describe","sidebarTitle":"image describe","href":"/reference/devbox-cli/image-describe"},{"title":"devbox image optimize","sidebarTitle":"image optimize","href":"/reference/devbox-cli/image-optimize"},{"title":"devbox image expire","sidebarTitle":"image expire","href":"/reference/devbox-cli/image-expire"}]},{"group":"Files","icon":"folder","pages":[{"title":"devbox upload","sidebarTitle":"upload","href":"/reference/devbox-cli/upload"},{"title":"devbox download","sidebarTitle":"download","href":"/reference/devbox-cli/download"}]},{"group":"Devbox pools","icon":"boxes","pages":[{"title":"devbox acquire","sidebarTitle":"acquire","href":"/reference/devbox-cli/acquire"},{"title":"devbox release","sidebarTitle":"release","href":"/reference/devbox-cli/release"}]},{"group":"Integrations","icon":"plug","pages":[{"title":"devbox setup-github","sidebarTitle":"setup-github","href":"/reference/devbox-cli/setup-github"},{"title":"devbox claude managed-agents","sidebarTitle":"claude","href":"/reference/devbox-cli/claude"}]}]}]}]},{"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":"Namespace Command Line Tools - Namespace Documentation","buildId":"dpl_GvhK4qVXq51DpfYJLCtPpYNN4YHN","deploymentId":"dpl_GvhK4qVXq51DpfYJLCtPpYNN4YHN","dynamics":[],"chunks":[]}