# Envio Cloud CLI

> Use when deploying, managing, or monitoring hosted indexers on the Envio cloud. The envio-cloud CLI covers auth, indexer settings, env vars, deployments, logs, and metrics — from the terminal, CI/CD, or scripts.

- Skill: `enviodev/envio-cloud-cli` (Agent Skill)
- Install (CLI): `npx skillmds@latest add enviodev/envio-cloud-cli`
- Raw SKILL.md: https://api.skillmd.com/api/skills/enviodev/envio-cloud-cli/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: enviodev (https://skillmd.com/u/enviodev)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/enviodev/envio-cloud-cli

---


# Envio Cloud CLI

Run with `npx envio-cloud <command>` (or `npm install -g envio-cloud`). Full docs: https://docs.envio.dev/docs/HyperIndex/envio-cloud-cli

## Auth

- `envio-cloud login` — browser login (30-day session)
- `envio-cloud login --token <github-token>` or `ENVIO_GITHUB_TOKEN` env var — for CI/CD (scopes: `read:org`, `read:user`, `user:email`)
- `envio-cloud token` / `envio-cloud logout` — inspect / end session

## Context

Set defaults once to avoid repeating `--org`/`--indexer` flags:

```bash
envio-cloud config set-org <org>
envio-cloud config set-indexer <indexer>
envio-cloud config get-context
```

## Indexers

- `envio-cloud indexer list [-o json]`
- `envio-cloud indexer get <name>`
- `envio-cloud indexer add --name <name> --repo <repo> [--branch main] [--dry-run]`
- `envio-cloud indexer settings get|set <indexer>` — branch, config file, root dir, auto-deploy
- `envio-cloud indexer env list|set|delete|import <indexer>` — env vars (keys MUST use the `ENVIO_` prefix; changes apply on next deployment)
- `envio-cloud indexer delete <indexer> --yes` — permanent

## Deployments

All take `<indexer> <commit>`:

- `envio-cloud deployment status <indexer> <commit> [--watch-till-synced]`
- `envio-cloud deployment logs <indexer> <commit> [--build] [--level error,warn] [--follow]`
- `envio-cloud deployment metrics <indexer> <commit> [--watch]`
- `envio-cloud deployment endpoint <indexer> <commit>` — GraphQL query URL (alias: `ep`)
- `envio-cloud deployment promote <indexer> <commit> --yes` — promote to production
- `envio-cloud deployment restart <indexer> <commit> --yes` — 10-minute cooldown
- `envio-cloud deployment delete <indexer> <commit> --yes` — permanent

## Scripting

`-o json` outputs `{"ok": true, "data": ...}` or `{"ok": false, "error": "..."}`. Exit codes: 0 success, 1 user error, 2 server error. Use `-q` to suppress informational messages.