exe.dev

https://exe.dev/docs
Admin
exe.dev is a subscription service that provides virtual machines with persistent disks, accessible...
Tokens:60,862
Snippets:1,069
Trust Score:6.5
Update:2 months ago
Show doc for...
Tokens:
Raw
### Setup Slack Integration

Source: https://exe.dev/docs/integrations-slack

Command to initiate the Slack integration setup process via the CLI.

```bash
exe.dev ▶ integrations setup slack
```

--------------------------------

### Stat command examples

Source: https://exe.dev/docs/cli-stat

Examples showing how to query metrics for different time ranges.

```bash
stat my-vm             # last 24 hours (default)
stat my-vm --range=7d  # last 7 days
stat my-vm --range=30d # last 30 days
```

--------------------------------

### Setup Service Integration

Source: https://exe.dev/docs/cli-integrations

Initializes a new service integration.

```bash
integrations setup <type> [args...]
```

--------------------------------

### Install and enable systemd service

Source: https://exe.dev/docs/all.md

Commands to register the service file with systemd and start the runner immediately.

```bash
sudo cp /home/exedev/actions-runner/gh-actions-runner.service /etc/systemd/system/
```

```bash
sudo systemctl daemon-reload
sudo systemctl enable --now gh-actions-runner.service
```

--------------------------------

### Set default setup script

Source: https://exe.dev/docs/customization

Configure a default setup script to run on all new VMs.

```bash
$ (echo '#!/bin/bash'; echo touch /tmp/fine) | ssh exe.dev defaults write dev.exe new.setup-script
```

--------------------------------

### Install exe.dev connector for Flue agents

Source: https://exe.dev/docs/use-case-flue

Pipes the connector installation prompt into a specific coding agent for setup.

```bash
flue add https://exe.dev/flue/exedev.md --category sandbox --print | claude
```

```bash
flue add https://exe.dev/flue/exedev.md --category sandbox --print | codex
```

--------------------------------

### Execute inline setup script

Source: https://exe.dev/docs/customization

Run a simple command as a setup script directly within the creation command.

```bash
$ ssh exe.dev new --name my-vm --setup-script '"touch /tmp/no-shebang"'
...
$ ssh my-vm.exe.xyz ls -l /tmp/no-shebang
-rw-r--r-- 1 exedev exedev 0 Mar 28 00:52 /tmp/no-shebang
```

--------------------------------

### Execute multi-line setup script

Source: https://exe.dev/docs/customization

Run a multi-line script using newline characters within the setup script argument.

```bash
exe.dev ▶ new --name lynx-zebra --setup-script "#!/bin/python3\nopen('/tmp/foo', 'w')"
...
exe.dev ▶ ssh lynx-zebra ls -l /tmp/foo
-rw-r--r-- 1 exedev exedev 0 Mar 28 00:50 /tmp/foo
```

--------------------------------

### Setup GitHub Integration

Source: https://exe.dev/docs/cli-integrations

Configures GitHub account access.

```bash
integrations setup github [--list|--verify|-d]
```

--------------------------------

### Execute setup script via pipe

Source: https://exe.dev/docs/customization

Pipe a local script into the new VM creation command to run it at first boot.

```bash
$ cat setup.sh
#!/bin/sh
touch /tmp/foo
$ cat setup.sh | ssh exe.dev new --setup-script /dev/stdin
...
$ ssh scarlet-nebula.exe.xyz ls -l /tmp/foo
-rw-r--r-- 1 exedev exedev 0 Mar 28 00:49 /tmp/foo
```

--------------------------------

### GET /new

Source: https://exe.dev/docs/all.md

Spins up a VM, opens Shelley, clones the specified repository, and prefills deployment instructions.

```APIDOC
## GET /new

### Description
Spins up a VM, opens Shelley, clones the repository, and prefills the deploy instructions.

### Method
GET

### Endpoint
https://exe.dev/new

### Parameters
#### Query Parameters
- **repo** (string) - Required - The full URL of the public GitHub repository (e.g., https://github.com/OWNER/REPO)
```

--------------------------------

### integrations setup

Source: https://exe.dev/docs/all.md

Sets up a service integration such as GitHub or ChatGPT.

