EdgeOne Makers CLI Reference
Install
npm install -g edgeone
Verify: edgeone -v
Commands
| Command | Description |
|---|---|
edgeone makers dev |
Start local dev server (agent runtime + frontend) |
edgeone makers build |
Build agents + frontend into .edgeone/ |
edgeone makers deploy |
Build and deploy to EdgeOne Makers |
edgeone makers deploy -n <name> |
Deploy as a new project |
edgeone makers deploy -t <token> |
Deploy with API token (CI/headless) |
edgeone makers deploy -e preview |
Deploy to preview environment |
edgeone makers deploy --anonymous --json |
Deploy without login; claim later (CLI ≥ 1.6.29) |
edgeone makers deploy --anonymous --site china|global --json |
Anonymous deploy to a specific site (omit --site to auto-detect by IP) |
edgeone makers claim --sid <token> |
Claim an anonymously-deployed project (requires login) |
edgeone makers link |
Link local project to remote EdgeOne project |
edgeone makers env pull |
Pull remote env vars to local .env |
edgeone makers env set <KEY> <VALUE> |
Set a remote environment variable |
edgeone makers env ls |
List remote environment variables |
edgeone makers env rm <KEY> |
Remove a remote environment variable |
edgeone login |
Login (browser-based) |
edgeone login --site china |
Login to China site |
edgeone login --site global |
Login to Global site |
edgeone login --claim --local --json |
Background listener: prints the login+claim link for an anonymous deploy, then auto-links the claimed project |
edgeone whoami |
Check current login status |
Anonymous deploy and
claimrequire CLI>= 1.6.29(the general CLI floor is1.6.0). The claim parameter is--sid(the anonymous token);-tis the account API token — they are different credentials. Tell the user the link expires in 60 minutes; never show the rawexpiresAt. The claim link you present comes fromedgeone login --claim(claimLoginUrl), not the bareclaimUrlin the deploy JSON. Details: makers-deploy/references/anonymous-deploy.md.
Environment Variable
Before any edgeone command, set:
export PAGES_SOURCE=skills
Or inline: PAGES_SOURCE=skills edgeone makers dev
Common Workflows
First-time setup
npm install -g edgeone
edgeone login
PAGES_SOURCE=skills edgeone makers link
PAGES_SOURCE=skills edgeone makers env pull
PAGES_SOURCE=skills edgeone makers dev
Deploy
edgeone makers deploy
Set env vars for production
edgeone makers env set WSA_API_KEY "your-key"
edgeone makers env set SUPABASE_URL "https://xxx.supabase.co"