# CLI

One small program for macOS and Linux. Create computers, open their terminals and run commands from your own shell, a script or CI.

`homemade`macOS and LinuxNothing else to install

## Get going

From nothing to a command running in a computer.

1. ### Install

   The installer puts `homemade` in `~/.local/bin` and adds it to your PATH. Open a new terminal afterwards.

   ```
   curl -fsSL https://www.homemade.dev/install.sh | bash
   homemade --version
   ```

2. ### Sign in

   Opens your browser to confirm. Then choose the team and project commands use by default.

   Terminal

   ```
   homemade login
   homemade use acme/storefront
   ```

3. ### Start a computer and run something

   `--wait` returns once the computer runs. `exec` exits with the command’s own code.

   Terminal

   ```
   homemade vm create --branch fix-auth --wait
   homemade vm exec misty-fern-142 -- pnpm test
   ```

4. ### Open it in your editor

   Adds a section to `~/.ssh/config` the first time, so ssh, VS Code and Cursor can reach it.

   ```
   homemade open misty-fern-142
   ```

## Commands

Every command has its own `--help`. Computers go by name or id.

### Computers

`homemade vm create`Start one from the project’s latest build

`homemade vm list`Every computer in the project

`homemade vm exec <vm> -- <cmd>`Run one command

`homemade vm sleep <vm>`Put it to sleep

`homemade vm wake <vm>`Wake it where it left off

`homemade vm delete <vm>`Remove it and its disk

### Terminals

`homemade shell create <vm> --name dev`A terminal that keeps running

`homemade shell attach <vm>`Join it; type `~.` to leave

`homemade shell send <vm> "git status"`Type into it

`homemade shell read <vm>`Print what it shows

### Keys and config

`homemade api-key create --name ci`For CI; shown once

`homemade ssh-key add`Every computer in your teams accepts it

`homemade config validate`Checks `.homemade/config.json`

`homemade mcp`MCP server for coding agents

## In CI

An API key in the environment wins over a signed-in session. Results go to stdout, errors to stderr, and `--json` prints the API’s answer unchanged.

Terminal

```
HOMEMADE_API_KEY="$CI_HOMEMADE_API_KEY" homemade vm list --json
```

- `0`done
- `1`API or network failed
- `2`wrong usage
- `3`not signed in
- `4`not found
- `124`timed out

Make yourself at home.

## Product

- [Pricing](/pricing)
- [Integrations](/integrations)
- [CLI](/cli)
- [MCP](/mcp)
- [API](/api)

## Use cases

- [Claude Code in the cloud](/claude-code-in-the-cloud)
- [Codex in the cloud](/codex-in-the-cloud)
- [AI agent sandbox](/ai-agent-sandbox)
- [Cloud dev environment](/cloud-dev-environment)
- [Preview environments](/preview-environments)

## Compare

- [All comparisons](/compare)

## Resources

- [Docs](https://docs.homemade.dev)
- [Blog](/blog)
- [llms.txt](https://docs.homemade.dev/llms.txt)

## Company

- [Contact](mailto:hello@homemade.dev)
- [GitHub](https://github.com/usehomemade/homemade)

## Legal

- [Impressum](/impressum)
- [Terms](/terms)
- [Privacy](/privacy)

© 2026 homemade.dev

---

Canonical: https://www.homemade.dev/cli
More pages: https://www.homemade.dev/llms.txt