```APIDOC
## integrations setup <type> [args...]

### Description
Set up a service integration.

### Subcommands
- `integrations setup github`: Set up GitHub integration. Options: `-d`, `--delete`, `--list`, `--verify`.
- `integrations setup chatgpt`: Set up ChatGPT account access. Options: `-d`, `--delete`, `--list`, `--name`, `--verify`.
```

--------------------------------

### Create a new VM using CLI

Source: https://exe.dev/docs/cli-new

Various examples of creating a VM with different configurations such as custom names, resource allocation, tags, and environment variables.

```bash
new                                     # just give me a computer
new --name=b --image=ubuntu:22.04       # custom image and name
new --cpu=4 --memory=16GB               # 4 CPUs, 16GB RAM
new --disk=50GB                         # 50GB disk
new --tag=prod,staging                  # create with tags
new --env FOO=bar --env BAZ=qux         # with environment variables
new --integration=myproxy               # attach an integration
echo 'build me a web app' | ssh exe.dev new --prompt=/dev/stdin
```

--------------------------------

### Install systemd service

Source: https://exe.dev/docs/use-case-gh-action-runner

Copies the created service file to the systemd directory.

```bash
sudo cp /home/exedev/actions-runner/gh-actions-runner.service /etc/systemd/system/
```

--------------------------------

### Clear default setup script

Source: https://exe.dev/docs/customization

Remove the previously configured default setup script.

```bash
$ ssh exe.dev defaults delete dev.exe new.setup-script
```

--------------------------------

### Enable and start the service

Source: https://exe.dev/docs/use-case-gh-action-runner

Reloads the systemd daemon and enables the runner service to start on boot.

```bash
sudo systemctl daemon-reload
sudo systemctl enable --now gh-actions-runner.service
```

--------------------------------

### Execute setup scripts during VM creation

Source: https://exe.dev/docs/all.md

Run custom scripts at first boot by piping them into the new VM command.

```bash
$ cat setup.sh
#!/bin/sh
touch /tmp/foo
$ cat setup.sh | ssh exe.dev new --setup-script /dev/stdin
...
$ ssh scarlet-nebula.exe.xyz ls -l /tmp/foo
-rw-r--r-- 1 exedev exedev 0 Mar 28 00:49 /tmp/foo
```

```bash
$ ssh exe.dev new --name my-vm --setup-script '"touch /tmp/no-shebang"'
...
$ ssh my-vm.exe.xyz ls -l /tmp/no-shebang
-rw-r--r-- 1 exedev exedev 0 Mar 28 00:52 /tmp/no-shebang
```

```bash
exe.dev ▶ new --name lynx-zebra --setup-script "#!/bin/python3\nopen('/tmp/foo', 'w')"
...
exe.dev ▶ ssh lynx-zebra ls -l /tmp/foo
-rw-r--r-- 1 exedev exedev 0 Mar 28 00:50 /tmp/foo
```

--------------------------------

### Install or Upgrade Shelley

Source: https://exe.dev/docs/cli-shelley

Installs or upgrades the Shelley agent on a specified virtual machine.

```bash
shelley install <vm>
```

--------------------------------

### CLI cp command examples

Source: https://exe.dev/docs/cli-cp

Common usage patterns for copying virtual machines with various resource and tag configurations.

```bash
cp my-vm                          # copy with auto-generated name
cp my-vm my-vm-copy               # copy with specific name
cp my-vm --cpu=4 --memory=16GB    # copy with different resources
cp my-vm --copy-tags=false        # copy without tags
```

--------------------------------

### Domain Management Examples

Source: https://exe.dev/docs/cli-domain

Common operations for adding, listing, and removing domains.

```bash
domain add my-vm app.example.com  # register a CNAME you've already set up
domain add --wildcard my-vm app.example.com  # also issue a *.example.com cert
domain ls my-vm                   # list domains on one VM
domain ls -a                      # list domains across all your VMs
domain rm my-vm app.example.com   # remove a domain
```

--------------------------------

### Setup ChatGPT Integration

Source: https://exe.dev/docs/cli-integrations

Configures ChatGPT account access for LLM features.

```bash
integrations setup chatgpt [--name=<account-name>|--list|--verify|-d]
```

--------------------------------

### Example team settings output

Source: https://exe.dev/docs/teams/sharing-controls

Shows the expected output format when checking team settings.

```text
Team settings:
  vm-sharing: all-members
```

--------------------------------

### shelley install

