Developers
CLI reference
The Stackap command-line tool is a single program with one-line commands for creating projects, deploying, reading logs, managing variables and domains, and rolling back.
Commands
| Command | What it does |
|---|---|
login --url <api> --token-stdin | Save the server address and token. The token can come from standard input so it never appears in shell history. |
projects [--json] | List your projects, optionally as JSON. |
create <slug> [--name <name>] | Create a project. |
deploy <slug> [--remote-url <url>] | Push HEAD to the project's git remote, which triggers a build. |
deployments <slug> | List a project's deployments. |
rollback <slug> | Re-activate the previous deployment after a health check. |
logs <slug> [--source build|runtime] [--limit N] | Read build or runtime logs. |
env ls|set|rm <slug> [KEY] | List, set (value from standard input with --stdin) or remove an environment variable. |
domains ls|add|rm <slug> [host] | List, attach or detach a hostname. |
cron ls <slug> and cron import <slug> <vercel.json> | List scheduled jobs, or import them from a vercel.json. |
status | Overall health and every monitor check. Platform operators only. Exits non-zero when the overall state is failing. |
db | Not implemented yet. |
Authentication
The tool stores the server address and token in a file in your home configuration directory, created with owner-only permissions. Log in once with stackap login --url https://api.<your-domain> --token-stdin and pipe the token in. Without a saved login, every command stops with the exact login command to run, so an agent that is not logged in can fix it without asking.
Secrets
Environment variables are set with --stdin, so the value comes from a pipe or a prompt and never from an argument that a process listing could show. The same rule applies to the login token.
Output and exit codes
Commands that list things print tables, and projects can print JSON. status exits non-zero when the overall state is failing, so it can sit in a script or a check. Errors print a message that says what to do next where one is known.
What is not there
There are no commands yet for backups, restores, scaling, project settings or organizations. Those are HTTP calls; see the agent documentation for the route table. The db command exists as a placeholder and is not implemented.
Early-access scope
- No backup, restore, scale or settings commands in the tool.
Stackap is in early access. Tell us what you run and we will reply with a straight answer about whether it fits.
Ask for an invitationLast updated .