Appearance
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 | shThe 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:
| Platform | Download |
|---|---|
| Linux x64 (static) | shaep-linux-x64.tar.gz |
| Linux arm64 (static) | shaep-linux-arm64.tar.gz |
| macOS Apple Silicon | shaep-darwin-arm64.tar.gz |
| macOS Intel | shaep-darwin-x64.tar.gz |
| Windows x64 | shaep-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 organizationsHeadless 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-inputConnect git
Platform repositories are served over authenticated HTTPS at git.nextepoch.cloud. Register the CLI as your git credential helper once:
sh
shaep git setupAfter that, plain git works — no tokens in URLs, no password prompts:
sh
git clone https://git.nextepoch.cloud/<org>/<workspace>.git
cd <workspace> && git pushFind 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 referenceEvery command has --help with examples. For scripting and agents: -o json prints raw API objects on stdout; human guidance goes to stderr.