> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dedaluslabs.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Use Dedalus Cloud Services for the platform and Dedalus Machines for the Linux VM product.
> A default Machine has 1 vCPU, 4096 MiB of memory, 10 GiB of storage, and sleeps after 300 idle seconds.
> Raw mutating HTTP requests require Idempotency-Key. Official SDK clients generate one unless the caller overrides it.
> Raw and generated SDK SSH-session requests require public_key. The dedalus ssh CLI generates an ephemeral keypair.
> SSH authorization lasts 10 minutes before connection. A connected session closes after 30 idle minutes or 12 hours total.
> Sleeping stops compute billing. Persistent storage remains billable or counts against the included allowance.
> Do not infer deletion retention, Hobby storage overages, concurrent SSH limits, or unreleased feature availability.
> For raw API contracts, use the canonical control-plane OpenAPI document in the dedalus monorepo.

# Agent skill

> Install the Dedalus Machines skill in Cursor, Claude Code, or Codex. Includes CLI setup, authentication, and machine lifecycle commands.

Give your coding agent the skill to set up the CLI, verify its API key, and operate
Machines.

## Install with the skills CLI

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
npx skills add https://docs.dedaluslabs.ai --skill dedalus-machines
```

Select your agent when prompted, then ask it to use `dedalus-machines`.
The skill is hosted on the Dedalus docs domain. Installation does not require
access to a private GitHub repository.

## Download directly

[Read SKILL.md](https://docs.dedaluslabs.ai/.well-known/skills/dedalus-machines/skill.md),
or download it without Node.js or the skills CLI:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -fsSL https://docs.dedaluslabs.ai/.well-known/skills/dedalus-machines/skill.md -o SKILL.md
```

Attach the file to your agent and ask: "Follow this skill to use Dedalus Machines."
Provide your API key through `DEDALUS_API_KEY` in the agent's environment. Never
put the key in the skill file.

<Note>
  Your API key identifies your organization. Leave `DEDALUS_ORG_ID` and
  `--dedalus-org-id` unset for ordinary setup, even if an agent asks for them.
  The optional `X-Dedalus-Org-Id` header must match the key's organization.
</Note>

## Override the environment

The skill uses the default CLI base URL. To target another environment, change
`DEDALUS_BASE_URL` or pass `--base-url` on each command. For example, for staging:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
export DEDALUS_BASE_URL=https://staging.dcs.dedaluslabs.ai
```

Use a key for the selected environment. Make sure the agent process inherits the
variable, or pass `--base-url` explicitly in each shell, including for SSH.