Install the CLI

The nextepoch CLI drives the platform from your terminal: organizations, projects, workspaces, apps, deployments, builds, logs — and it connects your local git to platform repositories. It is designed for people and AI agents (every command supports --output json).

Quick install (Linux & macOS)

curl -fsSL https://docs.nextepoch.cloud/install.sh | sh

The script detects your OS and architecture, downloads the latest release, verifies its checksum, and installs nextepoch to /usr/local/bin (or ~/.local/bin when sudo isn't available).

Manual download

Download the archive for your platform, verify the .sha256, and put the binary on your PATH:

Platform	Download
Linux x64 (static)	nextepoch-linux-x64.tar.gz
Linux arm64 (static)	nextepoch-linux-arm64.tar.gz
macOS Apple Silicon	nextepoch-darwin-arm64.tar.gz
macOS Intel	nextepoch-darwin-x64.tar.gz
Windows x64	nextepoch-windows-x64.zip

Checksums: append .sha256 to any URL.

The latest.json manifest lists the current version with a direct URL + sha256 per platform.

Windows

Unpack the zip and add nextepoch.exe to your PATH (e.g. %LOCALAPPDATA%\Programs\nextepoch\). Then use it from PowerShell or Windows Terminal.

Sign in

nextepoch auth login          # opens your browser
nextepoch org list            # verify: shows your organizations

Headless machines and CI/agents use an API key instead (create one in the portal under Settings → Credentials):

export NEXTEPOCH_API_KEY=client_id:client_secret
nextepoch auth login --with-token --no-input

Connect git

Platform repositories are served over authenticated HTTPS at git.nextepoch.cloud. Register the CLI as your git credential helper once:

nextepoch git setup

After that, plain git works — no tokens in URLs, no password prompts:

git clone https://git.nextepoch.cloud/<org>/<workspace>.git
cd <workspace> && git push

Find your repositories and their clone URLs with:

nextepoch workspace list -o json | jq -r '.[].clone_url'

Organization scoping

Your session is pinned to one active organization; only its repos are accessible. Switch with nextepoch org switch <id> — the credential helper follows automatically.

Everyday commands

nextepoch workspace create my-agent    # new repo + editor + CI
nextepoch app list                     # deployments in the active org
nextepoch logs <id> --tail 500         # tail a deployment's logs
nextepoch app deploy <id> --image <ref>
nextepoch --help                       # full command reference

Every command has --help with examples. For scripting and agents: -o json prints raw API objects on stdout; human guidance goes to stderr.