Commands
The commands available today:
| Command | Description |
|---|---|
artprog setup [--alias] | Add artprog to your PATH, and optionally an "art" alias. |
artprog auth login [--dev] | Authorize this device — opens the browser to approve, then stores the credential securely. |
artprog auth status | Show whether you are signed in. |
artprog auth logout | Clear the stored credential. |
artprog status | At-a-glance status: your session, this folder, and the linked project. |
artprog projects list | List the projects in your account. |
artprog init | Link the current folder to a web project (creates .artprog/config.json). |
artprog scan | Discover this Godot project's assets and sync them to the web — a manual one-shot. watch does this automatically, so it is optional. |
artprog push | Upload the pixels for discovered assets so they show up in the editor. |
artprog pull [--yes] | Write the web's current pixels back into your Godot project as PNGs. It lists what will be overwritten and asks first; --yes skips the prompt. |
artprog adopt [--yes] | Write web-created assets (for example Save As copies made in the editor) into this Godot project as files, so they exist on disk. The one-shot counterpart to watch's automatic adopt; --yes skips the prompt. |
artprog watch | The complete set-and-forget sync (Ctrl-C to stop). Both ways and automatic: local edits and new files auto-upload; web edits and new web assets auto-download to disk; Godot re-imports (uids) reconcile and the project settings mirror. Respects .gitignore — git-ignored files stay local. Leave it running; no manual scan needed. |
artprog upgrade [--yes] | Update artprog to the latest release. The compressed download's checksum and signature are verified, then it is unpacked and installed; if either check fails it refuses and keeps the current binary. |
artprog --version | Print the CLI version. |
Advanced
| Option | Description |
|---|---|
--api-url <url> | Target a specific API base URL (power users and self-hosting). |
--dev | Target the development API instead of production. |
--verbose | On failure, also print the underlying cause. |
note
By default the CLI talks to production; --dev is a developer affordance.