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 installGet going
From nothing to a command running in a computer.
Install
The installer puts
homemadein~/.local/binand adds it to your PATH. Open a new terminal afterwards.curl -fsSL https://www.homemade.dev/install.sh | bashhomemade --versionSign in
Opens your browser to confirm. Then choose the team and project commands use by default.
Terminalhomemade loginhomemade use acme/storefrontStart a computer and run something
--waitreturns once the computer runs.execexits with the command’s own code.Terminalhomemade vm create --branch fix-auth --waithomemade vm exec misty-fern-142 -- pnpm testOpen it in your editor
Adds a section to
~/.ssh/configthe 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 buildhomemade vm listEvery computer in the projecthomemade vm exec <vm> -- <cmd>Run one commandhomemade vm sleep <vm>Put it to sleephomemade vm wake <vm>Wake it where it left offhomemade vm delete <vm>Remove it and its diskTerminals
homemade shell create <vm> --name devA terminal that keeps runninghomemade shell attach <vm>Join it; type ~. to leavehomemade shell send <vm> "git status"Type into ithomemade shell read <vm>Print what it showsKeys and config
homemade api-key create --name ciFor CI; shown oncehomemade ssh-key addEvery computer in your teams accepts ithomemade config validateChecks .homemade/config.jsonhomemade mcpMCP server for coding agentsIn 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 --json0done1API or network failed2wrong usage3not signed in4not found124timed out