Updated mintlify pages

- Updated docs/agents/devin.mdx
- Created images/devin_flowchart.png

Mintlify-Source: dashboard-editor

Author: mintlify[bot]

docs/agents/devin.mdx

@@ -4,17 +4,14 @@ description: "Run Devin in or against secure E2B sandboxes."
 icon: "/images/icons/devin.svg"
 ---
 
-[Devin](https://devin.ai) is Cognition's coding agent. You can use E2B with
-Devin in two ways:
+[Devin](https://devin.ai) is Cognition's coding agent. You can use E2B with Devin in two ways:
 
 - run Devin for Terminal directly inside an isolated E2B sandbox
 - run a Devin Outposts worker in an E2B sandbox and route Devin sessions to it
 
 ## Run Devin for Terminal
 
-[Devin for Terminal](https://devin.ai/terminal) runs directly from a terminal.
-Install it in a sandbox to give Devin an isolated workspace without access to
-your local machine.
+[Devin for Terminal](https://devin.ai/terminal) runs directly from a terminal. Install it in a sandbox to give Devin an isolated workspace without access to your local machine.
 
 ```bash
 e2b sandbox create base
@@ -26,8 +23,7 @@ curl -fsSL https://cli.devin.ai/install.sh | bash
 source /home/user/.bashrc
 ```
 
-After completing Devin's interactive sign-in, run a task from the project
-directory:
+After completing Devin's interactive sign-in, run a task from the project directory:
 
 ```bash
 git clone https://github.com/your-org/your-repo.git /home/user/repo
@@ -38,15 +34,9 @@ devin --permission-mode dangerous -p "Add error handling to all API endpoints"
 
 ## Run Devin Outposts in E2B
 
-Use the public `devin-outposts` template to run an Outposts worker and its setup
-UI inside an E2B sandbox. The template includes the Devin CLI, starts the setup
-UI on port `3000`, and reserves `/mnt/repos` as the worker workspace.
+Use the public `devin-outposts` template to run an Outposts worker and its setup UI inside an E2B sandbox. The template includes the Devin CLI, starts the setup UI on port `3000`, and reserves `/mnt/repos` as the worker workspace.
 
-<Card
-  title="Open the Devin Outposts template"
-  icon="terminal"
-  href="https://e2b.dev/dashboard/terminal?template=aiengineer-d56d/devin-outposts"
->
+<Card title="Open the Devin Outposts template" icon="terminal" href="https://e2b.dev/dashboard/terminal?template=aiengineer-d56d/devin-outposts">
   Start the template in the E2B dashboard and open its terminal.
 </Card>
 
@@ -63,31 +53,25 @@ The immutable template ID is `myw11k4t1jtjbr7ckvz8`.
 
 ### Open the setup UI
 
-When the terminal connects, it prints the exact setup URL for that sandbox and
-the command that reads its sandbox-local control token. The URL has this shape:
+When the terminal connects, it prints the exact setup URL for that sandbox and the command that reads its sandbox-local control token. The URL has this shape:
 
 ```text
 https://3000-<sandbox-id>.<e2b-domain>
 ```
 
-The sandbox receives its runtime ID as `E2B_SANDBOX_ID`. A self-hosted E2B
-deployment must configure its own E2B domain when building the template; the
-sandbox cannot infer that public domain from its runtime ID.
+The sandbox receives its runtime ID as `E2B_SANDBOX_ID`. A self-hosted E2B deployment must configure its own E2B domain when building the template; the sandbox cannot infer that public domain from its runtime ID.
 
 Read the setup token inside the sandbox:
 
 ```bash
 cat /home/user/.config/devin-outposts/control-token
 ```
 
-Enter it in the setup UI. A successful exchange issues a signed, HTTP-only
-session cookie valid for 12 hours. The control token remains reusable inside
-that sandbox and is not stored in browser local storage.
+Enter it in the setup UI. A successful exchange issues a signed, HTTP-only session cookie valid for 12 hours. The control token remains reusable inside that sandbox and is not stored in browser local storage.
 
 ### Configure the worker
 
-The setup UI asks for credentials and routing information from your Devin
-organization:
+The setup UI asks for credentials and routing information from your Devin organization:
 
 | Value | Purpose |
 | --- | --- |
@@ -99,55 +83,35 @@ organization:
 | Outposts worker token | Authenticates the worker to that pool |
 
 <Warning>
-  Do not put these credentials in a public template. The setup UI stores them
-  only in the running sandbox with file mode `0600`. Treat a snapshot of a
-  configured sandbox as secret-bearing.
+  Do not put these credentials in a public template. The setup UI stores them only in the running sandbox with file mode `0600`. Treat a snapshot of a configured sandbox as secret-bearing.
 </Warning>
 
-Save the configuration and start the worker. The status view shows whether the
-worker process is running and displays recent worker output for troubleshooting.
-Confirm the pool appears in Devin's virtual-environment menu before sending a
-task; process state alone does not prove pool registration.
+Save the configuration and start the worker. The status view shows whether the worker process is running and displays recent worker output for troubleshooting. Confirm the pool appears in Devin's virtual-environment menu before sending a task; process state alone does not prove pool registration.
 
-If the template reports that no Outposts pools are available, the API key cannot
-see a pool that this worker can join. Create or assign the pool in Devin, then
-run **Check Devin account** again before saving the connection.
+If the template reports that no Outposts pools are available, the API key cannot see a pool that this worker can join. Create or assign the pool in Devin, then run **Check Devin account** again before saving the connection.
 
-Copy the organization URL from Devin while that organization is open. For
-example:
+Copy the organization URL from Devin while that organization is open. For example:
 
 ```text
 https://app.devin.ai/org/your-org
 ```
 
-The organization selected in the template UI controls API session listing and
-follow-ups. The `/org/<slug>` URL controls where Devin creates the browser
-session. These must refer to the same organization; an origin-only URL such as
-`https://app.devin.ai` is rejected because it would inherit the browser's last
-selected organization. Confirm the pairing in the setup form after selecting
-the API organization. Changing either value requires confirmation again.
+The organization selected in the template UI controls API session listing and follow-ups. The `/org/<slug>` URL controls where Devin creates the browser session. These must refer to the same organization; an origin-only URL such as `https://app.devin.ai` is rejected because it would inherit the browser's last selected organization. Confirm the pairing in the setup form after selecting the API organization. Changing either value requires confirmation again.
 
 ### Send a task to the Outposts worker
 
 <Steps>
   <Step title="Wait for the worker process">
-    The template UI header should say **Process running**. This means the local
-    worker process is alive. Before sending work, also verify that the pool is
-    available in Devin; process state alone does not prove registration.
+    The template UI header should say **Process running**. This means the local worker process is alive. Before sending work, also verify that the pool is available in Devin; process state alone does not prove registration.
   </Step>
-
   <Step title="Describe the task">
-    Enter what Devin should build, change, or investigate. The template adds
-    instructions to use `/mnt/repos` and to stop when the wrong virtual
-    environment was selected. Nothing is sent while you type.
+    Enter what Devin should build, change, or investigate. The template adds instructions to use `/mnt/repos` and to stop when the wrong virtual environment was selected. Nothing is sent while you type.
   </Step>
   <Step title="Open Devin with the prepared task">
-    Choose **Open Devin with this task**. A new Devin page opens with the prompt
-    pre-filled, but the task is not sent yet.
+    Choose **Open Devin with this task**. A new Devin page opens with the prompt pre-filled, but the task is not sent yet.
   </Step>
   <Step title="Open Configuration in Devin">
-    Look directly below the prompt. Select the **Configuration** button beside
-    the attachment and effort controls, then open **Virtual environment**.
+    Look directly below the prompt. Select the **Configuration** button beside the attachment and effort controls, then open **Virtual environment**.
 
     ```text
     ┌──────────────────────────────────────────────┐
@@ -158,46 +122,28 @@ the API organization. Changing either value requires confirmation again.
                        └─ Virtual environment
     ```
   </Step>
-
   <Step title="Select the Outposts pool">
-    Choose the virtual environment whose name exactly matches the pool shown in
-    the template UI. Devin labels registered pools as Outpost environments.
-    Do this before selecting **Send**.
+    Choose the virtual environment whose name exactly matches the pool shown in the template UI. Devin labels registered pools as Outpost environments. Do this before selecting **Send**.
   </Step>
-
   <Step title="Send and attach the session">
-    Send the prepared task in Devin. Return to the template UI, select
-    **Refresh** under **Sessions claimed by this worker**, and attach the new session after this
-    worker claims it. You can then read history and send follow-up messages from
-    the template UI.
+    Send the prepared task in Devin. Return to the template UI, select **Refresh** under **Sessions claimed by this worker**, and attach the new session after this worker claims it. You can then read history and send follow-up messages from the template UI.
   </Step>
 </Steps>
 
-The task prompt tells Devin to work in `/mnt/repos`. If Devin reports a
-different workspace, such as `/home/ubuntu/repos`, the session is running on a
-managed Devin machine instead of the selected Outposts environment.
+The task prompt tells Devin to work in `/mnt/repos`. If Devin reports a different workspace, such as `/home/ubuntu/repos`, the session is running on a managed Devin machine instead of the selected Outposts environment.
 
 <Check>
-  The session is routed correctly when Devin works in `/mnt/repos`, does not ask
-  you to choose a repository path, and the session appears in the template UI
-  after the worker claims it.
+  The session is routed correctly when Devin works in `/mnt/repos`, does not ask you to choose a repository path, and the session appears in the template UI after the worker claims it.
 </Check>
 
 <Warning>
-  If Devin says `/mnt/repos` is missing or reports `/home/ubuntu/repos`, stop
-  that session. Open the task again and select the Outposts pool under
-  **Configuration** → **Virtual environment** before sending it.
+  If Devin says `/mnt/repos` is missing or reports `/home/ubuntu/repos`, stop that session. Open the task again and select the Outposts pool under **Configuration** → **Virtual environment** before sending it.
 </Warning>
 
-The task is passed to Devin in the browser URL. Do not include credentials or
-other secrets in the task field.
+The task is passed to Devin in the browser URL. Do not include credentials or other secrets in the task field.
 
 <Note>
-  Creating a session through the public Devin v3 API does not currently select
-  an Outposts pool. The initial task is therefore sent from Devin's web UI,
-  where the virtual environment can be selected. After the worker claims the
-  session, the template UI can display its history and send follow-up messages
-  through the API.
+  Creating a session through the public Devin v3 API does not currently select an Outposts pool. The initial task is therefore sent from Devin's web UI, where the virtual environment can be selected. After the worker claims the session, the template UI can display its history and send follow-up messages through the API.
 </Note>
 
 ### Verify the worker
@@ -210,34 +156,20 @@ test -d /mnt/repos
 tail -200 /home/user/devin-worker.log
 ```
 
-Successful claim logs may contain either `serving session <session-id>` or a
-structured `session_id` field. Once attached, the setup UI polls the session
-history and renders Devin's messages as they become available.
+Successful claim logs may contain either `serving session <session-id>` or a structured `session_id` field. Once attached, the setup UI polls the session history and renders Devin's messages as they become available.
 
 ### How the integration works
 
-```mermaid
-flowchart LR
-  UI["Setup UI in E2B sandbox"] -->|"Open prepared task"| DevinWeb["Devin web UI"]
-  DevinWeb -->|"Route selected environment"| Pool["Devin Outposts pool"]
-  Pool -->|"Worker claim"| Worker["Devin worker in E2B sandbox"]
-  Worker -->|"Edit files and run commands"| Workspace["/mnt/repos"]
-  UI -->|"History and follow-ups"| DevinAPI["Devin API"]
-```
+<Frame>
+  ![Devin Flowchart](/images/devin_flowchart.png)
+</Frame>
 
-The worker, setup UI, credentials, and workspace stay inside the sandbox. The
-browser talks to the setup UI, and the setup UI makes authenticated Devin API
-requests on behalf of the user.
+The worker, setup UI, credentials, and workspace stay inside the sandbox. The browser talks to the setup UI, and the setup UI makes authenticated Devin API requests on behalf of the user.
 
 ## Limitations
 
-- A Devin API key does not start an Outposts worker. The worker also needs a
-  pool ID and worker token.
-- Existing Devin sessions remain assigned to the worker that claimed them. Do
-  not assume a follow-up will migrate an old session to a replacement worker.
-- Devin can assign a new task to any available worker in the selected pool.
-  Use a dedicated pool, or stop stale workers, when validating a specific
-  sandbox or template build.
+- A Devin API key does not start an Outposts worker. The worker also needs a pool ID and worker token.
+- Existing Devin sessions remain assigned to the worker that claimed them. Do not assume a follow-up will migrate an old session to a replacement worker.
+- Devin can assign a new task to any available worker in the selected pool. Use a dedicated pool, or stop stale workers, when validating a specific sandbox or template build.
 - Use scoped, short-lived Outposts worker tokens when available.
-- Web apps started by Devin can be opened through their E2B sandbox preview
-  URLs.
+- Web apps started by Devin can be opened through their E2B sandbox preview URLs.