CLI AI Apps

Manage the full lifecycle of Python AI applications with yeero app — from creation and code generation to running, versioning, and rollback.

Overview

Subcommand	Description
`app create`	Create a new app (cloud registration + local init)
`app list`	List all apps and their status
`app show`	Show app details
`app save`	Save local file as a new version
`app versions`	List version history
`app version-show`	Show details of a specific version
`app rollback`	Roll back to a previous version
`app generate`	AI single-turn code generation
`app discuss`	AI multi-turn REPL discussion
`app run`	Run application locally
`app stop`	Stop a running application
`app uninstall`	Uninstall (remove script and venv)

Create an App

yeero app create --name "Data Analyst" --description "Analyze CSV data and generate reports"

AI Code Generation

# Single-turn generation
yeero app generate my-app --prompt "Add data visualization with line charts"

# Specify edit mode
yeero app generate my-app --prompt "Optimize performance" --mode patch

# Specify reasoning effort
yeero app generate my-app --prompt "Refactor code structure" --effort high

Option	Default	Description
`--prompt <TEXT>`	interactive	Generation instruction
`--mode`	`auto`	Edit mode: `auto` \| `full` \| `patch`
`--effort`	`medium`	Reasoning effort: `minimal` \| `low` \| `medium` \| `high` \| `xhigh`
`--model <ID>`	app config	Override model

Multi-turn Discussion

yeero app discuss my-app
yeero app discuss my-app --model claude-3-5-sonnet --effort high

Enters a multi-turn REPL. The AI reads the current code and iterates with you. Type /exit or press Ctrl+C to quit.

Run & Stop

# Run an app
yeero app run my-app

# Run with initial input (JSON)
yeero app run my-app --input '{"query": "sales last 30 days"}'

# Stop a running app
yeero app stop <run-id>

💡 Auto dependency install

On first run, the CLI automatically creates an isolated Python virtual environment and installs required dependencies.

Version Control

# Save current local file as new version
yeero app save my-app --file ./app.py --change-summary "Added visualization"

# List version history
yeero app versions my-app

# View a specific version
yeero app version-show <version-id>

Rollback

# Interactive selection (with confirmation prompt)
yeero app rollback my-app

# Roll back to a specific version
yeero app rollback my-app --version <version-id> -y

Uninstall

# Uninstall a single app
yeero app uninstall my-app -y

# Uninstall all locally installed apps
yeero app uninstall --all -y