Giga-Claude CLI

Command-line interface for Giga-Claude workflow orchestration.

Installation

pnpm install -g @zdql/giga-claude-cli

Or use directly from the monorepo:

cd src/packages/cli
pnpm run build
node dist/index.js

Quick Start

1. Configure the CLI

giga config set baseUrl http://localhost:3000

2. Validate your workflow

giga workflow validate \
  --data ./states.csv \
  --prompt ./prompt.txt \
  --key-field "abbreviation"

3. Create a workflow

giga workflow create \
  --data ./states.csv \
  --prompt ./prompt.txt \
  --key-field "abbreviation" \
  --tools "Bash,Read,Write,WebSearch" \
  --concurrency 5 \
  --name "State Enrichment"

4. Run the workflow

# Dry run first
giga workflow run 42 --first 5 --dry-run

# Actually run
giga workflow run 42 --first 5

# Run all remaining
giga workflow run 42 --all

5. Monitor progress

# Summary
giga workflow status 42

# Detailed with all runs
giga workflow status 42 --runs

# Filter by status
giga workflow status 42 --runs --filter completed

6. Download artifacts

# List all artifacts
giga workflow artifacts 42

# Download all
giga workflow artifacts 42 --download ./output/

# View specific artifact
giga workflow artifacts 42 --entity CA --cat

Commands

Configuration

• giga config set <key> <value> - Set configuration value
• giga config list - List all configuration

Workflow Management

• giga workflow create - Create new workflow from files
• giga workflow validate - Validate without creating
• giga workflow run <id> - Start batch of runs
• giga workflow status <id> - Check progress
• giga workflow pause <id> - Pause execution
• giga workflow resume <id> - Resume paused workflow
• giga workflow cancel <id> - Cancel running jobs
• giga workflow artifacts <id> - Manage artifacts

Full API Parity

The CLI uses the @zdql/giga-claude-client package for all API calls, ensuring full parity between programmatic and CLI usage.

Example: State Enrichment

# 1. Configure
giga config set baseUrl http://localhost:3000

# 2. Create workflow
giga workflow create \
  --data ./states.csv \
  --prompt ./prompt.txt \
  --key-field "abbreviation" \
  --concurrency 3 \
  --name "State Capital Enrichment"

# 3. Test with first 2 states
giga workflow run 42 --first 2

# 4. Check status
giga workflow status 42

# 5. If good, run all
giga workflow run 42 --all

# 6. Download results
giga workflow artifacts 42 --download ./output/

Architecture

CLI Commands
    ↓
@zdql/giga-claude-client (API SDK)
    ↓
Giga-Claude Server (API)

All workflow operations go through the client SDK, ensuring consistency and type safety.