Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
35 commits
Select commit Hold shift + click to select a range
a5b8ef4
docs(makers-deploy): add anonymous deploy and claim reference
Aug 5, 2026
a8c8243
docs(makers-deploy): clarify expiresAt optionality, token lifetime, U…
Aug 5, 2026
e0436b4
docs(makers-deploy): add anonymous deploy triggers and claim-param rule
Aug 5, 2026
642eb27
docs(makers-deploy): tighten anonymous triggers, complete rule 10
Aug 5, 2026
f838b8b
docs(makers-deploy): separate the rules 9-10 scope marker into its ow…
Aug 5, 2026
b0991b7
docs(makers-deploy): raise CLI version gate to 1.6.21, route unauthen…
Aug 5, 2026
44d11b1
docs(makers-deploy): drop the stale 1.6.0 qualifier from rule 3b
Aug 5, 2026
e98f60a
fix(makers-deploy): scope the 1.6.21 floor to anonymous deploy only
Aug 5, 2026
747e966
docs(makers-deploy): add Anonymous Deploy section with exclusion chec…
Aug 5, 2026
7ec8b55
fix(makers-deploy): repair the storage exclusion check
Aug 5, 2026
06a38ae
docs(makers-deploy): add anonymous deploy and claim to command reference
Aug 5, 2026
6298fb6
docs(makers-cli): add anonymous deploy and claim commands
Aug 5, 2026
d4a70ac
chore: register anonymous-deploy reference, bump to 1.1.0
Aug 5, 2026
e771886
docs(makers-cli): add the --site variant for anonymous deploy
Aug 5, 2026
7a69742
docs: stop showing users a CLI claim command
Aug 7, 2026
0fc24a0
docs(makers-deploy): tell users to claim within 60 minutes
Aug 11, 2026
e4494c5
docs(makers-deploy): stop over-promising what claiming gives the user
Aug 12, 2026
8973154
docs: point users at the claim link only, drop the offer to claim for…
Aug 12, 2026
11abf6f
docs(makers-deploy): follow the user's language; frame expiry as the …
Aug 12, 2026
c96968f
docs(makers-deploy): make the anonymous result a fixed template, not …
Aug 12, 2026
6bcef4d
fix:文案
Aug 13, 2026
dabdf89
docs: open the claim page when asked; keep the result out of process …
Aug 13, 2026
505d40e
docs(makers-deploy): chain the claim flow through edgeone login --claim
Aug 18, 2026
8a5d58d
docs(makers-deploy): reword the deploy-or-login choice in plain language
Aug 19, 2026
be9ed3d
fix:文案
Aug 19, 2026
81ba90b
docs(makers-deploy): anonymous url now arrives signed (NeedVisit)
Aug 20, 2026
0447f18
Merge branch 'main' into feat/anonymous
Aug 20, 2026
12ab39f
chore: record main as merged (lineage fix)
Aug 20, 2026
5a1d471
docs(makers-deploy): never narrate the claim listener to the user
Aug 21, 2026
128556f
chore: bump makers-deploy version to 2.10.4
Aug 21, 2026
0ed1aed
fix:调整选项文案
Aug 26, 2026
84ad402
docs(makers-deploy): default anonymous for anonymous-native tasks, as…
Aug 26, 2026
8af5b18
docs(makers-deploy): drop environment-based auto-anonymous, keep task…
Aug 27, 2026
43022d0
chore:update readme
Aug 28, 2026
337125f
docs: backfill anonymous deploy CLI floor to the released 1.6.29
Aug 31, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ Official AI Agent Skills for developing and deploying projects on [EdgeOne Maker

## Installation

### Option A — `npx skills` (Claude Code / Cursor / Codex / CodeBuddy CLI )
### Option A — `npx skills` (Claude Code / Cursor / Codex / CodeBuddy CLI etc.)

```bash
npx skills add TencentEdgeOne/edgeone-makers-tools
Expand Down
3 changes: 2 additions & 1 deletion _meta.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"ownerId": "442102",
"publishedAt": 1781766512723,
"slug": "edgeone-makers-tools",
"version": "2.0.0",
"version": "2.3.1",
"files": [
"skills/edgeone-makers-tools/SKILL.md",
"skills/edgeone-makers-tools/references/makers-agents/SKILL.md",
Expand Down Expand Up @@ -33,6 +33,7 @@
"skills/edgeone-makers-tools/references/makers-cloud-functions/references/python-functions.md",
"skills/edgeone-makers-tools/references/makers-cloud-functions/references/troubleshooting.md",
"skills/edgeone-makers-tools/references/makers-deploy/SKILL.md",
"skills/edgeone-makers-tools/references/makers-deploy/references/anonymous-deploy.md",
"skills/edgeone-makers-tools/references/makers-deploy/references/command-reference.md",
"skills/edgeone-makers-tools/references/makers-edge-functions/SKILL.md",
"skills/edgeone-makers-tools/references/makers-env-adaption/SKILL.md",
Expand Down
8 changes: 7 additions & 1 deletion codex/makers-cli.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ description: >-
Use when running edgeone CLI commands for dev, build, deploy, env management.
metadata:
author: edgeone
version: "1.0.0"
version: "1.2.1"
---

# EdgeOne Makers CLI Reference
Expand All @@ -28,6 +28,9 @@ Verify: `edgeone -v`
| `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 |
Expand All @@ -36,8 +39,11 @@ Verify: `edgeone -v`
| `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 `claim` require CLI `>= 1.6.29` (the general CLI floor is `1.6.0`). The claim parameter is `--sid` (the anonymous token); `-t` is the account API token — they are different credentials. Tell the user the link expires in 60 minutes; never show the raw `expiresAt`. The claim link you present comes from `edgeone login --claim` (`claimLoginUrl`), not the bare `claimUrl` in the deploy JSON. Details: [makers-deploy/references/anonymous-deploy.md](../makers-deploy/references/anonymous-deploy.md).

## Environment Variable

Before any `edgeone` command, set:
Expand Down
174 changes: 164 additions & 10 deletions codex/makers-deploy.md

Large diffs are not rendered by default.

24 changes: 23 additions & 1 deletion codex/makers-env-adaption.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ validate:
message: "Use 127.0.0.1, not localhost — in the sandbox localhost resolves to ::1 and yields false 404s."
metadata:
author: edgeone
version: "1.1.1"
version: "1.4.2"
---

# Runtime Environment Adaptation Guide
Expand Down Expand Up @@ -295,6 +295,7 @@ If the project named by `--name` does not exist remotely, the `link` command cre
| Framework/package | Minimum version | Reason |
|---------|---------|------|
| EdgeOne CLI | >= 1.6.7 | Non-interactive fixes, whoami fail-fast, --json support |
| EdgeOne CLI (anonymous deploy / `claim` only) | >= 1.6.29 | `--anonymous` and `claim` do not exist below this |
| Next.js | 16.x | The framework adapter tracks new versions |
| @edgeone/pages-blob | >= 0.0.14 | Older versions have known bugs |

Expand All @@ -307,3 +308,24 @@ Use `create-next-app@latest` rather than manually pinning an older version.
WorkBuddy's right-side preview panel does NOT render `window.alert()` / `window.confirm()` / `window.prompt()`. The call returns immediately without user interaction, so any handler gated on `if (confirm("Delete?"))` silently no-ops (a delete button appears to do nothing). The same page works fine in the user's real Chrome / Safari.

**Rule**: for any confirmation, prompt, or notification in the page, use an **in-page custom modal** (a `<div>` overlay with buttons wired via JS). Do NOT rely on the browser's built-in `alert` / `confirm` / `prompt` — the code looks correct in code review, works when the user opens the deployed URL in their own browser, and is silently broken in the WorkBuddy preview during dev/verification.

### 14. Never hand the user a command to run

The user has **no terminal** in the WorkBuddy sandbox. Any command you print as an instruction is dead text — they cannot execute it, and a non-technical user cannot read it either.

| Situation | Do this | Not this |
|---|---|---|
| Anonymous project needs claiming | Run `edgeone login --claim --local --json` in the background and present its `claimLoginUrl` as a clickable link; the listener auto-links the project when the user finishes claiming | ❌ Printing `edgeone makers claim --sid <token>`, or presenting the bare `claimUrl` from the deploy JSON (the CLI never learns the login state) |
| The user needs to log in | Explain, then run `edgeone login --site <china\|global> --local` yourself | ❌ "Run `edgeone login` in your terminal" |
| Something needs installing | Run it yourself in Bash | ❌ "Please run `npm install -g edgeone`" |

You are the one with shell access — use it. Only ask the user to type something when it genuinely cannot be automated (e.g. completing a login in the browser window you opened), and say plainly what you need from them.

### 14.1 Never let the key result get folded into a process message

WorkBuddy can collapse content emitted in the same message as a running or just-finished Bash command into a collapsible process entry. When the user asks to deploy, the deploy URL and claim link must never land there — if they do, the user sees nothing.

| Situation | Do this | Not this |
|---|---|---|
| A deploy just finished | Wait for the Bash call to fully return, then send the result (URL + claim link) **as its own message** | ❌ Emitting the result in the same message where the deploy ran, or attaching it to the command's stdout |
| Running a long command | Report progress only in later messages, after the tool call returns | ❌ Writing "here is your URL" inside the same turn as the command output |
8 changes: 7 additions & 1 deletion cursor/rules/makers-cli.mdc
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ description: >-
Use when running edgeone CLI commands for dev, build, deploy, env management.
metadata:
author: edgeone
version: "1.0.0"
version: "1.2.1"
---

# EdgeOne Makers CLI Reference
Expand All @@ -28,6 +28,9 @@ Verify: `edgeone -v`
| `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 |
Expand All @@ -36,8 +39,11 @@ Verify: `edgeone -v`
| `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 `claim` require CLI `>= 1.6.29` (the general CLI floor is `1.6.0`). The claim parameter is `--sid` (the anonymous token); `-t` is the account API token — they are different credentials. Tell the user the link expires in 60 minutes; never show the raw `expiresAt`. The claim link you present comes from `edgeone login --claim` (`claimLoginUrl`), not the bare `claimUrl` in the deploy JSON. Details: [makers-deploy/references/anonymous-deploy.md](../makers-deploy/references/anonymous-deploy.md).

## Environment Variable

Before any `edgeone` command, set:
Expand Down
Loading
Loading