Source: https://exe.dev/docs/cli-shelley

Installs or upgrades the Shelley agent on the specified virtual machine.

```APIDOC
## shelley install

### Description
Install or upgrade Shelley to the current version on a target VM.

### Usage
`shelley install <vm>`

### Parameters
- **vm** (string) - Required - The identifier of the virtual machine where Shelley should be installed or upgraded.
```

--------------------------------

### Start Next.js development server

Source: https://exe.dev/docs/faq/nextjs-and-friends

Bind the Next.js server to 0.0.0.0 to ensure it is accessible from the network.

```bash
npx next dev -H 0.0.0.0 -p 8000
```

--------------------------------

### Setup ChatGPT account connection

Source: https://exe.dev/docs/integrations-llm

Initiates the device-code flow to connect a ChatGPT account for use with LLM integrations.

```bash
exe.dev ▶ integrations setup chatgpt --name work
Open this URL to authorize ChatGPT:
  https://chatgpt.com/...

Enter this code:
  ABCD-EFGH

Waiting for authorization...
```

--------------------------------

### GET /

Source: https://exe.dev/docs/all.md

Retrieves the list of available metadata paths for the VM.

```APIDOC
## GET /

### Description
Returns a list of available metadata paths that can be queried on the reflection service.

### Method
GET

### Endpoint
https://reflection.int.exe.xyz/

### Response
#### Success Response (200)
- **paths** (array) - List of available metadata endpoints and their descriptions.

#### Response Example
{
  "paths": [
    { "description": "owner email address", "path": "/email" },
    { "description": "integrations available to this VM", "path": "/integrations" },
    { "description": "tags set on this VM", "path": "/tags" },
    { "description": "comment set on this VM", "path": "/comment" },
    { "description": "default proxy port for this VM", "path": "/default_port" }
  ]
}
```

--------------------------------

### Examples of adding and removing tags

Source: https://exe.dev/docs/cli-tag

Demonstrates the syntax for adding multiple tags and removing tags using the -d flag.

```bash
tag my-vm prod web        # add tags
tag -d my-vm prod web     # remove tags
```

--------------------------------

### Run the Docker registry container

Source: https://exe.dev/docs/private-image

Start the registry container on the newly created VM, mapping port 8000 to the registry's internal port 5000.

```bash
$ssh private-registry-test.exe.xyz docker run -d --name registry -p 8000:5000 registry:2
```

--------------------------------

### Verify OIDC configuration

Source: https://exe.dev/docs/teams/sso

Displays the confirmation and callback URL after a successful OIDC setup.

```text
Auth provider set to oidc
SSO issuer:    https://your-org.okta.com
Callback URL:  https://exe.dev/oauth/oidc/callback
```

--------------------------------

### GET /v1/models

Source: https://exe.dev/docs/all.md

Lists all available models accessible through the integration.

```APIDOC
## GET /v1/models

### Description
Retrieves a list of all models available through the integration.

### Method
GET

### Endpoint
https://llm.int.exe.xyz/v1/models
```

--------------------------------

### GET /suggest

Source: https://exe.dev/docs/suggest-links

Generates a link that opens the exe.dev dashboard to display a specific lobby command for user confirmation and execution.

```APIDOC
## GET /suggest

### Description
Opens a page in the exe.dev dashboard that shows a single lobby command, describes its function, and provides a Run button for the user.

### Method
GET

### Endpoint
https://exe.dev/suggest

### Parameters
#### Query Parameters
- **command** (string) - Required - The lobby command string to be suggested, which must be URL-encoded.
```

--------------------------------

### Static SSH config setup

Source: https://exe.dev/docs/faq/tab-completion

Configures static host completion by including a generated file in the SSH configuration.

```text
Include ~/.ssh/exe-hosts
```

```bash
ssh exe.dev ls --json | jq -r '.vms[].ssh_dest' | sed 's/^/Host /' > ~/.ssh/exe-hosts
```

--------------------------------

### GET /integrations

Source: https://exe.dev/docs/all.md

Retrieves the list of integrations currently attached to the VM.

