Add exec command to the docs (#84)

Author: ValentaTomas

docs.json

@@ -166,23 +166,32 @@
               "docs/cli",
               "docs/cli/auth",
               "docs/cli/list-sandboxes",
+              "docs/cli/create-sandbox",
+              "docs/cli/connect-to-sandbox",
+              "docs/cli/exec-command",
               "docs/cli/shutdown-sandboxes"
             ]
           },
           {
             "group": "Deployment",
-            "pages": ["docs/byoc"]
+            "pages": [
+              "docs/byoc"
+            ]
           },
           {
             "group": "Migration",
-            "pages": ["docs/migration/v2"]
+            "pages": [
+              "docs/migration/v2"
+            ]
           },
           {
             "group": "Troubleshooting",
             "pages": [
               {
                 "group": "SDKs",
-                "pages": ["docs/troubleshooting/sdks/workers-edge-runtime"]
+                "pages": [
+                  "docs/troubleshooting/sdks/workers-edge-runtime"
+                ]
               },
               {
                 "group": "Templates",
@@ -312,4 +321,4 @@
       "permanent": true
     }
   ]
-}
+}

docs/cli.mdx

@@ -3,7 +3,7 @@ title: "E2B CLI"
 sidebarTitle: Installation
 ---
 
-E2B CLI is a command line tool that allows you to list, kill running sandboxes, and manage [sandbox templates](/docs/template/quickstart).
+E2B CLI is a command line tool that allows you to manage and interact with sandboxes and [templates](/docs/template/quickstart).
 
 ## Installation
 
@@ -24,13 +24,3 @@ You can install E2B CLI using the following command:
 npm i -g @e2b/cli
 ```
 </CodeGroup>
-
-### Beta CLI
-
-The latest beta version of the CLI can be installed from NPM using the following command:
-
-<CodeGroup>
-```bash Terminal
-npm i -g @e2b/cli@beta
-```
-</CodeGroup>

docs/cli/connect-to-sandbox.mdx

@@ -0,0 +1,15 @@
+---
+title: "Connect to sandbox"
+---
+
+You can connect an interactive terminal to an already running sandbox.
+
+<CodeGroup>
+```bash Terminal
+e2b sandbox connect <sandbox-id>
+```
+</CodeGroup>
+
+Unlike the `create` command, `connect` does not kill the sandbox when you disconnect. When you exit the terminal, only your terminal session is closed—the sandbox continues running.
+
+Once connected, you can inspect the sandbox filesystem and processes to debug or experiment, or use it as a disposable environment for running agents instead of your local computer.

docs/cli/create-sandbox.mdx

@@ -0,0 +1,25 @@
+---
+title: "Create sandbox"
+---
+
+You can create a sandbox and connect an interactive terminal to it.
+
+<CodeGroup>
+```bash Terminal
+e2b sandbox create <template>
+```
+</CodeGroup>
+
+For example, to create a sandbox from the `base` template:
+
+```bash
+e2b sandbox create base
+```
+
+This will:
+1. Create a new sandbox from the specified template
+2. Connect your terminal to the sandbox
+3. Keep the sandbox alive while you're connected
+4. Automatically kill the sandbox when you exit the terminal
+
+Once connected, you can inspect the sandbox filesystem and processes to debug or experiment, or use it as a disposable environment for running agents instead of your local computer.

docs/cli/exec-command.mdx

@@ -0,0 +1,43 @@
+---
+title: "Execute commands in sandbox"
+---
+
+You can execute commands in a running sandbox.
+
+<CodeGroup>
+```bash Terminal
+e2b sandbox exec <sandbox-id> <command>
+```
+</CodeGroup>
+
+### Run in background
+
+Use the `--background` flag to run a command in the background and return immediately. The command will print the process ID (PID) to stderr:
+
+```bash
+e2b sandbox exec --background <sandbox-id> "sleep 60 && echo done"
+```
+
+### Set working directory
+
+Use the `--cwd` flag to specify the working directory for the command:
+
+```bash
+e2b sandbox exec --cwd /home/user <sandbox-id> ls
+```
+
+### Run as specific user
+
+Use the `--user` flag to run the command as a specific user:
+
+```bash
+e2b sandbox exec --user root <sandbox-id> apt-get update
+```
+
+### Set environment variables
+
+Use the `--env` flag to set environment variables. This flag can be repeated for multiple variables:
+
+```bash
+e2b sandbox exec --env NODE_ENV=production --env DEBUG=true <sandbox-id> node app.js
+```