Autonoma CLI - AI-powered autonomous development agents for BUILD, OPERATE, GOVERN, OPTIMIZE, and EVOLVE domains
npm install @autonoma-io/cliA comprehensive command-line interface for managing the Autonoma platform with 100+ admin capabilities, verification-first agent infrastructure, and complete platform control.
#### ๐ Authentication & Security
- Google OAuth 2.0 integration
- Admin-only access (admin@theautonoma.io)
- 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
bash
npm install -g @autonoma/agent-cli
`$3
`html
`$3
`bash
git clone https://github.com/autonoma/agent-cli.git
cd agent-cli
npm install
npm run build
npm link
`๐ง Configuration
$3
`bash
First-time setup
autonoma initLogin with Google OAuth (admin@theautonoma.io only)
autonoma auth loginConfigure theme
autonoma theme set darkCheck system health
autonoma doctor
`$3
`bash
export AUTONOMA_API_URL="https://api.theautonoma.io"
export AUTONOMA_AUTH_DOMAIN="theautonoma.io"
export SENDGRID_API_KEY="your-sendgrid-key"
`๐ Command Reference
$3
`bash
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
`$3
`bash
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
`$3
`bash
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
`$3
`bash
autonoma agent create --type verification # Create verification agent
autonoma agent list # List all agents
autonoma agent status # Check agent status
autonoma agent deploy # Deploy agent
autonoma agent metrics # View agent metrics
`$3
`bash
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
`$3
`bash
autonoma analytics dashboard # View dashboard
autonoma analytics engagement # Engagement metrics
autonoma analytics conversion # Conversion tracking
autonoma analytics export # Export analytics
`$3
`bash
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:
$3
`javascript
// OLD: Assumes task is complete
async function deployCode() {
await build();
await deploy();
return "Deployed successfully"; // Assumption!
}
`$3
`javascript
// 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
$3
- Dark Mode (Default): Optimized for terminal use
- Light Mode: High contrast for bright environments
- Auto Mode: Follows system preferences$3
`bash
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
$3
- 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$3
- Negative: Address pain points
- Emotional: Connect with fears and aspirations
- Pain: Highlight current problems
- Questions: Ask thought-provoking questions๐งช Testing
$3
`bash
npm test # Run all tests
npm test -- --coverage # Run with coverage
npm test -- --watch # Watch mode
`$3
- Unit tests: 78%+ coverage
- Integration tests: Complete OAuth flow
- E2E tests: Full CLI command testing๐ Deployment
$3
`bash
npm run build # TypeScript compilation
npm run bundle # Webpack bundling
npm run cdn:build # CDN distribution
`$3
`bash
npm run prepublishOnly # Build and test
npm publish --access public # Publish to NPM
`$3
`bash
npm run cdn:deploy # Deploy to CDN
`๐ API Documentation
$3
`typescript
import { CLI } from '@autonoma/agent-cli';const cli = new CLI({
apiUrl: 'https://api.theautonoma.io',
authDomain: 'theautonoma.io'
});
await cli.initialize();
`$3
`typescript
import { GoogleAuth } from '@autonoma/agent-cli';const auth = new GoogleAuth();
const isAuthenticated = await auth.isAuthenticated();
if (!isAuthenticated) {
await auth.login();
}
`$3
`typescript
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`)MIT License - see LICENSE file for details
- Documentation: https://docs.theautonoma.io
- Issues: https://github.com/autonoma/agent-cli/issues
- Email: support@theautonoma.io
- Discord: https://discord.gg/autonoma
Built with โค๏ธ by the Autonoma team
CEO & Founder: Chris Rivers
---
The Autonomous Platform That Runs Your SDLC
Visit us at theautonoma.io