```APIDOC
## GET /integrations

### Description
Returns a list of integrations attached to the VM, including their names, types, and help documentation.

### Method
GET

### Endpoint
https://reflection.int.exe.xyz/integrations

### Response
#### Success Response (200)
- **integrations** (array) - List of attached integrations.

#### Response Example
{
  "integrations": [
    {
      "comment": "",
      "help": "curl https://reflection.int.exe.xyz/",
      "name": "reflection",
      "type": "reflection"
    },
    {
      "comment": "",
      "help": "curl https://llm.int.exe.xyz/v1/models",
      "name": "llm",
      "type": "llm"
    }
  ]
}
```

--------------------------------

### Clone repository from VM

Source: https://exe.dev/docs/integrations-github

Standard git clone command used from within the VM after integration setup.

```bash
git clone https://github.int.exe.xyz/ghuser/blog.git
```

--------------------------------

### GET /__exe.dev/login

Source: https://exe.dev/docs/login-with-exe

Redirects the user to the login page and returns them to the specified path upon successful authentication.

```APIDOC
## GET /__exe.dev/login

### Description
Redirects the user to log in, then returns them to the specified path.

### Method
GET

### Endpoint
https://vmname.exe.xyz/__exe.dev/login

### Parameters
#### Query Parameters
- **redirect** (string) - Required - The path to return to after successful login.
```

--------------------------------

### Create a new VM

Source: https://exe.dev/docs/all.md

Initializes a new virtual machine instance using the exe.dev CLI.

```bash
ssh exe.dev new
```

--------------------------------

### Initialize Integration Environment Variables

Source: https://exe.dev/docs/integrations-gcp-wif

Sets up the necessary environment variables and fetches metadata from the integration URL.

```bash
export INTEGRATION_NAME=gcpwif

export EXE_WIF_URL="https://${INTEGRATION_NAME}.int.exe.xyz"
export EXE_WIF_METADATA_FILE="/tmp/exe-${INTEGRATION_NAME}-gcp-wif-metadata.json"
export GOOGLE_APPLICATION_CREDENTIALS="$HOME/.config/gcloud/exe-${INTEGRATION_NAME}-gcp-wif.json"

mkdir -p "$(dirname "$GOOGLE_APPLICATION_CREDENTIALS")"
curl -fsS "$EXE_WIF_URL/metadata" > "$EXE_WIF_METADATA_FILE"
```

--------------------------------

### new

Source: https://exe.dev/docs/all.md

Create a new virtual machine instance.

```APIDOC
## new

### Description
Create a new VM.

### Options
- `--comment`: short note about the VM (max 200 bytes)
- `--cpu`: number of CPUs (default 2)
- `--disk`: disk size (e.g., 20, 20GB, 50G)
- `--env`: environment variable in KEY=VALUE format
- `--image`: container image
- `--integration`: integration name to attach
- `--json`: output in JSON format
- `--memory`: memory allocation (e.g., 4, 4GB, 8G)
- `--name`: VM name
- `--no-email`: do not send email notification
- `--prompt`: initial prompt to send to Shelley after VM creation
- `--registry-auth`: private container registry credentials as USERNAME:PASSWORD
- `--setup-script`: setup script to run on first boot (max 10KiB)
- `--tag`: tag to add to the VM
```

--------------------------------

### GET /v1/models

Source: https://exe.dev/docs/integrations-llm

Retrieves a list of available LLM models.

```APIDOC
## GET /v1/models

### Description
Lists all available LLM models accessible through the integration.

### Method
GET

### Endpoint
https://llm.int.exe.xyz/v1/models
```

--------------------------------

### List Integrations

Source: https://exe.dev/docs/cli-integrations

Displays all configured integrations.

```bash
integrations list
```

--------------------------------

### Create a VM for the registry

Source: https://exe.dev/docs/private-image

Initialize a new VM to host the private Docker registry.

```bash
$ssh exe.dev new --name private-registry-test
```

--------------------------------

### Provision and Manage Marimo Notebooks

Source: https://exe.dev/docs/use-case-marimo

Commands for creating a new instance, viewing deployment details, and removing the virtual machine.

```bash
ssh exe.dev new --image=ghcr.io/marimo-team/marimo:latest-sql
```

```bash
$ ssh exe.dev new --image=ghcr.io/marimo-team/marimo:latest-sql
Creating nan-tango using image marimo-team/marimo:latest-sql...

App (HTTPS proxy → :8080)
https://nan-tango.exe.xyz

SSH
ssh nan-tango.exe.xyz
```

```bash
ssh exe.dev rm <vm-name>
```

