Zenifra CLI
The Zenifra CLI is the platform's official command-line interface: the npm package is @zenifra/cli and the installed command is zenifra. It lets you operate the platform from a terminal, scripts, and pipelines without relying on the web console for repetitive tasks.
Installation
npm install -g @zenifra/cli
zenifra --helpEvery command has its own help with flags, examples, and expected output:
zenifra help create project
zenifra plans --help
zenifra deploy watch --helpIf you run an incomplete command such as zenifra deploy or zenifra builds, the CLI opens that command's help. All listing commands accept --json, which is useful in scripts.
Required permissions
| Action | Minimum scope |
|---|---|
| List or view a project | project.read on project:<project-id> |
| Create an HTTP project | project.create on organization:* |
| Create a database | database.create on organization:* |
| Create Cache, Queue, or Valkey | managed_service.create on organization:* |
| Trigger a deploy | project.deploy.trigger on project:<project-id> |
| Read builds and logs | project.logs.read on project:<project-id> |
owner has full access. assistant, member, and API Keys need the matching grants.
Using it with coding agents
Coding agents with terminal access can use the CLI directly. For Codex, the official Zenifra plugin guides the agent to use the same CLI commands and profiles, with the credentials and permissions you configured.
To only query data from an AI client, Zenifra MCP provides read-only OAuth access. Use the CLI for terminal operations and MCP for queries inside the AI client.
Next steps
Last updated on