Skip to content

Install the CLI ​

The shaep 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) ​

sh
curl -fsSL https://docs.shaep.com/install.sh | sh

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

Installed nextepoch before?

nextepoch was this CLI's earlier name. The installer links nextepoch to shaep, so git setups made with nextepoch git setup keep working. Run shaep git setup once to register the new name.

Manual download ​

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

PlatformDownload
Linux x64 (static)shaep-linux-x64.tar.gz
Linux arm64 (static)shaep-linux-arm64.tar.gz
macOS Apple Siliconshaep-darwin-arm64.tar.gz
macOS Intelshaep-darwin-x64.tar.gz
Windows x64shaep-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 shaep.exe to your PATH (e.g. %LOCALAPPDATA%\Programs\shaep\). Then use it from PowerShell or Windows Terminal.

Sign in ​

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

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

sh
SHAEP_API_KEY=client_id:client_secret shaep 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:

sh
shaep git setup

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

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

Find your repositories and their clone URLs with:

sh
shaep 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 shaep org switch <id> — the credential helper follows automatically. To act in another organization for one command, add --org <slug>.

Everyday commands ​

sh
shaep workspace create my-agent     # new repo + editor + CI
shaep app list                      # deployments in the active org
shaep logs <app> --tail 500         # tail an app's logs
shaep app deploy <app> --tag <tag>  # roll out another version
shaep --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.

Shaep Documentation