--------------------------------

### Deploy a Marimo Notebook

Source: https://exe.dev/docs/all.md

Use the exe.dev CLI to provision a new virtual machine running the Marimo notebook image.

```bash
ssh exe.dev new --image=ghcr.io/marimo-team/marimo:latest-sql
```

```bash
$ ssh exe.dev new --image=ghcr.io/marimo-team/marimo:latest-sql
Creating nan-tango using image marimo-team/marimo:latest-sql...

App (HTTPS proxy → :8080)
https://nan-tango.exe.xyz

SSH
ssh nan-tango.exe.xyz
```

--------------------------------

### Create a VM using the private registry image

Source: https://exe.dev/docs/private-image

Deploy a new VM using an image hosted on the private registry VM.

```bash
$ssh exe.dev new --image private-registry-test.exe.xyz/my-image:v1
Creating oboe-hydra using image my-image:v1...
```

--------------------------------

### Execute command via HTTPS

Source: https://exe.dev/docs/https-api

Example of running a command using a bearer token.

```bash
curl -X POST https://exe.dev/exec \
     -H "Authorization: Bearer exe1.AAA" \
     -d whoami
```

--------------------------------

### Pin a specific agent version

Source: https://exe.dev/docs/upgrade-codex

Install a specific release version instead of the latest available.

```sh
sudo exeuntu update claude --version 2.1.185
sudo exeuntu update codex --version rust-v0.140.0
exeuntu update pi --version 1.2.3
```

--------------------------------

### Access Event Types Directly

Source: https://exe.dev/docs/use-case-cal-diy

Navigate to this URL to bypass the initial calendar connection setup wizard.

```text
https://<vm-name>.exe.xyz:3000/event-types
```

--------------------------------

### Verify the image deployment

Source: https://exe.dev/docs/private-image

Confirm the image is running correctly by checking the contents of a file inside the new VM.

```bash
$ssh oboe-hydra.exe.xyz cat /hello.txt
built-it
```

--------------------------------

### Query Anthropic via curl

Source: https://exe.dev/docs/shelley/llm-gateway

Example of sending a request to the Anthropic API through the gateway using curl.

```bash
$ curl -s http://169.254.169.254/gateway/llm/anthropic/v1/messages \
    -H "content-type: application/json" \
    -H "anthropic-version: 2023-06-01" \
    -d '{
      "model": "claude-sonnet-4-6",
      "max_tokens": 256,
      "messages": [{"role": "user", "content": "Hello!"}]
    }'
```

--------------------------------

### Set OCI container label

Source: https://exe.dev/docs/customization

Apply OCI labels to customize VM behavior, such as installing specific software.

```dockerfile
LABEL exe.dev/install-shelley=true
```

--------------------------------

### Initialize AWS WIF Environment Variables

Source: https://exe.dev/docs/integrations-aws-wif

Sets up the necessary environment variables and fetches the metadata and identity token from the WIF endpoint.

```bash
export INTEGRATION_NAME=awswif

export EXE_WIF_URL="https://${INTEGRATION_NAME}.int.exe.xyz"
export EXE_WIF_METADATA_FILE="/tmp/exe-${INTEGRATION_NAME}-aws-wif-metadata.json"
export AWS_WEB_IDENTITY_TOKEN_FILE="/tmp/exe-${INTEGRATION_NAME}-aws-web-identity-token"
export AWS_ROLE_SESSION_NAME="exe-${INTEGRATION_NAME}"

curl -fsS "$EXE_WIF_URL/metadata" > "$EXE_WIF_METADATA_FILE"
curl -fsS "$EXE_WIF_URL/token" | jq -r .token > "$AWS_WEB_IDENTITY_TOKEN_FILE"
```

--------------------------------

### Attach Integration

Source: https://exe.dev/docs/cli-integrations

Mounts an integration to a VM or tag.

```bash
integrations attach <name> <spec> [--team]
```

```bash
int attach my-mcp vm:dev1
int attach my-mcp tag:production
int attach my-mcp auto:all
int attach shared-mcp tag:production
```

--------------------------------

### Manage Trial Invites via CLI

Source: https://exe.dev/docs/invites

Commands to manage existing trial invites or request additional ones.

```bash
exe.dev ▶ invite manage
```

```bash
exe.dev ▶ invite request
```

