CLI Reference

This page describes the current @cig-technology/cli foundation release as it exists in the repository today.

Purpose

The CLI is the bootstrap and operator surface for CIG. It is responsible for:

It is not the persistent graph-maintenance process. That responsibility is intended to move into cig-node.

Install from npm:

npm install -g @cig-technology/cli

Or run with npx:

npx @cig-technology/cli login --api-url https://app.cig.lat

For first-time onboarding, use the interactive setup wizard:

cig setup

Or run the public bash installer:

curl -fsSL https://cig.lat/install.sh | bash

device authorization login
enrollment request against the API
local node key generation
managed connection-profile storage
staging of runtime bundle assets into the local install directory
initial graph snapshot capture during install, with upload when auth is available

bootstrap token generation
compose manifest generation
local docker compose up -d
health polling against the local stack
local install-state persistence
initial graph snapshot capture during install, with queued upload once local auth exists

The CLI package has package-local versioning integration for maintainers:

cd packages/cli
npm run version:status
npm run version:validate
npm run version:update-readme
npm run version:bump:patch

scripts/release.sh wraps this flow and keeps the public tag format as cli-vx.y.z.

Default locations: