CLI Reference
The Vorte CLI provides 30+ commands for project management, code generation, database operations, AI tasks, M-Pesa integration, and DevOps workflows. All commands are accessible through the vorte binary after installation.
Global Options
| Flag | Description |
|---|---|
--help | Show help for any command |
--version | Print the Vorte CLI version |
--verbose | Enable verbose output |
--config <path> | Specify a custom config file |
--env <name> | Set the environment (development, staging, production) |
Project Commands
| Command | Description |
|---|---|
vorte new <name> | Create a new Vorte project |
vorte serve | Start the development server |
vorte doctor | Check environment and dependencies |
vorte info | Display project and framework information |
vorte version | Print the Vorte framework version |
terminal
bash
Copied!
Generator Commands
| Command | Description |
|---|---|
vorte generate module <name> | Scaffold a new module |
vorte generate model <name> | Generate a SQLAlchemy model |
vorte generate router <name> | Generate an API router with CRUD endpoints |
vorte generate schema <name> | Generate Pydantic schemas |
vorte generate service <name> | Generate a service class with DI |
vorte generate middleware <name> | Generate a middleware class |
vorte generate test <name> | Generate a test file |
vorte generate scaffold <name> | Generate model, schema, router, and service together |
terminal
bash
Copied!
Database Commands
| Command | Description |
|---|---|
vorte db init | Initialize migration directory |
vorte db migrate -m <msg> | Generate a new migration |
vorte db upgrade | Apply pending migrations |
vorte db downgrade | Rollback the last migration |
vorte db history | Show migration history |
vorte db current | Show current migration version |
vorte db seed | Run seed scripts |
vorte db reset | Drop and recreate all tables |
terminal
bash
Copied!
AI Commands
| Command | Description |
|---|---|
vorte ai providers | List configured AI providers and status |
vorte ai models | List available models per provider |
vorte ai test <provider> | Test connectivity to a provider |
vorte ai complete <prompt> | Run a completion from the CLI |
vorte ai embed <text> | Generate embeddings for text |
vorte ai agent run <name> | Run a named agent interactively |
vorte ai agent list | List registered agents |
example.py
python
Copied!
M-Pesa Commands
| Command | Description |
|---|---|
vorte mpesa stk-push | Initiate an STK push request |
vorte mpesa query <id> | Query transaction status |
vorte mpesa balance | Check account balance |
vorte mpesa reversal | Initiate a transaction reversal |
DevOps Commands
| Command | Description |
|---|---|
vorte dockerfile | Generate a Dockerfile for the project |
vorte docker-compose | Generate a docker-compose.yml |
vorte k8s | Generate Kubernetes manifests |
vorte deploy | Deploy to the configured platform |
vorte health | Check application health endpoints |
terminal
bash
Copied!
Manifest Commands
| Command | Description |
|---|---|
vorte manifest build | Build the application manifest |
vorte manifest validate | Validate the manifest against the schema |
vorte manifest diff | Show diff between current and previous manifest |
vorte manifest export | Export the manifest to JSON or YAML |