Developer tools

CLI

The orizon command-line tool drives the same API the dashboard uses — deploy your working directory, tail logs, and manage env, all from the terminal.

Install

macOS / Linux:

shell

curl -fsSL https://cdn.orzn.space/cli/install.sh | sh

The installer detects your OS and architecture, drops the orizon binary into /usr/local/bin (falling back to ~/.local/bin), and prints the installed version. Windows builds are available from cdn.orzn.space/cli/latest.

Authenticate

Create a platform API key at dashboard.orizon.ng/api-keys (it looks like orz_pk_…), then log in:

shell

orizon login --key orz_pk_your_key_here

The key is verified and saved to ~/.orizon/config.json (mode 0600). You can also set ORIZON_API_KEY in your environment — it takes precedence over the saved config, which is handy in CI. Override the endpoint with --api or ORIZON_API_BASE.

Commands

projects(alias: ls)List your projects

link--project <id>Link the current directory to a project

deployZip the cwd, upload, deploy, stream logs

logs--followStream a deployment's logs

envpull | pushPull or push environment variables

openOpen the project's URL in a browser

mcpRun the MCP server (for coding agents)

version(-v)Print the CLI version

Deploy your working directory

link writes a .orizon.json in the current folder so future commands know which project they target. deploy then zips the directory (skipping node_modules, .git, dist, build, .next, and similar), uploads it, creates a deployment, and streams the build logs.

shell

cd my-app
orizon link --project proj_123
orizon deploy

Stream logs

shell

orizon logs --follow            # tail the latest deployment
orizon logs --project proj_123  # for a specific project

Environment variables

shell

orizon env pull            # print NAME=VALUE for the project
orizon env push .env       # set variables from a .env file

Open the live app

shell

orizon open                # opens the production URL in your browser

Global flagsEvery command accepts --project <id>, --api <url> and --key <orz_pk_…> to override the project, endpoint and key for a single invocation.

MCP server

orizon mcp runs a stdio MCP server so AI coding agents can manage Orizon directly. See Connect coding agents for one-click setup with Claude Code, Cursor and Windsurf.

Public API

The HTTP API the CLI is built on.

Connect coding agents

Wire your agent to Orizon over MCP.