Documentation Index
Fetch the complete documentation index at: https://mintlify.com/hypertekorg/hyperstack/llms.txt
Use this file to discover all available pages before exploring further.
CLI Overview
The Hyperstack CLI (hs) is a command-line tool for building, deploying, and managing HyperStack stream stacks. It provides a complete workflow from project creation to production deployment.
Installation
See the Installation guide for platform-specific instructions.Core Workflow
The typical development workflow with the Hyperstack CLI:-
Create a new project from a template
-
Initialize configuration if starting from an existing project
-
Deploy your stack to production
-
Generate SDKs for client applications
Command Categories
Project Management
hs create- Create a new project from a templatehs init- Initialize configuration for an existing project
Deployment
hs up- Deploy a stack (push + build + deploy)hs push- Push local stacks to remote (alias forhs stack push)hs status- Show overview of stacks, builds, and deployments
Stack Management
hs stack- Manage deployed stacks (list, show, delete, rollback, stop)hs explore- Discover stacks and explore their schemas
SDK Generation
hs sdk- Generate TypeScript and Rust SDKs
Build Management (Advanced)
hs build- Low-level build management (hidden from help)
Configuration & Authentication
hs auth- Login, logout, check authentication statushs config- Validate configuration files
Global Flags
All commands support these global flags:Path to the hyperstack.toml configuration file
Output in JSON format for machine-readable output
Enable verbose output for debugging
Generate shell completions for bash, zsh, fish, powershell, or elvish
Configuration File
The CLI useshyperstack.toml to define stacks, deployment settings, and SDK configuration:
hyperstack.toml
Return Codes
The CLI uses standard Unix return codes:0- Success1- Error (with error message printed to stderr)
Telemetry
The CLI collects anonymous usage telemetry to help improve the product. You can:- View telemetry status:
hs telemetry status - Opt out:
hs telemetry disable - Opt in:
hs telemetry enable