Deco CLI ReferenceThe Deco CLI is your interface for managing AI-native projects built with
deco.chat .
Official docs: https://docs.deco.page/
Authentication
Command
Description
deco login
Authenticate and store an API token for subsequent commands.
deco logout
Remove local credentials and end the session.
deco whoami
Show the currently authenticated user and workspace.
Project Management
Command
Description
deco create
Scaffold a new deco project from an official template.
deco configure
Re-run setup for the current directory to change workspace or app settings.
Development
Command
Description
npm run dev
Preferred way to run local Worker and React frontend in watch mode.
deco dev
(Experimental) Future unified development command.
deco link [build-command]
Link your local dev server to a public domain. Supports -p <port>. Example: deco link npm run dev.
Type Generation
Command
Description
deco gen
Generate types for external integrations (deco.gen.ts).
deco gen:self
Generate types for your own tools and workflows via local /mcp endpoint.
Hosting & Deployment
Command
Description
npm run deploy
Builds frontend and invokes deco deploy. Recommended for most use cases.
deco deploy
Bundle and deploy to Cloudflare Workers. Supports -w, -a, and -l.
deco hosting list -w <name>
List deployed apps in a specific workspace.
Integrations
Command
Description
deco add
Add and configure workspace integrations.
Maintenance
Command
Description
deco update
Upgrade the CLI to the latest published version.
Getting Help
Command
Description
deco --help
Display the full list of CLI commands and usage.
Configuration FileThe CLI uses a local config file to store your workspace and app context. Set or
update this configuration anytime using: deco configure
Environment Variables
Variable
Purpose
DECO_CHAT_API_TOKEN
API token for authentication (set by deco login).
DECO_CHAT_API_LOCAL
Overrides API base URL for local development.
DECO_SELF_URL
Local MCP endpoint for deco gen:self to introspect workflows/tools.