envio-cloud-cli

Manages hosted indexer deployments, logs, and metrics on Envio cloud via CLI.

546|55|Updated May 24, 2024
One-click install
npx skills add https://github.com/enviodev/hyperindex --skill envio-cloud-cli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: envio-cloud-cli
Source: https://github.com/enviodev/hyperindex/tree/main/packages/cli/templates/static/shared/.claude/skills/envio-cloud-cli
Command: npx skills add https://github.com/enviodev/hyperindex --skill envio-cloud-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Deploying and monitoring hosted blockchain indexers on Envio cloud requires many manual steps across auth, configuration, deployments, and log inspection. This Skill provides the complete envio-cloud CLI command reference so you can manage the entire hosted indexer lifecycle from a terminal, CI/CD pipeline, or script.

Core Features & Use Cases

  • Authentication & Context: Log in via browser or GitHub token for CI/CD, and set default org/indexer context to avoid repeating flags.
  • Indexer & Deployment Management: Create indexers, configure settings and ENVIO_-prefixed env vars, deploy commits, promote to production, and restart or delete deployments.
  • Observability & Scripting: Stream build/runtime logs, watch sync status and metrics, fetch GraphQL endpoints, and consume JSON output with defined exit codes for automation.
  • Use Case: In a CI pipeline, authenticate with ENVIO_GITHUB_TOKEN, trigger a deployment for a commit, watch until synced with --watch-till-synced, then promote it to production.

Quick Start

Ask the AI to deploy your indexer to Envio cloud and watch the deployment logs until it finishes syncing.

Frequently Asked Questions about envio-cloud-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy a HyperIndex indexer to Envio cloud from the terminal?

Use the envio-cloud CLI via npx envio-cloud. After logging in and adding an indexer with envio-cloud indexer add, deployments are tracked per commit, and you can check status with envio-cloud deployment status <indexer> <commit>.

How do I authenticate envio-cloud in a CI/CD pipeline?

Use envio-cloud login --token <github-token> or set the ENVIO_GITHUB_TOKEN environment variable. The GitHub token needs read:org, read:user, and user:email scopes, avoiding interactive browser login in CI.

How do I view logs for a hosted Envio indexer deployment?

Run envio-cloud deployment logs <indexer> <commit> to fetch logs. Add --build for build logs, --level error,warn to filter severity, and --follow to stream logs continuously.

Can I set environment variables for a hosted Envio indexer?

Yes, use envio-cloud indexer env list, set, delete, or import for the indexer. All keys must use the ENVIO_ prefix, and changes take effect on the next deployment.

Why can't I restart my Envio indexer deployment immediately?

The envio-cloud deployment restart command enforces a 10-minute cooldown between restarts. Wait for the cooldown to elapse before issuing another restart with the --yes confirmation flag.