AutoAgent CLI

AI-powered development automation that processes tickets, implements features, and manages deployments - all from your terminal.

🚀 Installation

Homebrew (Recommended for macOS/Linux)

brew tap autoagent/tap
brew install autoagent

Direct Download

Download the latest binary for your platform from GitHub Releases.

# macOS (Apple Silicon)
curl -L https://github.com/autoagent/cli/releases/latest/download/autoagent-darwin-arm64.tar.gz | tar xz
sudo mv autoagent /usr/local/bin/

# macOS (Intel)
curl -L https://github.com/autoagent/cli/releases/latest/download/autoagent-darwin-x64.tar.gz | tar xz
sudo mv autoagent /usr/local/bin/

# Linux
curl -L https://github.com/autoagent/cli/releases/latest/download/autoagent-linux-x64.tar.gz | tar xz
sudo mv autoagent /usr/local/bin/

npm/yarn (Node.js required)

npm install -g @autoagent/cli
# or
yarn global add @autoagent/cli

🎯 Quick Start

# Initialize AutoAgent in your project
autoagent init

# Authenticate (one-time setup)
autoagent auth login

# Process a JIRA ticket
autoagent run PROJ-123

# Watch for new tickets
autoagent watch

# Ask Claude for help
autoagent claude ask "How do I optimize this database query?"

📚 Command Reference

Core Commands

autoagent init

Initialize AutoAgent in your project. Creates configuration files and sets up integrations.

autoagent init
autoagent init --force           # Reinitialize
autoagent init --template node   # Use specific template

autoagent run <ticket>

Process a single ticket or task.

autoagent run PROJ-123                    # Process JIRA ticket
autoagent run "Add user authentication"   # Process task description
autoagent run PROJ-123 --dry-run         # Preview without changes
autoagent run PROJ-123 --no-tests        # Skip test execution
autoagent run PROJ-123 --stage analyze   # Run specific stage only

autoagent watch

Monitor for new tickets and process automatically.

autoagent watch                           # Default: poll every 5 minutes
autoagent watch --interval 1              # Poll every minute
autoagent watch --auto-approve            # Don't ask for confirmation
autoagent watch --filter "priority = High" # Custom JIRA filter

Claude Integration

autoagent claude ask <prompt>

Quick questions to Claude Code.

autoagent claude ask "How do I implement OAuth?"
autoagent claude ask "Explain this error" --context error.log
autoagent claude ask "Review this code" --context src/index.js

autoagent claude session

Interactive Claude Code sessions.

autoagent claude session start            # Start interactive session
autoagent claude session list             # List active sessions
autoagent claude session end <id>         # End specific session

autoagent claude review

Request code review.

autoagent claude review                   # Review all changes
autoagent claude review src/api.js        # Review specific file
autoagent claude review --staged          # Review staged git changes
autoagent claude review --type security   # Security-focused review

Auggie Integration

AutoAgent integrates with Auggie CLI as:

• Development Team Member #2: Code review and architectural feedback
• Primary QA Team Member: Quality assurance and testing processes

Code Review (Development Team Member #2)

npm run auggie:review --mode pr           # Review PR changes
npm run auggie:review --mode code         # Review staged changes
npm run auggie:review --mode security     # Security-focused review
npm run auggie:review --focus "performance optimization"

QA Analysis (Primary QA Team Member)

npm run auggie:qa --mode pr               # PR quality analysis
npm run auggie:qa --mode branch           # Branch readiness assessment
npm run auggie:qa --mode full             # Comprehensive QA audit

Issue Triage & Management

npm run auggie:triage --mode github       # Triage GitHub issues
npm run auggie:triage --mode exceptions   # Exception analysis
npm run auggie:triage --mode alerts       # Alert response planning

Codebase Analysis

npm run auggie:analyze --mode codebase    # Full codebase analysis
npm run auggie:analyze --mode security    # Security audit
npm run auggie:analyze --mode debt        # Technical debt analysis

📖 See AUGGIE_INTEGRATION.md for complete setup and usage guide.

Security & Analysis

autoagent analyze

Analyze codebase for issues.

autoagent analyze security               # Security scan
autoagent analyze quality                # Code quality check
autoagent analyze dependencies           # Dependency audit

Deployment

autoagent deploy

Manage deployments.

autoagent deploy status                  # Check deployment status
autoagent deploy staging                 # Deploy to staging
autoagent deploy production --approve    # Deploy to production

Configuration

autoagent config

Manage configuration.

autoagent config set jira.url https://company.atlassian.net
autoagent config get jira.url
autoagent config list

autoagent auth

Authentication management.

autoagent auth login                     # Interactive login
autoagent auth login --key <api-key>     # Login with API key
autoagent auth status                    # Check auth status
autoagent auth logout                    # Clear credentials

🔧 Configuration

AutoAgent uses two configuration levels:

Project Configuration (.autoagent/config.json)

{
  "project": {
    "name": "my-app",
    "type": "node"
  },
  "integrations": {
    "jira": {
      "enabled": true,
      "url": "https://company.atlassian.net"
    },
    "claude": {
      "enabled": true,
      "model": "claude-3-sonnet"
    }
  },
  "workflows": {
    "autoRun": false,
    "requireApproval": true
  }
}

Global Configuration (~/.config/autoagent/)

• API credentials
• User preferences
• Default settings

🔐 Security

AutoAgent stores sensitive data securely:

• macOS: Keychain
• Linux: Secret Service API
• Windows: Windows Credential Manager

API keys are never stored in plain text.

🎨 Examples

Process Multiple Tickets

# Process tickets in sequence
for ticket in PROJ-123 PROJ-124 PROJ-125; do
  autoagent run $ticket
done

# Process in parallel
autoagent run PROJ-123 & 
autoagent run PROJ-124 &
autoagent run PROJ-125 &
wait

Custom Workflow

# Create custom workflow file
cat > .autoagent/workflows/custom.json << EOF
{
  "name": "custom",
  "steps": [
    { "action": "analyze", "type": "security" },
    { "action": "implement", "type": "feature" },
    { "action": "test", "type": "integration" },
    { "action": "deploy", "type": "staging" }
  ]
}
EOF

# Run with custom workflow
autoagent run PROJ-123 --workflow custom

CI/CD Integration

# GitHub Actions
- name: Run AutoAgent
  run: |
    autoagent auth login --key ${{ secrets.AUTOAGENT_KEY }}
    autoagent run ${{ github.event.issue.number }}

🤝 Contributing

See CONTRIBUTING.md for development setup and guidelines.

📝 License

MIT License - see LICENSE for details.

🔗 Links

• Documentation
• GitHub
• Discord Community
• Report Issues