--------------------------------

### Set AWS account configuration variables

Source: https://exe.dev/docs/integrations-aws-wif

Define one-time environment variables required for the AWS account setup.

```bash
export AWS_ACCOUNT_ID=123456789012

export AWS_AUDIENCE=sts.amazonaws.com
export AWS_OIDC_PROVIDER_ARN="arn:aws:iam::${AWS_ACCOUNT_ID}:oidc-provider/exe.dev"
```

--------------------------------

### Build and push an image to the private registry

Source: https://exe.dev/docs/private-image

Create a Dockerfile, build the image, and push it to the local registry instance.

```bash
$ cat > Dockerfile <<EOF
FROM alpine:latest
RUN echo exe.dev > /hello.txt
EOF

$ docker build -t localhost:8000/my-image:v1
$ docker push localhost:8000/my-image:v1
```

--------------------------------

### Generate Credential Configuration and Authenticate

Source: https://exe.dev/docs/integrations-gcp-wif

Parses metadata to create a credential configuration file and logs into GCP using the generated file.

```bash
export PROJECT_NUMBER="$(jq -r .project_number "$EXE_WIF_METADATA_FILE")"
export POOL_ID="$(jq -r .pool_id "$EXE_WIF_METADATA_FILE")"
export PROVIDER_ID="$(jq -r .provider_id "$EXE_WIF_METADATA_FILE")"
export SERVICE_ACCOUNT_EMAIL="$(jq -r .service_account "$EXE_WIF_METADATA_FILE")"
export GCP_PROVIDER_RESOURCE="projects/${PROJECT_NUMBER}/locations/global/workloadIdentityPools/${POOL_ID}/providers/${PROVIDER_ID}"

gcloud iam workload-identity-pools create-cred-config "$GCP_PROVIDER_RESOURCE" \
  --service-account "$SERVICE_ACCOUNT_EMAIL" \
  --credential-source-url "$EXE_WIF_URL/token" \
  --credential-source-type json \
  --credential-source-field-name token \
  --output-file "$GOOGLE_APPLICATION_CREDENTIALS"

gcloud auth login --cred-file="$GOOGLE_APPLICATION_CREDENTIALS"
```

--------------------------------

### Repository Deployment URL Structure

Source: https://exe.dev/docs/repo-buttons

Use this URL format to initiate a VM spin-up, clone a repository, and prefill deployment instructions.

```text
/new?repo=https://github.com/OWNER/REPO
```

--------------------------------

### Add GitHub repository integration

Source: https://exe.dev/docs/integrations-github

Create a per-repo integration and clone the repository from a VM.

```bash
exe.dev ▶ integrations add github --name blog --repository ghuser/blog --attach vm:my-vm
Added integration blog

Usage from a VM:
  ssh my-vm 'cd $(mktemp -d) && git clone https://github.int.exe.xyz/ghuser/blog.git'
```

--------------------------------

### Send Slack Block Kit Message

Source: https://exe.dev/docs/integrations-slack

Example of sending a formatted message using Slack's Block Kit payload.

```bash
curl --json '{"blocks":[{"type":"section","text":{"type":"mrkdwn","text":"*deploy done* :rocket:"}}]}' \
  https://slack-hook.int.exe.xyz/
```

--------------------------------

### cp

Source: https://exe.dev/docs/all.md

Copies an existing virtual machine with optional resource overrides.

```APIDOC
## cp

### Description
Copy an existing VM.

### Usage
`cp <source-vm> [new-name] [--memory=<size>] [--cpu=<count>] [--disk=<size>]`

### Options
- `--copy-tags`: copy tags from source VM
- `--cpu`: number of CPUs
- `--disk`: disk size
- `--json`: output in JSON format
- `--memory`: memory allocation
```

--------------------------------

### Update agents on the VM

Source: https://exe.dev/docs/upgrade-codex

Use the exeuntu update command to update agents directly on the VM. Verify the installation by checking the version of each agent.

```sh
sudo exeuntu update claude
sudo exeuntu update codex
exeuntu update pi

claude --version
codex --version
pi --version
```

--------------------------------

### Add Deployment Buttons to README

Source: https://exe.dev/docs/repo-buttons

Include these Markdown snippets in your README.md to provide direct links for deploying or building with Shelley.

