Autonoma CLI v2.0

The Autonomous Platform That Runs Your SDLC

A comprehensive command-line interface for managing the Autonoma platform with 100+ admin capabilities, verification-first agent infrastructure, and complete platform control.

🚀 Features

Core Capabilities

• 100+ Admin Commands: Complete platform control through CLI
• Verification-First Architecture: Multi-layer verification replacing assumption-based approaches
• Google OAuth Authentication: Secure admin access ([email protected])
• Theme System: Light/dark/auto modes with comprehensive theming
• Interactive Prompts: Claude Code-style contextual guidance
• AIDA-NEPQ Framework: Advanced email campaign management
• Real-time Analytics: Platform metrics and insights

Key Components

🔐 Authentication & Security

• Google OAuth 2.0 integration
• Admin-only access ([email protected])
• Secure token storage with 0600 permissions
• Automatic token refresh
• Session management

🎨 User Experience

• Interactive onboarding similar to Claude Code
• Contextual tips and guided tours
• Light/dark theme modes
• Progress indicators and spinners
• Dangerous operation confirmations

📧 Email Campaign Management

• AIDA-NEPQ psychological profiling
• 97+ dynamic templates
• Tier-based targeting
• Engagement tracking
• SendGrid integration

🤖 Agent Infrastructure

• Verification-first agents
• Multi-layer validation
• Competence tracking
• Conversation memory
• Tool integration

📦 Installation

NPM Package

npm install -g @autonoma/agent-cli

CDN Distribution

<script src="https://cdn.jsdelivr.net/npm/@autonoma/[email protected]/dist/bundle.min.js"></script>

From Source

git clone https://github.com/autonoma/agent-cli.git
cd agent-cli
npm install
npm run build
npm link

🔧 Configuration

Initial Setup

# First-time setup
autonoma init

# Login with Google OAuth ([email protected] only)
autonoma auth login

# Configure theme
autonoma theme set dark

# Check system health
autonoma doctor

Environment Variables

export AUTONOMA_API_URL="https://api.theautonoma.io"
export AUTONOMA_AUTH_DOMAIN="theautonoma.io"
export SENDGRID_API_KEY="your-sendgrid-key"

📚 Command Reference

Authentication

autonoma auth login          # Login with Google OAuth
autonoma auth logout         # Logout and clear credentials
autonoma auth status         # Check authentication status
autonoma auth refresh        # Refresh access token

Alpha Program Management

autonoma alpha stats                    # View program statistics
autonoma alpha contacts --tier 1        # List contacts by tier
autonoma alpha engagement                # View engagement metrics
autonoma alpha export --format csv      # Export data
autonoma alpha aida-report               # AIDA progression report

Email Campaigns

autonoma campaign create                 # Create new campaign
autonoma campaign send --tier 2          # Send to specific tier
autonoma campaign status                 # View campaign status
autonoma campaign metrics                # View performance metrics
autonoma campaign templates              # Manage templates

Agent Management

autonoma agent create --type verification # Create verification agent
autonoma agent list                      # List all agents
autonoma agent status <id>               # Check agent status
autonoma agent deploy <id>               # Deploy agent
autonoma agent metrics <id>              # View agent metrics

Platform Administration

autonoma admin users                     # Manage users
autonoma admin database                  # Database operations
autonoma admin logs                      # View system logs
autonoma admin health                    # Health checks
autonoma admin config                    # Configuration management

Analytics & Reporting

autonoma analytics dashboard             # View dashboard
autonoma analytics engagement            # Engagement metrics
autonoma analytics conversion            # Conversion tracking
autonoma analytics export                # Export analytics

Development Tools

autonoma dev server                      # Start dev server
autonoma dev build                       # Build project
autonoma dev test                        # Run tests
autonoma dev deploy                      # Deploy to production

🎯 Verification-First Architecture

The CLI implements a revolutionary verification-first approach:

Traditional (Assumption-Based)

// OLD: Assumes task is complete
async function deployCode() {
  await build();
  await deploy();
  return "Deployed successfully"; // Assumption!
}

Verification-First

// NEW: Verifies at every step
async function deployCode() {
  const buildResult = await build();
  if (!await verifyBuild(buildResult)) {
    return { error: "Build verification failed" };
  }
  
  const deployResult = await deploy();
  if (!await verifyDeployment(deployResult)) {
    return { error: "Deployment verification failed" };
  }
  
  const healthCheck = await checkHealth();
  return { 
    success: true, 
    verified: true,
    evidence: { buildResult, deployResult, healthCheck }
  };
}

🌈 Theme Customization

Available Themes

• Dark Mode (Default): Optimized for terminal use
• Light Mode: High contrast for bright environments
• Auto Mode: Follows system preferences

Theme Commands

autonoma theme set dark      # Set dark theme
autonoma theme set light     # Set light theme
autonoma theme set auto      # Auto-detect theme
autonoma theme current       # Show current theme

📊 AIDA-NEPQ Framework

AIDA Stages

• Attention: Grab attention with provocative messaging
• Interest: Build interest with value propositions
• Desire: Create desire with case studies and ROI
• Action: Drive action with clear CTAs

NEPQ Psychological Triggers

• Negative: Address pain points
• Emotional: Connect with fears and aspirations
• Pain: Highlight current problems
• Questions: Ask thought-provoking questions

🧪 Testing

Run Tests

npm test                     # Run all tests
npm test -- --coverage       # Run with coverage
npm test -- --watch          # Watch mode

Test Coverage

• Unit tests: 78%+ coverage
• Integration tests: Complete OAuth flow
• E2E tests: Full CLI command testing

🚀 Deployment

Build for Production

npm run build               # TypeScript compilation
npm run bundle              # Webpack bundling
npm run cdn:build           # CDN distribution

Publish to NPM

npm run prepublishOnly      # Build and test
npm publish --access public # Publish to NPM

Deploy to CDN

npm run cdn:deploy          # Deploy to CDN

📖 API Documentation

CLI Class

import { CLI } from '@autonoma/agent-cli';

const cli = new CLI({
  apiUrl: 'https://api.theautonoma.io',
  authDomain: 'theautonoma.io'
});

await cli.initialize();

Authentication

import { GoogleAuth } from '@autonoma/agent-cli';

const auth = new GoogleAuth();
const isAuthenticated = await auth.isAuthenticated();

if (!isAuthenticated) {
  await auth.login();
}

Theme Manager

import { theme } from '@autonoma/agent-cli';

theme.setTheme('dark');
console.log(theme.primary('Hello World'));

🤝 Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📄 License

MIT License - see LICENSE file for details

🆘 Support

• Documentation: https://docs.theautonoma.io
• Issues: https://github.com/autonoma/agent-cli/issues
• Email: [email protected]
• Discord: https://discord.gg/autonoma

🎯 Roadmap

Q4 2025

• [ ] AI-powered command suggestions
• [ ] Multi-tenant support
• [ ] Advanced analytics dashboard
• [ ] Plugin system

Q1 2026

• [ ] Mobile companion app
• [ ] Voice commands
• [ ] Automated workflows
• [ ] Enterprise features

🏆 Credits

Built with ❤️ by the Autonoma team

CEO & Founder: Chris Rivers

The Autonomous Platform That Runs Your SDLC

Visit us at theautonoma.io