Skip to main content

CLI

The asterai CLI is the primary tool for building, publishing, and running components and environments.

Installation

npm install -g @asterai/cli

Authentication

asterai auth login <api-key>    # Authenticate to the registry
asterai auth logout             # Clear authentication
asterai auth status             # Show current auth status

Component Commands

asterai component init [name] [-l <language>]    # Scaffold a new component project
asterai component build                          # Build the component (from project dir)
asterai component pkg                            # Package the component's WIT into a WASM package
asterai component push                           # Push component to the registry (from project dir)
asterai component pull <name>                    # Pull a component from the registry
asterai component list                           # List your components
asterai component delete <namespace:name>        # Delete a component and all its versions

Environment Commands

asterai env init <name> [-e]                     # Create a new environment (-e to edit)
asterai env edit <name>                          # Open environment in editor ($EDITOR or vi)
asterai env call <name> <component> <fn> [args]  # Call a function
asterai env push <name>                          # Push environment to registry
asterai env pull <name>                          # Pull environment from registry
asterai env list                                 # List your environments
asterai env inspect <name>                       # Show environment details
asterai env add-component <env> <component>      # Add a component
asterai env remove-component <env> <component>   # Remove a component
asterai env set-var <name> --var NAME=VALUE       # Set environment variable
asterai env delete <namespace:name>              # Delete an environment (-r for registry)

☁️ Cloud Console

The cloud console provides a web interface for managing your asterai resources:
  • 📦 Environments: Create, configure, and monitor environments
  • 🧩 Components: View your published components and their versions
  • 🔑 Secrets: Manage environment variables and API keys
  • 📊 Usage: Track execution metrics and costs

👉 Next Steps