CLI Commands

Complete reference for all DevOS commands. Run devos --help to see this list in your terminal.

Project Commands

devos init [description]

Initialize a new project with AI-generated scaffolding.

devos init "Express API with PostgreSQL and JWT auth"
devos init "React dashboard with charts"
Flags: --template --no-install

devos run [script]

Run the project with auto-detection and error recovery.

devos run           # Auto-detect entry point
devos run dev       # Run dev script
devos run test      # Run tests
Flags: --auto-fix --watch

devos goal <description>

Full autopilot — plan, code, test, debug, and deploy from a single description.

devos goal "Build a Twitter clone with auth and deploy to Vercel"
Flags: --max-iterations --no-deploy --dry-run

devos auto

Auto-debugging loop. Runs your project, catches errors, and fixes them automatically.

devos auto           # 10 iterations by default
devos auto --max 20  # Custom max iterations

Development Commands

devos edit <file> <instruction>

AI-powered file editing with natural language.

devos edit server.js "Add rate limiting middleware"
devos edit App.jsx "Add a dark mode toggle"

devos test [file]

Generate and run tests.

devos test                 # Run all tests
devos test --generate      # Generate tests for all files
devos test api/users.js    # Test specific file

devos refactor [glob]

AI-powered code refactoring with quality analysis.

devos refactor src/**/*.js
devos refactor --suggestions

devos explain [file]

Get AI explanations of code or error messages.

devos explain server.js
devos explain "TypeError: Cannot read property 'id' of undefined"

devos find <query>

Natural language code search powered by RAG.

devos find "authentication logic"
devos find "where is the database connection configured"

devos watch

Watch for file changes and auto-rebuild.

devos watch

devos shell

Interactive AI shell for natural language commands.

devos shell
# > add a login page
# > fix the failing tests
# > deploy to production

AI & Model Commands

devos model <action>

Manage AI models and providers.

devos model list           # Show all models
devos model use gpt-4o     # Set default model
devos model auto           # Enable smart routing
devos model add ollama     # Add local provider

devos config <action>

Manage DevOS configuration.

devos config set KEY=value
devos config list
devos config reset

devos cost

View AI usage costs and token consumption.

devos cost             # Show total spend
devos cost --reset     # Reset counters

Deployment Commands

devos deploy [target]

Deploy to any platform with auto-detection.

devos deploy                  # Auto-detect platform
devos deploy --target=vercel
devos deploy --target=railway
devos deploy --target=fly
devos deploy --target=docker

devos rollback [version]

Rollback to a previous deployment.

devos rollback          # Rollback to previous
devos rollback v1.2.3   # Rollback to specific version

devos env <action>

Manage environment variables.

devos env list
devos env set DATABASE_URL=postgres://...
devos env sync  # Sync to deployment platform

Monitoring Commands

devos monitor [url]

Monitor application health with auto-healing.

devos monitor https://my-app.vercel.app
devos monitor --interval 30

devos status

Show project and deployment status.

devos logs [service]

View application logs from any deployment.

Tool Commands

devos security

Scan project for security vulnerabilities.

devos security             # Full scan
devos security --fix       # Auto-fix issues

devos migrate <target>

AI-powered migration between frameworks and languages.

devos migrate react         # Migrate to React
devos migrate typescript    # Convert JS to TS