Skip to content

feat(cli): add zero command for claimable projects without signup - #2061

Draft
ChiragAgg5k wants to merge 2 commits into
mainfrom
feat/cli-zero
Draft

ChiragAgg5k wants to merge 2 commits into
mainfrom
feat/cli-zero

Conversation

@ChiragAgg5k

@ChiragAgg5k ChiragAgg5k commented Oct 15, 2026 •

Copy link
Copy Markdown
Member

appwrite zero: a working project with no account, claimable later.

$ appwrite zero            # POST /v1/zero → appwrite.config.json + key stored as session zero-<projectId>
$ appwrite tablesdb list   # works without login
$ appwrite zero status     # build time left, claim time left, claim link, owner link per domain
$ appwrite zero --json     # full manifest for agents, including claimUrl and accessToken
File What
templates/cli/internal/cmd/zero.go zero, zero status
commands_host.go, commands_host_stub.go register the command
CLI.php, CliCommandSurface.php template + reserved command name

Until the project is claimed its domains open only through https://<domain>/__appwrite/zero?token=<accessToken> (or the X-Appwrite-Zero-Token header); zero prints the link form and zero status lists it for each domain. The claim code and the access token stay in the private prefs file, never in appwrite.config.json. The endpoints are hidden from the spec, so no generated zero service collides with this command.

After the build window, calls return zero_expired until the project is claimed:

Tested against a local server and against Appwrite Cloud staging; built with go build from the generated output.

`appwrite zero` creates a project with no account, links the directory to
it and stores its API key as a session, so project commands and push work
without login. `--json` prints the manifest, including the claim link, so
an agent can hand it back. `appwrite zero status` reports the time left to
build and to claim. The claim code stays in the private prefs file, never
in appwrite.config.json.
@ChiragAgg5k ChiragAgg5k self-assigned this Oct 16, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant