CLI

CLI

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

homemademacOS 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 | bashhomemade --version
  2. Sign in

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

    Terminal
    homemade loginhomemade 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 --waithomemade 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 createStart one from the project’s latest build
homemade vm listEvery 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 devA 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 ciFor CI; shown once
homemade ssh-key addEvery computer in your teams accepts it
homemade config validateChecks .homemade/config.json
homemade mcpMCP 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
  • 0done
  • 1API or network failed
  • 2wrong usage
  • 3not signed in
  • 4not found
  • 124timed out