```markdown
[![Deploy on exe.dev](https://raw.githubusercontent.com/boldsoftware/exe.dev/main/assets/buttons/deploy-on-exe-dev.png)](https://exe.dev/new?repo=https://github.com/OWNER/REPO)

[![Build with Shelley](https://raw.githubusercontent.com/boldsoftware/exe.dev/main/assets/buttons/build-with-shelley.png)](https://exe.dev/new?repo=https://github.com/OWNER/REPO)
```

--------------------------------

### Manage Custom Domains via CLI

Source: https://exe.dev/docs/all.md

Commands for registering, listing, and removing custom domains associated with a VM.

```bash
ssh exe.dev domain add <vm> <domain>
```

```bash
ssh exe.dev domain ls <vm>
```

```bash
ssh exe.dev domain ls -a
```

```bash
ssh exe.dev domain rm <vm> <domain>
```

--------------------------------

### Show invite activity

Source: https://exe.dev/docs/cli-invite

Displays signups, upgrades, and reward status.

```bash
invite activity
```

--------------------------------

### General CLI Usage

Source: https://exe.dev/docs/cli-integrations

Base command structure for managing integrations.

```bash
integrations <subcommand> [args...]
```

--------------------------------

### Reinstall Default Integrations

Source: https://exe.dev/docs/integrations

Commands to restore the default reflection and LLM integrations to a VM.

```bash
exe.dev ▶ integrations add reflection --name reflection --fields all --attach auto:all
```

```bash
exe.dev ▶ integrations add llm --name llm --attach auto:all
```

--------------------------------

### Add Domain Command

Source: https://exe.dev/docs/cli-domain

Syntax for linking a custom domain to a VM.

```bash
domain add [--wildcard] <vm> <domain>
```

--------------------------------

### CLI Help Command Usage

Source: https://exe.dev/docs/cli-help

Displays help information for the CLI or specific commands.

```text
help [command ...]
```

--------------------------------

### List available metadata paths

Source: https://exe.dev/docs/integrations-reflection

Query the root endpoint to discover available metadata paths and their descriptions.

```bash
$ curl -s https://reflection.int.exe.xyz/
{
  "paths": [
    { "description": "owner email address", "path": "/email" },
    { "description": "integrations available to this VM", "path": "/integrations" },
    { "description": "tags set on this VM", "path": "/tags" },
    { "description": "comment set on this VM", "path": "/comment" },
    { "description": "default proxy port for this VM", "path": "/default_port" }
  ]
}
```

--------------------------------

### help

Source: https://exe.dev/docs/all.md

Displays help information for the CLI.

```APIDOC
## help

### Description
Show help information for CLI commands.

### Usage
`help [command ...]`

### Options
- `--json`: output in JSON format
```

--------------------------------

### Reinstall Reflection integration

Source: https://exe.dev/docs/integrations-llm

Command to reinstall the reflection integration if Shelley fails to discover attached LLM models.

```bash
exe.dev ▶ integrations add reflection --name reflection --fields all --attach auto:all
```

--------------------------------

### Create VM with custom Docker image

Source: https://exe.dev/docs/customization

Use a custom Docker image when creating a new VM.

```bash
ssh exe.dev new --image=myorg/my-custom-image:latest
```

--------------------------------

### Assemble API token

Source: https://exe.dev/docs/all.md

Steps to define permissions, sign them with an SSH key, and construct the final token string.

```bash
export PERMISSIONS='{}'
```

```bash
export PAYLOAD=$(printf '%s' "$PERMISSIONS" | base64 | b64url)
```

```bash
export SIG=$(printf '%s' "$PERMISSIONS" | ssh-keygen -Y sign -f ~/.ssh/exe_dev_api -n v0@exe.dev)
```

```bash
export SIGBLOB=$(echo "$SIG" | sed '1d;$d' | b64url)
```

```bash
export TOKEN="exe0.$PAYLOAD.$SIGBLOB"
```

--------------------------------

### Create and use an HTTP proxy integration

Source: https://exe.dev/docs/integrations-http-proxy

Adds an HTTP proxy integration with a custom header and demonstrates usage via curl from a VM.

