Laminar Agent Sandbox: Work in Your GitHub Repositories
Laminar Agent can work in your project’s GitHub repositories inside a sandbox: a private Linux VM with your repositories cloned into it. In the sandbox the agent reads code, edits files, runs commands, and opens pull requests. Use it to trace a failure back to the code that caused it, add or fix Laminar instrumentation and check that the traces arrive, or write agent evaluations and run them.A sandbox keeps your work between conversations. When it has been idle for 30 minutes it stops, and its files are saved. The next time the agent needs it, the sandbox comes back as it was, for up to 30 days.
Set up the agent sandbox
The agent sandbox is a per-project setting that decides which repositories the agent clones and which LLM keys it gets. Only workspace owners and admins can change it.
Settings > Agent sandbox: two repositories cloned into the sandbox, each at its own branch, and the LLM profiles whose keys the sandbox gets
1
Connect GitHub
Go to Settings > Integrations, under Workspace settings, and connect GitHub. Install the Laminar GitHub App on the organization or account that owns your repositories, and give it access to the repositories you want the agent to work in. A GitHub account can be connected to one Laminar workspace.
Once GitHub is connected, the card shows the GitHub account and links to the Agent sandbox settings
2
Pick the repositories
In the project, go to Settings > Agent sandbox and turn on each repository you want cloned into the sandbox. The list shows every repository the GitHub App can access. To add a repository that isn’t listed, click Manage access on GitHub and grant the app access to it.
3
Pick a branch for each repository
Each selected repository has a branch picker. Leave it on the repository’s default branch, or search for and pick another branch. A new sandbox clones each repository at that branch, and pull requests from the agent target it.
The branch picker lists the repository's branches, with the default branch first
4
Pick the LLM profiles
Under LLM profiles, select the LLM profiles whose API keys the sandbox should get. Do this when the code in your repositories calls an LLM and you want the agent to run it, for example to check that a change produces the trace you expect.
The branch setting applies when a sandbox is created. A sandbox that already exists keeps the branch it has, so start a new chat to work from a branch you changed.
What is in a sandbox
Each sandbox is a Linux VM with git, Node.js, Python, and Docker. Every repository in the environment is cloned into ~/repos/<repository name>, and the agent installs dependencies itself when it needs them.Commands in the sandbox get these environment variables:
LLM keys from the selected profiles, under each provider’s usual names: ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY, GROQ_API_KEY, MISTRAL_API_KEY, the AWS_* variables for Bedrock, and the AZURE_* variables for Azure. Custom gateway profiles get variables prefixed with CUSTOM_LLM_.
LMNR_PROJECT_API_KEY, a project API key that belongs to this sandbox only. The agent uses it to send traces from your code to the project and to run evaluations. A new key is created every time the sandbox starts. It is revoked after the sandbox stops, and expires after 24 hours at the latest. These keys don’t appear on the project’s API keys page.
LMNR_BASE_URL, the Laminar API the key works with.
The sandbox has no GitHub credentials. The agent pushes through Laminar, which only pushes to laminar/ branches and opens pull requests (see Review the agent’s pull requests).
Ask the agent to work in your code
Ask from the Agent panel in the Laminar app, or from your terminal with lmnr-cli ask. Only workspace owners and admins can use the sandbox. The agent doesn’t open a sandbox when you ask from Slack or the MCP server.The agent opens the sandbox when a question needs your code, so you don’t have to ask for it. Some things to ask:
“Find the cause of the errors in the latest failed trace and fix it.”
“Add Laminar tracing to the support agent in support-bot, run it once, and check that the trace looks right.”
“Write evals for the cluster about invented hotel prices and run them.”
“Continue the eval work in the sandbox from my teammate’s chat.”
On a Signal’s cluster, the Create Evals button starts a chat that asks the agent to write evals from that cluster and run them. The agent runs evals with lmnr-cli eval run --remote, so each run shows up in the project’s evaluations, with a trace for every trial.Laminar Agent also reads your code when it writes cluster reports, once the project has repositories in its agent sandbox settings. That sandbox is read-only for the agent: it gets no LLM keys or project API key, and it can’t push or open pull requests.
Review the agent’s pull requests
When the work is done, the agent commits its changes and pushes them to a new laminar/ branch in your repository, then opens a pull request against the branch the sandbox cloned. It replies with the pull request link. Later pushes from the same sandbox add commits to the same pull request.Commits arrive signed by GitHub, so they show as Verified. The agent can’t push changes to .github/workflows/.The agent can also pull the latest commits of that branch into the sandbox, rebasing its own commits on top. If it had already pushed, its next push opens a new pull request from the updated branch.
Sandboxes stop when idle and resume where they left off
A sandbox stops after 30 minutes with no commands running. A command that is still running counts as activity, so a long build or eval run keeps the sandbox up. A sandbox also stops after running for 24 hours.When a sandbox stops, Laminar saves its whole filesystem:
the repositories, including commits and uncommitted changes
installed dependencies, build output, and Docker images
Running processes, such as dev servers, watchers, and Docker containers, are not saved. Docker itself starts again when the sandbox resumes.The next time the agent needs the sandbox, in the same chat or from another one, it starts a new VM from the saved files and carries on. You don’t need to do anything for this. A restored sandbox gets a new LMNR_PROJECT_API_KEY.A saved sandbox is kept for 30 days after it was last used. After that, the chat’s next request starts a fresh sandbox, cloned again from the environment’s branches, and any work in the old sandbox that wasn’t pushed is gone. Ask the agent to open a pull request for work you want to keep.
Sandboxes are shared across the project
Sandboxes belong to the project, not to one chat. The agent can list the project’s running and saved sandboxes, including the ones your teammates’ chats created, and switch your chat to one of them. It only opens a teammate’s sandbox when you ask it to, since the work in it is theirs. Sandboxes used for cluster reports are not listed.A project can have up to 10 sandboxes running at the same time. Stopped sandboxes don’t count toward this limit.Deleting a chat doesn’t delete its sandbox right away: the sandbox stops when it goes idle, and its saved files are deleted 30 days after it was last used.
What’s next
Laminar Agent
Everything the agent can do, and where you can ask it.
Agent evaluations
How the evals the agent writes and runs are structured.
Clusters
The groups of Signal events the agent writes reports and evals from.
LLM profiles
Add the provider keys the agent sandbox hands to your code.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Laminar documentation","colors":{"primary":"#d0754e","light":"#d0754e","dark":"#d0754e"},"logo":"https://mintcdn.com/laminarai/S438DUdrFaxkWj71/logo/laminar-wordmark.svg?fit=max\u0026auto=format\u0026n=S438DUdrFaxkWj71\u0026q=85\u0026s=6b0de22c2375c7edcbfa86892965fc24","favicon":"https://mintcdn.com/laminarai/W6ojRY5YjRjfXRin/favicon.png?fit=max\u0026auto=format\u0026n=W6ojRY5YjRjfXRin\u0026q=85\u0026s=c81860de08addc72dce2e6e580686fcd","appearance":{"default":"dark","strict":true},"background":{"color":{"dark":"#0F0F0F"}},"navbar":{"links":[{"href":"mailto:[email protected]","label":"Contact support"},{"href":"https://laminar.sh/projects","label":"Dashboard"}],"primary":{"type":"github","href":"https://github.com/lmnr-ai/lmnr"}},"footer":{"socials":{"discord":"https://discord.gg/nNFUUDAKub","twitter":"https://twitter.com/lmnrai","linkedin":"https://linkedin.com/company/lmnr-ai","github":"https://github.com/lmnr-ai"}},"icons":{"library":"lucide"},"integrations":{"posthog":{"apiKey":"phc_dUMdjfNKf11jcHgtn7juSnT4P1pO0tafsPUWt4PuwG7","apiHost":"https://p.laminar.sh"}},"thumbnails":{"background":"https://mintcdn.com/laminarai/d9XjS_AxLkd_3ZV5/images/og-background.png?fit=max\u0026auto=format\u0026n=d9XjS_AxLkd_3ZV5\u0026q=85\u0026s=e73fe8bb357c4422f4803266b1b9d15f"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"laminarai","hasAudioNarration":false,"actualSubdomain":"laminarai","customDomains":["laminar.sh"],"gitSource":{"type":"github","owner":"lmnr-ai","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6aff33b137c19af492ce6698","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"default","tag":"Documentation","count":71},{"language":"default","tag":"Integrations","count":34},{"language":"default","tag":"API Reference","count":27},{"language":"default","tag":"Evaluations","count":20},{"language":"default","tag":"Platform","count":20},{"language":"default","tag":"Tracing","count":20},{"language":"default","tag":"SDK","count":14},{"language":"default","tag":"Agent frameworks","count":12},{"language":"default","tag":"Tracing Structure","count":12},{"language":"default","tag":"Signals","count":11}]},"assistantConfig":{},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","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":"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":"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":"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":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","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":"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":"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":"turbopuffer-dual-write","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},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"platform/agent-sandbox","slug":"/platform/agent-sandbox","pageMetadata":{"title":"Laminar Agent Sandbox: Work in Your GitHub Repositories","sidebarTitle":"Agent sandbox","description":null,"href":"/platform/agent-sandbox"},"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`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Card,CardGroup,Frame,Heading,OptimizedImage,Step,Steps}=_components;if(!Card)_missingMdxReference(`Card`,true);if(!CardGroup)_missingMdxReference(`CardGroup`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/platform/laminar-agent`,children:`Laminar Agent`}),` can work in your project’s GitHub repositories inside a `,_jsx(_components.strong,{children:`sandbox`}),`: a private Linux VM with your repositories cloned into it. In the sandbox the agent reads code, edits files, runs commands, and opens pull requests. Use it to trace a failure back to the code that caused it, add or fix Laminar instrumentation and check that the traces arrive, or write `,_jsx(_components.a,{href:`/agent-evaluations/introduction`,children:`agent evaluations`}),` and run them.`]}),`\n`,_jsx(_components.p,{children:`A sandbox keeps your work between conversations. When it has been idle for 30 minutes it stops, and its files are saved. The next time the agent needs it, the sandbox comes back as it was, for up to 30 days.`}),`\n`,_jsx(Heading,{level:`2`,id:`set-up-the-agent-sandbox`,children:`Set up the agent sandbox`}),`\n`,_jsx(_components.p,{children:`The agent sandbox is a per-project setting that decides which repositories the agent clones and which LLM keys it gets. Only workspace owners and admins can change it.`}),`\n`,_jsx(Frame,{caption:`Settings > Agent sandbox: two repositories cloned into the sandbox, each at its own branch, and the LLM profiles whose keys the sandbox gets`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/laminarai/NJOqyfLAJw930MrG/images/platform/agent-sandbox-settings.png?fit=max\u0026auto=format\u0026n=NJOqyfLAJw930MrG\u0026q=85\u0026s=6ec492754971d912c7857ad6fd79f40b`,alt:`Agent sandbox settings page with a Repositories list of four GitHub repositories, two turned on with branch pickers set to staging and main, and an LLM profiles list with two of three profiles turned on`,\"data-og-width\":`1512`,width:`1512`,\"data-og-height\":`982`,height:`982`,\"data-path\":`images/platform/agent-sandbox-settings.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/laminarai/NJOqyfLAJw930MrG/images/platform/agent-sandbox-settings.png?w=280\u0026fit=max\u0026auto=format\u0026n=NJOqyfLAJw930MrG\u0026q=85\u0026s=7a2cb3234bd8025191dd3677e15399dc 280w, https://mintcdn.com/laminarai/NJOqyfLAJw930MrG/images/platform/agent-sandbox-settings.png?w=560\u0026fit=max\u0026auto=format\u0026n=NJOqyfLAJw930MrG\u0026q=85\u0026s=dde02b96f4185b22b243d11b3e654b0a 560w, https://mintcdn.com/laminarai/NJOqyfLAJw930MrG/images/platform/agent-sandbox-settings.png?w=840\u0026fit=max\u0026auto=format\u0026n=NJOqyfLAJw930MrG\u0026q=85\u0026s=26f80ee3f79fa3e45ff7e533414af390 840w, https://mintcdn.com/laminarai/NJOqyfLAJw930MrG/images/platform/agent-sandbox-settings.png?w=1100\u0026fit=max\u0026auto=format\u0026n=NJOqyfLAJw930MrG\u0026q=85\u0026s=a1ed9ee8e6eabc9139fcfb8286414053 1100w, https://mintcdn.com/laminarai/NJOqyfLAJw930MrG/images/platform/agent-sandbox-settings.png?w=1650\u0026fit=max\u0026auto=format\u0026n=NJOqyfLAJw930MrG\u0026q=85\u0026s=d2f6a58fe42ad0ecf95e4d69226d5123 1650w, https://mintcdn.com/laminarai/NJOqyfLAJw930MrG/images/platform/agent-sandbox-settings.png?w=2500\u0026fit=max\u0026auto=format\u0026n=NJOqyfLAJw930MrG\u0026q=85\u0026s=4e96ccefd7012ffc2b13173d73b8cc84 2500w`})}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Connect GitHub`,children:[_jsxs(_components.p,{children:[`Go to `,_jsx(_components.strong,{children:`Settings > Integrations`}),`, under `,_jsx(_components.strong,{children:`Workspace settings`}),`, and connect GitHub. Install the Laminar GitHub App on the organization or account that owns your repositories, and give it access to the repositories you want the agent to work in. A GitHub account can be connected to one Laminar workspace.`]}),_jsx(Frame,{caption:`Once GitHub is connected, the card shows the GitHub account and links to the Agent sandbox settings`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/laminarai/NJOqyfLAJw930MrG/images/platform/agent-sandbox-github.png?fit=max\u0026auto=format\u0026n=NJOqyfLAJw930MrG\u0026q=85\u0026s=13669a394c9317240401d05fad7e4be6`,alt:`Workspace Integrations page with a connected GitHub card for the acme-ai account and an Agent sandbox settings button`,\"data-og-width\":`780`,width:`780`,\"data-og-height\":`285`,height:`285`,\"data-path\":`images/platform/agent-sandbox-github.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/laminarai/NJOqyfLAJw930MrG/images/platform/agent-sandbox-github.png?w=280\u0026fit=max\u0026auto=format\u0026n=NJOqyfLAJw930MrG\u0026q=85\u0026s=e5fe1926b879f4eb1e3a11e448f977cb 280w, https://mintcdn.com/laminarai/NJOqyfLAJw930MrG/images/platform/agent-sandbox-github.png?w=560\u0026fit=max\u0026auto=format\u0026n=NJOqyfLAJw930MrG\u0026q=85\u0026s=2d4a462b752dce7c12d2f42b5a9ba1fd 560w, https://mintcdn.com/laminarai/NJOqyfLAJw930MrG/images/platform/agent-sandbox-github.png?w=840\u0026fit=max\u0026auto=format\u0026n=NJOqyfLAJw930MrG\u0026q=85\u0026s=5276c7839f2bd6d233b6111b2f97375e 840w, https://mintcdn.com/laminarai/NJOqyfLAJw930MrG/images/platform/agent-sandbox-github.png?w=1100\u0026fit=max\u0026auto=format\u0026n=NJOqyfLAJw930MrG\u0026q=85\u0026s=39681bcd1a2cbcbf17ba4883d6a43b07 1100w, https://mintcdn.com/laminarai/NJOqyfLAJw930MrG/images/platform/agent-sandbox-github.png?w=1650\u0026fit=max\u0026auto=format\u0026n=NJOqyfLAJw930MrG\u0026q=85\u0026s=09dc798b606c75555dc621f58ae4b756 1650w, https://mintcdn.com/laminarai/NJOqyfLAJw930MrG/images/platform/agent-sandbox-github.png?w=2500\u0026fit=max\u0026auto=format\u0026n=NJOqyfLAJw930MrG\u0026q=85\u0026s=3bc73404acaa4bcafb7d626005c2942d 2500w`})})]}),_jsx(Step,{title:`Pick the repositories`,children:_jsxs(_components.p,{children:[`In the project, go to `,_jsx(_components.strong,{children:`Settings > Agent sandbox`}),` and turn on each repository you want cloned into the sandbox. The list shows every repository the GitHub App can access. To add a repository that isn’t listed, click `,_jsx(_components.strong,{children:`Manage access on GitHub`}),` and grant the app access to it.`]})}),_jsxs(Step,{title:`Pick a branch for each repository`,children:[_jsx(_components.p,{children:`Each selected repository has a branch picker. Leave it on the repository’s default branch, or search for and pick another branch. A new sandbox clones each repository at that branch, and pull requests from the agent target it.`}),_jsx(Frame,{caption:`The branch picker lists the repository's branches, with the default branch first`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/laminarai/NJOqyfLAJw930MrG/images/platform/agent-sandbox-branch-picker.png?fit=max\u0026auto=format\u0026n=NJOqyfLAJw930MrG\u0026q=85\u0026s=4522b29f21b4faa6c66103cc3c34500c`,alt:`Branch picker open on the acme-ai/support-bot repository, with a branch search box, main marked as default, and staging selected`,\"data-og-width\":`770`,width:`770`,\"data-og-height\":`320`,height:`320`,\"data-path\":`images/platform/agent-sandbox-branch-picker.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/laminarai/NJOqyfLAJw930MrG/images/platform/agent-sandbox-branch-picker.png?w=280\u0026fit=max\u0026auto=format\u0026n=NJOqyfLAJw930MrG\u0026q=85\u0026s=0aba7575a4ac17ee046d55733b8b77b7 280w, https://mintcdn.com/laminarai/NJOqyfLAJw930MrG/images/platform/agent-sandbox-branch-picker.png?w=560\u0026fit=max\u0026auto=format\u0026n=NJOqyfLAJw930MrG\u0026q=85\u0026s=c4b525f7d8a3b75aeac37e0d845feade 560w, https://mintcdn.com/laminarai/NJOqyfLAJw930MrG/images/platform/agent-sandbox-branch-picker.png?w=840\u0026fit=max\u0026auto=format\u0026n=NJOqyfLAJw930MrG\u0026q=85\u0026s=361d7eb917d43b510840a6379c3c26a8 840w, https://mintcdn.com/laminarai/NJOqyfLAJw930MrG/images/platform/agent-sandbox-branch-picker.png?w=1100\u0026fit=max\u0026auto=format\u0026n=NJOqyfLAJw930MrG\u0026q=85\u0026s=0201406ef054b3e1a55b8fa9fec48fb6 1100w, https://mintcdn.com/laminarai/NJOqyfLAJw930MrG/images/platform/agent-sandbox-branch-picker.png?w=1650\u0026fit=max\u0026auto=format\u0026n=NJOqyfLAJw930MrG\u0026q=85\u0026s=9f3ef62c9b36474169b38f60cb4295a4 1650w, https://mintcdn.com/laminarai/NJOqyfLAJw930MrG/images/platform/agent-sandbox-branch-picker.png?w=2500\u0026fit=max\u0026auto=format\u0026n=NJOqyfLAJw930MrG\u0026q=85\u0026s=46078ae02778a0c5824fb21302baa14a 2500w`})})]}),_jsx(Step,{title:`Pick the LLM profiles`,children:_jsxs(_components.p,{children:[`Under `,_jsx(_components.strong,{children:`LLM profiles`}),`, select the `,_jsx(_components.a,{href:`/platform/llm-profiles`,children:`LLM profiles`}),` whose API keys the sandbox should get. Do this when the code in your repositories calls an LLM and you want the agent to run it, for example to check that a change produces the trace you expect.`]})})]}),`\n`,_jsx(_components.p,{children:`The branch setting applies when a sandbox is created. A sandbox that already exists keeps the branch it has, so start a new chat to work from a branch you changed.`}),`\n`,_jsx(Heading,{level:`2`,id:`what-is-in-a-sandbox`,children:`What is in a sandbox`}),`\n`,_jsxs(_components.p,{children:[`Each sandbox is a Linux VM with git, Node.js, Python, and Docker. Every repository in the environment is cloned into `,_jsx(_components.code,{children:`~/repos/\u003crepository name>`}),`, and the agent installs dependencies itself when it needs them.`]}),`\n`,_jsx(_components.p,{children:`Commands in the sandbox get these environment variables:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`LLM keys`}),` from the selected profiles, under each provider’s usual names: `,_jsx(_components.code,{children:`ANTHROPIC_API_KEY`}),`, `,_jsx(_components.code,{children:`OPENAI_API_KEY`}),`, `,_jsx(_components.code,{children:`GEMINI_API_KEY`}),`, `,_jsx(_components.code,{children:`GROQ_API_KEY`}),`, `,_jsx(_components.code,{children:`MISTRAL_API_KEY`}),`, the `,_jsx(_components.code,{children:`AWS_*`}),` variables for Bedrock, and the `,_jsx(_components.code,{children:`AZURE_*`}),` variables for Azure. Custom gateway profiles get variables prefixed with `,_jsx(_components.code,{children:`CUSTOM_LLM_`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`LMNR_PROJECT_API_KEY`})}),`, a project API key that belongs to this sandbox only. The agent uses it to send traces from your code to the project and to run evaluations. A new key is created every time the sandbox starts. It is revoked after the sandbox stops, and expires after 24 hours at the latest. These keys don’t appear on the project’s API keys page.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`LMNR_BASE_URL`})}),`, the Laminar API the key works with.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`The sandbox has no GitHub credentials. The agent pushes through Laminar, which only pushes to `,_jsx(_components.code,{children:`laminar/`}),` branches and opens pull requests (see `,_jsx(_components.a,{href:`#review-the-agents-pull-requests`,children:`Review the agent’s pull requests`}),`).`]}),`\n`,_jsx(Heading,{level:`2`,id:`ask-the-agent-to-work-in-your-code`,children:`Ask the agent to work in your code`}),`\n`,_jsxs(_components.p,{children:[`Ask from the `,_jsx(_components.strong,{children:`Agent`}),` panel in the Laminar app, or from your terminal with `,_jsx(_components.a,{href:`/platform/cli#ask-the-agent`,children:_jsx(_components.code,{children:`lmnr-cli ask`})}),`. Only workspace owners and admins can use the sandbox. The agent doesn’t open a sandbox when you ask from `,_jsx(_components.a,{href:`/platform/integrations#laminar-agent`,children:`Slack`}),` or the `,_jsx(_components.a,{href:`/platform/mcp`,children:`MCP server`}),`.`]}),`\n`,_jsx(_components.p,{children:`The agent opens the sandbox when a question needs your code, so you don’t have to ask for it. Some things to ask:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`“Find the cause of the errors in the latest failed trace and fix it.”`}),`\n`,_jsxs(_components.li,{children:[`“Add Laminar tracing to the support agent in `,_jsx(_components.code,{children:`support-bot`}),`, run it once, and check that the trace looks right.”`]}),`\n`,_jsx(_components.li,{children:`“Write evals for the cluster about invented hotel prices and run them.”`}),`\n`,_jsx(_components.li,{children:`“Continue the eval work in the sandbox from my teammate’s chat.”`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`On a Signal’s cluster, the `,_jsx(_components.strong,{children:`Create Evals`}),` button starts a chat that asks the agent to write evals from that cluster and run them. The agent runs evals with `,_jsx(_components.a,{href:`/agent-evaluations/running-evals`,children:_jsx(_components.code,{children:`lmnr-cli eval run --remote`})}),`, so each run shows up in the project’s evaluations, with a trace for every trial.`]}),`\n`,_jsxs(_components.p,{children:[`Laminar Agent also reads your code when it writes `,_jsx(_components.a,{href:`/signals/clusters`,children:`cluster reports`}),`, once the project has repositories in its agent sandbox settings. That sandbox is read-only for the agent: it gets no LLM keys or project API key, and it can’t push or open pull requests.`]}),`\n`,_jsx(Heading,{level:`2`,id:`review-the-agent’s-pull-requests`,children:`Review the agent’s pull requests`}),`\n`,_jsxs(_components.p,{children:[`When the work is done, the agent commits its changes and pushes them to a new `,_jsx(_components.code,{children:`laminar/`}),` branch in your repository, then opens a pull request against the branch the sandbox cloned. It replies with the pull request link. Later pushes from the same sandbox add commits to the same pull request.`]}),`\n`,_jsxs(_components.p,{children:[`Commits arrive signed by GitHub, so they show as `,_jsx(_components.strong,{children:`Verified`}),`. The agent can’t push changes to `,_jsx(_components.code,{children:`.github/workflows/`}),`.`]}),`\n`,_jsx(_components.p,{children:`The agent can also pull the latest commits of that branch into the sandbox, rebasing its own commits on top. If it had already pushed, its next push opens a new pull request from the updated branch.`}),`\n`,_jsx(Heading,{level:`2`,id:`sandboxes-stop-when-idle-and-resume-where-they-left-off`,children:`Sandboxes stop when idle and resume where they left off`}),`\n`,_jsx(_components.p,{children:`A sandbox stops after 30 minutes with no commands running. A command that is still running counts as activity, so a long build or eval run keeps the sandbox up. A sandbox also stops after running for 24 hours.`}),`\n`,_jsx(_components.p,{children:`When a sandbox stops, Laminar saves its whole filesystem:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`the repositories, including commits and uncommitted changes`}),`\n`,_jsx(_components.li,{children:`installed dependencies, build output, and Docker images`}),`\n`]}),`\n`,_jsx(_components.p,{children:`Running processes, such as dev servers, watchers, and Docker containers, are not saved. Docker itself starts again when the sandbox resumes.`}),`\n`,_jsxs(_components.p,{children:[`The next time the agent needs the sandbox, in the same chat or from another one, it starts a new VM from the saved files and carries on. You don’t need to do anything for this. A restored sandbox gets a new `,_jsx(_components.code,{children:`LMNR_PROJECT_API_KEY`}),`.`]}),`\n`,_jsx(_components.p,{children:`A saved sandbox is kept for 30 days after it was last used. After that, the chat’s next request starts a fresh sandbox, cloned again from the environment’s branches, and any work in the old sandbox that wasn’t pushed is gone. Ask the agent to open a pull request for work you want to keep.`}),`\n`,_jsx(Heading,{level:`2`,id:`sandboxes-are-shared-across-the-project`,children:`Sandboxes are shared across the project`}),`\n`,_jsx(_components.p,{children:`Sandboxes belong to the project, not to one chat. The agent can list the project’s running and saved sandboxes, including the ones your teammates’ chats created, and switch your chat to one of them. It only opens a teammate’s sandbox when you ask it to, since the work in it is theirs. Sandboxes used for cluster reports are not listed.`}),`\n`,_jsx(_components.p,{children:`A project can have up to 10 sandboxes running at the same time. Stopped sandboxes don’t count toward this limit.`}),`\n`,_jsx(_components.p,{children:`Deleting a chat doesn’t delete its sandbox right away: the sandbox stops when it goes idle, and its saved files are deleted 30 days after it was last used.`}),`\n`,_jsx(Heading,{level:`2`,id:`what’s-next`,children:`What’s next`}),`\n`,_jsxs(CardGroup,{cols:2,children:[_jsx(Card,{title:`Laminar Agent`,href:`/platform/laminar-agent`,children:_jsx(_components.p,{children:`Everything the agent can do, and where you can ask it.`})}),_jsx(Card,{title:`Agent evaluations`,href:`/agent-evaluations/introduction`,children:_jsx(_components.p,{children:`How the evals the agent writes and runs are structured.`})}),_jsx(Card,{title:`Clusters`,href:`/signals/clusters`,children:_jsx(_components.p,{children:`The groups of Signal events the agent writes reports and evals from.`})}),_jsx(Card,{title:`LLM profiles`,href:`/platform/llm-profiles`,children:_jsx(_components.p,{children:`Add the provider keys the agent sandbox hands to your code.`})})]})]})}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":"Laminar Agent Sandbox: Work in Your GitHub Repositories","sidebarTitle":"Agent sandbox","description":null,"href":"/platform/agent-sandbox"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Set up the agent sandbox","slug":"set-up-the-agent-sandbox","depth":2,"children":[]},{"title":"What is in a sandbox","slug":"what-is-in-a-sandbox","depth":2,"children":[]},{"title":"Ask the agent to work in your code","slug":"ask-the-agent-to-work-in-your-code","depth":2,"children":[]},{"title":"Review the agent’s pull requests","slug":"review-the-agent’s-pull-requests","depth":2,"children":[]},{"title":"Sandboxes stop when idle and resume where they left off","slug":"sandboxes-stop-when-idle-and-resume-where-they-left-off","depth":2,"children":[]},{"title":"Sandboxes are shared across the project","slug":"sandboxes-are-shared-across-the-project","depth":2,"children":[]},{"title":"What’s next","slug":"what’s-next","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"laminarai","siteName":"Laminar documentation","title":"Laminar Agent Sandbox: Work in Your GitHub Repositories - Laminar documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-19T17:36:54.372Z","originalFileLocation":"platform/agent-sandbox.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"dark\";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=\"dark\"}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=\"Laminar 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/laminarai/VQjyHLSbUBgKAPKE/_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/laminarai/VQjyHLSbUBgKAPKE/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/laminarai/VQjyHLSbUBgKAPKE/_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/laminarai/VQjyHLSbUBgKAPKE/_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/laminarai/VQjyHLSbUBgKAPKE/_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/laminarai/VQjyHLSbUBgKAPKE/_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/laminarai/VQjyHLSbUBgKAPKE/_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/laminarai/VQjyHLSbUBgKAPKE/_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/laminarai/VQjyHLSbUBgKAPKE/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Laminar Agent Sandbox: Work in Your GitHub Repositories - Laminar documentation\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Laminar documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://laminar.sh/docs/platform/agent-sandbox\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://laminarai.mintlify.site/docs/_mintlify/api/og/v2?division=Platform\u0026amp;title=Laminar+Agent+Sandbox%3A+Work+in+Your+GitHub+Repositories\u0026amp;theme=1648d20b53ce7529dc4a544e\u0026amp;signature=d0ba4415979efef982d76b650bafbd16feec406ac6064b351642a09c833ca827\">\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=\"Laminar Agent Sandbox: Work in Your GitHub Repositories - Laminar documentation\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://laminarai.mintlify.site/docs/_mintlify/api/og/v2?division=Platform\u0026amp;title=Laminar+Agent+Sandbox%3A+Work+in+Your+GitHub+Repositories\u0026amp;theme=1648d20b53ce7529dc4a544e\u0026amp;signature=d0ba4415979efef982d76b650bafbd16feec406ac6064b351642a09c833ca827\">\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/laminarai/VQjyHLSbUBgKAPKE/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Laminar documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#d0754e\">\u003clink data-mint-head rel=\"canonical\" href=\"https://laminar.sh/docs/platform/agent-sandbox\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/platform/agent-sandbox.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://laminar.sh/#organization\",\"name\":\"Laminar documentation\",\"url\":\"https://laminar.sh\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/laminarai/S438DUdrFaxkWj71/logo/laminar-wordmark.svg?fit=max\u0026auto=format\u0026n=S438DUdrFaxkWj71\u0026q=85\u0026s=6b0de22c2375c7edcbfa86892965fc24\"}},{\"@type\":\"WebSite\",\"@id\":\"https://laminar.sh/docs#website\",\"name\":\"Laminar documentation\",\"url\":\"https://laminar.sh/docs\",\"publisher\":{\"@id\":\"https://laminar.sh/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://laminar.sh/docs/platform/agent-sandbox#webpage\",\"url\":\"https://laminar.sh/docs/platform/agent-sandbox\",\"name\":\"Laminar Agent Sandbox: Work in Your GitHub Repositories\",\"dateModified\":\"2026-11-19T17:36:54.372Z\",\"isPartOf\":{\"@id\":\"https://laminar.sh/docs#website\"},\"breadcrumb\":{\"@id\":\"https://laminar.sh/docs/platform/agent-sandbox#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://laminar.sh/docs/platform/agent-sandbox#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Platform\",\"item\":\"https://laminar.sh/docs/platform\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Laminar Agent Sandbox: Work in Your GitHub Repositories\",\"item\":\"https://laminar.sh/docs/platform/agent-sandbox\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://laminar.sh/docs/platform/agent-sandbox#article\",\"headline\":\"Laminar Agent Sandbox: Work in Your GitHub Repositories\",\"name\":\"Laminar Agent Sandbox: Work in Your GitHub Repositories\",\"url\":\"https://laminar.sh/docs/platform/agent-sandbox\",\"mainEntityOfPage\":{\"@id\":\"https://laminar.sh/docs/platform/agent-sandbox#webpage\"},\"dateModified\":\"2026-11-19T17:36:54.372Z\",\"publisher\":{\"@id\":\"https://laminar.sh/#organization\"},\"isPartOf\":{\"@id\":\"https://laminar.sh/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Laminar documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Laminar documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/platform/agent-sandbox.md","siteName":"Laminar documentation","nav":{"global":null,"tabs":[{"tab":"Documentation","groups":[{"group":"Overview","pages":[{"title":"Laminar","sidebarTitle":"Laminar","href":"/overview"},{"title":"Getting Started","href":"/getting-started"}]},{"group":"Tracing","pages":[{"title":"Tracing","sidebarTitle":"Introduction","href":"/tracing/introduction"},{"group":"Tracing Structure","pages":[{"title":"Tracing Structure","sidebarTitle":"Overview","href":"/tracing/structure/overview"},{"title":"Trace Functions","href":"/tracing/structure/observe-decorator"},{"title":"Trace Parts of Your Code","href":"/tracing/structure/manual-span-creation"},{"title":"Span Types","sidebarTitle":"Span Types","href":"/tracing/structure/span-types"},{"title":"Sessions","href":"/tracing/structure/sessions"},{"title":"User ID","href":"/tracing/structure/user-id"},{"title":"Metadata","href":"/tracing/structure/metadata"},{"title":"Tags","href":"/tracing/structure/tags"},{"title":"Tracing Images","href":"/tracing/structure/images"},{"title":"Continuing Traces","href":"/tracing/structure/continuing-traces"},{"title":"Span Attribute Reference","sidebarTitle":"Span Attribute Reference","href":"/tracing/structure/span-attribute-reference"},{"title":"Flushing Spans and Shutting Down","href":"/tracing/structure/flushing-and-shutdown"}]},{"title":"Task extraction for AI agent runs","sidebarTitle":"Task extraction","href":"/tracing/task-extraction"},{"title":"Agent versioning: track prompt and tool changes","sidebarTitle":"Agent versions","href":"/tracing/agent-versions"},{"title":"LLM cost tracking","href":"/tracing/cost-tracking"},{"title":"Session replay for browser agents","href":"/tracing/browser-agent-observability"},{"title":"LangGraph Visualization","sidebarTitle":"LangGraph Visualization","href":"/tracing/langgraph-visualization"},{"group":"Troubleshooting","pages":[{"title":"Troubleshooting","href":"/tracing/troubleshooting"},{"title":"Troubleshooting non-Laminar SDKs","href":"/tracing/troubleshooting-opentelemetry"}]}]},{"group":"Signals","pages":[{"title":"Signals","sidebarTitle":"Introduction","href":"/signals/introduction"},{"title":"Quickstart","sidebarTitle":"Quickstart","href":"/signals/quickstart"},{"title":"Manage Signals from the CLI","sidebarTitle":"CLI","href":"/signals/cli"},{"title":"Clusters","sidebarTitle":"Clusters","href":"/signals/clusters"},{"title":"Alerts","sidebarTitle":"Alerts","href":"/signals/alerts"},{"title":"Reports","sidebarTitle":"Reports","href":"/signals/reports"}]},{"group":"Evaluations","pages":[{"group":"Agent evaluations","pages":[{"title":"Agent Evaluations in Real Environments with Laminar","sidebarTitle":"Introduction","href":"/agent-evaluations/introduction"},{"title":"Agent Evaluations Quickstart with lmnr-cli","sidebarTitle":"Quickstart","href":"/agent-evaluations/quickstart"},{"title":"Agent Evaluation Concepts - Tasks, Trials, and Verifiers","sidebarTitle":"Concepts","href":"/agent-evaluations/concepts"},{"title":"Run Agent Evaluations with lmnr-cli eval run","sidebarTitle":"Run evals with lmnr-cli","href":"/agent-evaluations/running-evals"},{"title":"The Evals Folder Reference for lmnr.yaml, harbor.yaml, and task.toml","sidebarTitle":"The evals folder","href":"/agent-evaluations/evals-folder"},{"title":"Build an Agent Evaluation Harness That Matches Production","sidebarTitle":"Build a production harness","href":"/agent-evaluations/production-harness"},{"title":"Capture Agent Trajectories in Every Evaluation Trial","sidebarTitle":"Capture the trajectory","href":"/agent-evaluations/trajectories"},{"title":"Troubleshooting Agent Evaluations","sidebarTitle":"Troubleshooting","href":"/agent-evaluations/troubleshooting"}]},{"group":"LLM evaluations","pages":[{"title":"LLM Evaluations","sidebarTitle":"Introduction","href":"/evaluations/introduction"},{"title":"LLM evaluations quickstart","sidebarTitle":"Quickstart","href":"/evaluations/quickstart"},{"title":"Evaluation concepts","sidebarTitle":"Concepts","href":"/evaluations/concepts"},{"title":"Compare evaluation runs","sidebarTitle":"Compare runs","href":"/evaluations/comparing-runs"},{"title":"Custom Rendering for Evaluation Traces","sidebarTitle":"Custom rendering","href":"/evaluations/custom-rendering"},{"title":"Datasets for evaluations","sidebarTitle":"Datasets","href":"/evaluations/datasets"},{"title":"Manual evaluation API","sidebarTitle":"Manual API","href":"/evaluations/manual-evaluation"},{"title":"Self-hosted evaluations","sidebarTitle":"Self-hosted","href":"/evaluations/self-hosted"}]}]},{"group":"Debugger","pages":[{"title":"AI Agent Debugger: Record, Replay, Evaluate","sidebarTitle":"Introduction","href":"/debugger/introduction"},{"title":"Set Up the Laminar Debugger","sidebarTitle":"Setup","href":"/debugger/setup"},{"title":"How the Debugger Runs","sidebarTitle":"The debugger process","href":"/debugger/process"},{"title":"How Debugger Caching Works","sidebarTitle":"How caching works","href":"/debugger/caching"}]},{"group":"Datasets","pages":[{"sidebarTitle":"Introduction","title":"Introduction to Laminar datasets","href":"/datasets/introduction"},{"sidebarTitle":"Adding data","title":"Adding data to Laminar datasets","href":"/datasets/adding-data"},{"sidebarTitle":"CLI","title":"Laminar datasets CLI","href":"/datasets/cli"}]},{"group":"Platform","pages":[{"title":"Platform","sidebarTitle":"Introduction","href":"/platform"},{"title":"Viewing Traces","sidebarTitle":"Viewing traces","href":"/platform/viewing-traces"},{"title":"Table views","sidebarTitle":"Table views","href":"/platform/table-views"},{"title":"Slack integration","sidebarTitle":"Slack integration","href":"/platform/integrations"},{"title":"Live tracing","sidebarTitle":"Live tracing","href":"/platform/live-tracing"},{"title":"Laminar Agent","sidebarTitle":"Laminar Agent","description":null,"href":"/platform/laminar-agent"},{"title":"Laminar Agent Sandbox: Work in Your GitHub Repositories","sidebarTitle":"Agent sandbox","href":"/platform/agent-sandbox"},{"title":"MCP Server","description":"Connect MCP clients to Laminar to query traces with SQL, manage signals and LLM profiles, and tag traces.","href":"/platform/mcp"},{"title":"SQL Editor","href":"/platform/sql-editor"},{"title":"CLI","href":"/platform/cli"},{"title":"Terraform Provider for Laminar Signals and LLM Profiles","sidebarTitle":"Terraform","href":"/platform/terraform"},{"title":"Full text search","href":"/platform/search"},{"title":"Render Templates for Custom Data Views","sidebarTitle":"Render templates","href":"/platform/render-templates"},{"title":"Custom Model Costs for Self-Hosted and Fine-Tuned Models","sidebarTitle":"Custom model costs","href":"/platform/custom-model-costs"},{"title":"Usage Warnings and Hard Limits for Data and Signals","sidebarTitle":"Usage limits","href":"/platform/usage-limits"},{"title":"PII Redaction for AI Agent Traces","sidebarTitle":"PII redaction","href":"/platform/pii-redaction"},{"title":"Workspace Audit Log for Changes and Trace Data Access","sidebarTitle":"Audit log","href":"/platform/audit-log"},{"title":"Dashboards: Chart Agent Cost, Tokens, and Latency","sidebarTitle":"Dashboards","href":"/platform/dashboards"},{"title":"Labeling Queues","sidebarTitle":"Labeling Queues","href":"/queues/quickstart"},{"title":"LLM Profiles for Custom LLM Providers and API Keys","sidebarTitle":"LLM profiles","href":"/platform/llm-profiles"},{"title":"Playground","href":"/playground"}]}]},{"tab":"Integrations","pages":[{"title":"Integrations","href":"/integrations"}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/guides/signals"}]},{"tab":"Self-hosting","pages":[{"title":"Self-hosting","href":"/self-hosting/overview"}]},{"tab":"SDK","pages":[{"title":"SDK","href":"/sdk/observe"}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/ingestion/ingest-opentelemetry-traces"}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Laminar Agent Sandbox: Work in Your GitHub Repositories - Laminar documentation","deploymentId":"dpl_J2QdBVuN65x4CCtpqPb371YPt4xi","buildId":"dpl_J2QdBVuN65x4CCtpqPb371YPt4xi","dynamics":["07c022d89b","a74be98ba7","a9bb46feb3"],"chunks":["Frame-LlRejYWv.js","DynamicMarkdown-DzuINhDe.js","zoom-image-lightbox-B0JqbMuR.js","lightbox-handle-r17bVUz3.js","Markdown-DBdbz5B3.js","dist-DWEsd3cZ.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-DuX7jTnG.js"]}