Autonoma CLI Documentation

Build and deploy applications from the command line with natural language

Installation

Install via npm

npm install -g @autonoma/cli

Install via yarn

yarn global add @autonoma/cli

Verify installation

autonoma --version

Authentication

Before using the CLI, you need to authenticate with your Autonoma account.

Login with API key

autonoma auth login --api-key YOUR_API_KEY

Get your API key from app.theautonoma.io after signing up.

Interactive login

autonoma auth login

Opens a browser for secure authentication.

Basic Commands

Create a new application

autonoma create "Build a task management app with user authentication"

Generates complete application code from natural language description.

Build from requirements file

autonoma build -f requirements.md

Builds application from detailed requirements in a markdown file.

Deploy to cloud

autonoma deploy --provider aws --region us-east-1

Deploys your application to the specified cloud provider.

Advanced Usage

Interactive mode

autonoma create --interactive

Starts an interactive session where you can refine requirements with AI assistance.

Specify technology stack

autonoma create "E-commerce platform" \
  --frontend react \
  --backend node \
  --database postgres \
  --auth oauth2

Generate specific components

autonoma generate component "User profile page with edit functionality"

Project Commands

Command	Description
`autonoma status`	Show current project status and build progress
`autonoma test`	Run generated tests
`autonoma optimize`	Optimize code for performance
`autonoma security-scan`	Run security vulnerability scan
`autonoma logs`	View deployment logs

CI/CD Integration

GitHub Actions

name: Deploy with Autonoma
on:
  push:
    branches: [main]

jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Install Autonoma CLI
        run: npm install -g @autonoma/cli
      - name: Deploy
        run: autonoma deploy --provider aws
        env:
          AUTONOMA_API_KEY: ${{ secrets.AUTONOMA_API_KEY }}

GitLab CI

deploy:
  stage: deploy
  script:
    - npm install -g @autonoma/cli
    - autonoma deploy --provider gcp
  variables:
    AUTONOMA_API_KEY: $AUTONOMA_API_KEY
  only:
    - main

Configuration

Create an autonoma.config.json file in your project root:

{
  "project": {
    "name": "my-app",
    "version": "1.0.0",
    "description": "Task management application"
  },
  "build": {
    "framework": "react",
    "language": "typescript",
    "outputDir": "./dist"
  },
  "deploy": {
    "provider": "aws",
    "region": "us-east-1",
    "scaling": {
      "min": 1,
      "max": 10,
      "targetCPU": 70
    }
  },
  "features": {
    "monitoring": true,
    "logging": true,
    "security": "enhanced"
  }
}

Deployment Providers

AWS

• EC2, Lambda, ECS
• Auto-scaling configured
• CloudFormation templates

Google Cloud

• Compute Engine, Cloud Run
• Kubernetes Engine
• Automatic load balancing

Azure

• App Service, Functions
• Container Instances
• ARM templates

DigitalOcean

• Droplets, App Platform
• Kubernetes
• Managed databases

Troubleshooting

Common Issues

Authentication failed

Ensure your API key is valid and has not expired. Run autonoma auth status to check.

Build timeout

Complex applications may take longer. Use --timeout 300 to increase timeout.

Deployment failed

Check cloud provider credentials and permissions. Run autonoma deploy --validate to test configuration.

For additional help, run autonoma help [command] or visit our documentation.

Ready to Build?

Start building your first application with Autonoma CLI

Get Started Free View Examples