OpenHome CLI

Scaffold, deploy, and chat with OpenHome Abilities from your terminal.

The OpenHome CLI is a terminal tool for managing OpenHome Abilities — scaffold a new Ability, deploy it to your account, and chat with your Agent without ever leaving the shell.

It works equally well in a human’s terminal or driven by an AI coding agent (Claude, etc.) — making it a fast loop for build → deploy → test cycles.

Quick start

1. Run it

   npx openhome-cli
   

   No install needed. Requires Node.js.

2. Authenticate

   Paste your OpenHome API key when prompted. The CLI stores it locally for subsequent runs.

3. Pick a command

   The CLI exposes scaffolding, deployment, and chat commands — run it and follow the prompts.

What it can do

Capability	How
Scaffold a new Ability from a template	Generates the Python skeleton and metadata
Deploy an Ability to your account	Packages, zips, and POSTs to the Capabilities API
Chat with your Agent	Full conversation loop in the terminal
Validate an API key	Confirms your key works before deploying

AI-agent use

The CLI is designed so an AI coding agent can drive it end-to-end. Point Claude (or any tool-using agent) at the CLI and it can build, deploy, and test Abilities on its own — massively faster than clicking through the Dashboard.

Under the hood

The CLI calls OpenHome’s public HTTP endpoints. If you want to integrate Ability management into your own tooling, see the API Reference.

Contributing

The CLI is open source at github.com/openhome-dev/openhome-cli. Issues and PRs welcome.