```bash
exe.dev ▶ integrations add http-proxy --name mirror --target https://httpbin.org/ --header prettiest-of-them-all:me --attach vm:my-vm-name
Added integration mirror

Usage from a VM:
  ssh my-vm-name curl http://mirror.int.exe.xyz/

exe.dev ▶ ssh my-vm-name curl -s http://mirror.int.exe.xyz/anything -Hfoo:bar
{
  "args": {},
  "data": "",
  "files": {},
  "form": {},
  "headers": {
    "Accept": "*/*",
    "Accept-Encoding": "gzip",
    "Foo": "bar",
    "Host": "httpbin.org",
    "Prettiest-Of-The-All": "me",
    "User-Agent": "curl/8.5.0",
    "X-Amzn-Trace-Id": "Root=1-69b339a2-0032d20f5263c6dc17235289"
  },
  "json": null,
  "method": "GET",
  "origin": "64.34.88.25",
  "url": "https://httpbin.org/anything"
}
```

--------------------------------

### Add New Integration

Source: https://exe.dev/docs/cli-integrations

Registers a new integration with specific configuration.

```bash
integrations add <type> --name=<name> [--team] [args...]
```

--------------------------------

### Execute browser command

Source: https://exe.dev/docs/cli-browser

Run the browser command to generate a magic link for website login.

```bash
browser
```

--------------------------------

### Attach integrations during creation

Source: https://exe.dev/docs/integrations-attach

Attach integrations while creating them or when provisioning a new VM.

```bash
exe.dev ▶ integrations add github --name blog --repository ghuser/blog --attach auto:all
exe.dev ▶ integrations add http-proxy --name myapi --target https://api.example.com --bearer sk-... --attach tag:prod
```

```bash
exe.dev ▶ new --name my-vm --integration blog --integration myapi
```

--------------------------------

### Run Terraform with GCS backend

Source: https://exe.dev/docs/integrations-gcp-wif

Initialize and apply Terraform configurations using GCS for state management. Requires access to the state bucket and managed resources.

```bash
terraform init -backend-config="bucket=${STATE_BUCKET}"
terraform apply
```

--------------------------------

### Create systemd service file

Source: https://exe.dev/docs/use-case-gh-action-runner

Creates a service definition file for the GitHub Actions runner in the specified directory.

```bash
cat > /home/exedev/actions-runner/gh-actions-runner.service << 'EOF'
[Unit]
Description=GitHub Actions Runner
After=network.target

[Service]
Type=simple
User=exedev
WorkingDirectory=/home/exedev/actions-runner
ExecStart=/home/exedev/actions-runner/run.sh
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target
EOF
```

--------------------------------

### Authenticate with GitHub using a token

Source: https://exe.dev/docs/faq/github-token

Use these commands to save a token to a file and authenticate the GitHub CLI, followed by configuring git and cloning a repository.

```bash
$ cat > token
(paste the token and hit ctrl-d)
$ gh auth login --with-token < token
$ gh auth setup-git
$ git clone https://github.com/USER/REPO
```

--------------------------------

### List Domains Command

Source: https://exe.dev/docs/cli-domain

Syntax for listing domains for a specific VM or all VMs.

```bash
domain ls <vm> | domain ls -a
```

--------------------------------

### Copy a VM

Source: https://exe.dev/docs/all.md

Creates a copy of an existing virtual machine with optional resource overrides.

```bash
cp <source-vm> [new-name] [--memory=<size>] [--cpu=<count>] [--disk=<size>]
```

```bash
cp my-vm                          # copy with auto-generated name
cp my-vm my-vm-copy               # copy with specific name
cp my-vm --cpu=4 --memory=16GB    # copy with different resources
cp my-vm --copy-tags=false        # copy without tags
```

--------------------------------

### Create a peer HTTP proxy integration

Source: https://exe.dev/docs/integrations-http-proxy

Configures an HTTP proxy as a peer integration to enable secure VM-to-VM communication with automatic API key injection.

```bash
exe.dev ▶ integrations add http-proxy --name talk-to-bob --target https://bob.<your-domain>/ --peer --attach vm:alice
```

--------------------------------

### Attach Integrations to Resources

Source: https://exe.dev/docs/integrations-llm

Use the CLI to attach an integration to specific VMs, tags, or all available VMs.

```bash
exe.dev ▶ integrations attach chatgpt-llm vm:devbox
exe.dev ▶ integrations attach chatgpt-llm tag:llm
exe.dev ▶ integrations attach chatgpt-llm auto:all
```
Tokens:
Raw