resq-cli 0.2.1

Developer CLI for the ResQ autonomous drone platform
Documentation

resq — Developer CLI

Rust developer tooling CLI for the ResQ monorepo. Handles license headers, image placeholders, security audits, dependency cost analysis, secret scanning, and provides a suite of TUI explorers for logs, performance, health, and deployments.

Build & Install

# Build from workspace root
cargo build --release -p resq-cli

# Optional: install globally
cargo install --path cli

Binary: target/release/resq

Commands

copyright — License Header Management

Adds or checks copyright headers across every source file in the repo.

Supported formats: C-style block (/** */), XML/HTML (<!-- -->), hash-line (#), double-dash (--), Elisp (;;), AsciiDoc (////). Shebangs (#!/...) are always preserved at line 0.

Licenses: mit (default), apache-2.0, gpl-3.0, bsd-3-clause

# Check all tracked files (CI — exits 1 if any missing)
resq copyright --check

# Preview what would be added without writing
resq copyright --dry-run

# Add headers to all files missing them
resq copyright

# Overwrite existing headers (e.g. change license or author)
resq copyright --force --license apache-2.0 --author "Acme Corp" --year 2026

lqip — Low-Quality Image Placeholders

Generates tiny base64-encoded data URIs from images for use as blur-up placeholders in the web dashboard.

# Single image → prints data URI
resq lqip --target services/web-dashboard/public/hero.jpg

# Directory of images → text list
resq lqip --target services/web-dashboard/public/

# Recursive with JSON output (for import into JS)
resq lqip --target services/web-dashboard/public/ --recursive --format json

audit — Security & Quality Audit

Three-pass security and quality sweep covering all language ecosystems in the monorepo. Runs OSV Scanner (cross-ecosystem), npm audit-ci, and React Doctor.

# Full audit (all three passes)
resq audit

# Run only the OSV Scanner pass
resq audit --skip-npm --skip-react

cost — Dependency Size Analysis

Fetches package sizes from registries (npm, crates.io, PyPI) and categorizes dependencies by download footprint.

# Auto-detect project type and analyze
resq cost

# Specific project
resq cost --root services/coordination-hce

secrets — Secret Scanner

Scans source files for hardcoded credentials, API keys, private keys, tokens, and high-entropy strings.

# Scan all git-tracked files (default)
resq secrets

# Only scan staged changes (pre-commit hook)
resq secrets --staged

tree-shake — TypeScript Dead Code Removal

Runs tsr to remove unused TypeScript exports from the project entry points.

resq tree-shake

dev — Development Utilities

Unified entry point for repository-level development tasks.

# List all development scripts
resq dev --list

# Run a specific developer workflow
resq dev run setup-env

explore — Performance Monitor (TUI)

Launches the resq-perf TUI to monitor live CPU usage, memory consumption, and request metrics for ResQ services (primarily coordination-hce).

# Launch the performance explorer
resq explore

Dedicated TUI shortcuts are also available:

  • resq logs — Multi-source log aggregator (launches resq-logs)
  • resq health — Service health dashboard (launches resq-health)
  • resq deploy — Docker/K8s deployment manager (launches resq-deploy)
  • resq clean — Visual workspace cleaner (launches resq-clean)
  • resq asm — Machine code & binary analyzer (launches resq-bin)

pre-commit — Unified Hook

Runs a suite of checks suitable for a git pre-commit hook: copyright headers, secret scanning, and basic audits.

resq pre-commit

version — Monorepo Versioning

Manages package versions and changesets across the monorepo.

# Check version status
resq version status

# Bump versions based on changesets
resq version bump

docs — Documentation Export

Manages documentation generation, export, and publication for the monorepo.

# Export all documentation to HTML/PDF
resq docs export --format html