CLI Reference
The Honi CLI helps you scaffold, develop, and deploy agents with zero boilerplate.
Installation
Shell
$npm install -g honidev
honi new <name>
Scaffold a new Honi agent project with all the boilerplate pre-configured.
Shell
$honi new my-agent
# Creates a new directory with a ready-to-deploy agent
Generated File Structure
Files
my-agent/
├── src/
│ ├── index.ts # Agent entry point
│ └── tools/
│ └── example.ts # Example tool
├── wrangler.toml # Cloudflare config
├── package.json
├── tsconfig.json
└── .dev.vars # Local secrets (API keys)
honi dev
Start a local development server with hot reload. This wraps wrangler dev with Honi-specific defaults.
Shell
$honi dev
# Starts local server at http://localhost:8787
# Watches for file changes and auto-reloads
| Flag | Description |
|---|---|
--port <number> | Port to listen on (default: 8787) |
--persist | Persist Durable Object state between restarts |
--remote | Use remote Cloudflare resources instead of local emulation |
honi deploy
Deploy your agent to Cloudflare Workers. This wraps wrangler deploy and handles all Durable Object migrations.
Shell
$honi deploy
# Builds, uploads, and deploys to Cloudflare's edge
# Your agent is live globally in seconds
| Flag | Description |
|---|---|
--env <name> | Deploy to a specific environment (e.g. staging, production) |
--dry-run | Build and validate without actually deploying |