RudraX - Build Break Deploy 🚀

RudraX is an interactive terminal-based AI coding agent that helps developers build, break, and deploy applications through natural language commands. Built on top of Mario Zechner's pi-coding-agent framework.

✨ Features

• 🤖 AI-Powered Coding - Natural language to code generation
• 🎨 Interactive TUI - Beautiful terminal interface
• 🔧 Multi-Provider Support - OpenAI, Anthropic, Google Gemini, AWS Bedrock, Ollama
• 📦 Extension System - Extensible agents, squads, and workflows
• 💻 Cross-Platform - Works on Linux, macOS, Windows (WSL/Termux)

📦 Installation

# Install globally
npm install -g rudrax

# Or from source
git clone https://github.com/lalitpandit/rudrax.git
cd rudrax
npm install
npm run install-global

🚀 Quick Start

# Start RudraX
rudrax

# Or with npx
npx rudrax

🛠️ Configuration

Create a .env file or set environment variables:

# OpenAI
OPENAI_API_KEY=sk-...

# Anthropic
ANTHROPIC_API_KEY=sk-ant-...

# Google Gemini
GOOGLE_API_KEY=AIza...

Or use built-in OAuth login:

rudrax login openai
rudrax login anthropic

📚 Documentation

• Getting Started
• Keybindings
• TUI Components
• Extensions
• Custom Providers
• Settings

🏗️ Architecture

rudrax/
├── lib/           # Core application
│   ├── main.js    # Entry point
│   ├── cli.js     # CLI commands
│   ├── config.js  # Configuration
│   └── core/      # Core modules
│       ├── extensions/   # Extension system
│       ├── modes/        # TUI modes
│       └── utils/        # Utilities
├── bin/           # Executables
├── docs/          # Documentation
└── .rudrax/       # Runtime config

🔌 Available Extensions

AI Operating Systems

• RudraX AIOS - AI Operating System for autonomous task execution

Squads (Multi-Agent Teams)

• team-all - Full development squad
• team-fullstack - Web fullstack team
• team-ide-minimal - Minimal IDE squad
• team-no-ui - Backend only squad
• team-qa-focused - QA focused team

Workflows

• greenfield-service - New service development
• brownfield-service - Existing service enhancement
• brownfield-ui - UI development workflow
• qa-loop - Quality assurance cycle
• spec-pipeline - Specification-driven development

⌨️ Keybindings

| Key | Action | |-----|--------| | Ctrl+C | Cancel current operation | | Ctrl+G | Toggle grid mode | | Ctrl+L | Toggle list mode | | Ctrl+O | Open file | | Ctrl+S | Save/Search | | Tab | Auto-complete | | Esc | Close popup/Cancel |

📄 License

MIT License - Based on Mario Zechner's @mariozechner/pi-coding-agent (AGPL-3.0)

🙏 Acknowledgments

• Mario Zechner - Original pi-coding-agent framework
• Contributors - Who make RudraX better