EdgeOne Makers CLI Reference
Install
bashnpm 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:
bashexport PAGES_SOURCE=skills
Or inline: PAGES_SOURCE=skills edgeone makers dev
Common Workflows
First-time setup
bashnpm 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
bashedgeone makers deploy
Set env vars for production
bashedgeone makers env set WSA_API_KEY "your-key" edgeone makers env set SUPABASE_URL "https://xxx.supabase.co"

