AURA CLI 🚀

Agent Management • Skill Registry • Task Engine • Intelligent Execution

AURA — Autonomous Unified Resource Architecture. A powerful CLI for managing AI agents, registering skills, tracking tasks with natural language parsing, and orchestrating intelligent execution.

✨ Features

| Feature | Description | |---------|-------------| | 🤖 Agent Management | Register and list AI agents with roles (coder, designer, researcher, devops, etc.) | | 🧩 Skill Registry | Download and link skills from a built-in registry (like Smithery or MCP servers) | | 📋 Smart Tasks | Add tasks with natural language — AURA auto-detects priority and tags | | 💡 Task Suggestions | Get AI-powered task suggestions based on your registered agents and skills | | ⚡ Execution Engine | Analyze any prompt, match it against agents/skills, and dispatch intelligently | | 🔒 Private Mode | Unlock premium features with a private authentication token | | 🎨 Beautiful CLI | Color-coded output with unicode boxes, progress bars, and tables |

📦 One-Command Install

# Option 1: curl (works everywhere — no Node.js needed to download)
curl -fsSL https://raw.githubusercontent.com/mjthedeveloper-07/aura-orchestrator-cli/main/install.sh | sh

# Option 2: npm (if you prefer)
npm install -g aura-orchestrator-cli

🚀 Quick Start

# Check system status
aura status

# Register an agent
aura agent add alice --role coder

# Add a skill from the registry
aura skill add smithery/web-scraper

# Run the orchestrator (auto-saves a task too!)
aura run "build a landing page with modern design"

# Add a task with natural language
aura todo add "urgent: fix the login bug before production deploy"

# Get task suggestions based on your agents
aura todo suggest

# View your task dashboard
aura todo list

# Need help?
aura

📖 Commands

Agent Management

aura agent add <name> --role <role>     Register a new agent
aura agent list                         List all agents

Skill Management

aura skill add <registry/skill>         Download and link a skill
aura skill list                         List active skills

Task Management

aura todo                               Task dashboard
aura todo add "<description>"           Add a task (parses priority & tags)
aura todo list                          List all tasks
aura todo list --suggested              Include auto-suggested tasks
aura todo done <id>                     Mark task complete
aura todo start <id>                    Start working on a task
aura todo block <id>                    Mark task blocked
aura todo delete <id>                   Delete a task
aura todo suggest                       Get AI-powered suggestions
aura todo add-suggested                 Accept all suggestions

Execution Engine

aura run "<prompt>"                     Analyze prompt + dispatch + save as task
aura status                             Show system status

Private Features

aura private                            View private mode status
aura private list                       List all available premium features
aura private exec <feature> [args...]   Execute a premium feature

🧩 Skill Registry

AURA comes with a built-in skill catalog of 40+ skills across 8 categories:

🤖 AI / ML & Intelligence

| Registry Path | Description | |--------------|-------------| | smithery/web-scraper | Extract and parse content from any web page | | smithery/code-analyzer | Static analysis and code quality assessment | | smithery/image-generator | AI-powered image generation and editing | | smithery/llm-inference | Run local/remote LLM inference for text generation & QA | | smithery/embedding-generator | Generate text embeddings for semantic search & RAG | | smithery/speech-to-text | Transcribe audio/video with speaker diarization | | smithery/text-to-speech | Convert text to natural-sounding speech | | smithery/sentiment-analyzer | Analyze text sentiment, emotion, and tone | | smithery/recommendation-engine | Build collaborative/content-based recommendation systems | | smithery/video-generator | AI video generation from text prompts |

💾 Data / Storage / Infrastructure

| Registry Path | Description | |--------------|-------------| | mcp/filesystem | Secure file system operations | | mcp/database | SQL database query, schema, and migration | | mcp/search | Web search and information retrieval | | mcp/vector-store | Vector database for embeddings and RAG | | mcp/data-pipeline | ETL data pipeline orchestration | | mcp/cache-manager | Distributed caching with Redis | | mcp/analytics | Track metrics, build dashboards, export reports | | mcp/logging | Centralized structured logging | | mcp/monitoring | Infrastructure and application monitoring |

⚙️ Orchestrator Core

| Registry Path | Description | |--------------|-------------| | orchestrator/task-planner | Decompose complex tasks into sub-steps | | orchestrator/memory-store | Persistent key-value agent memory | | orchestrator/workflow-engine | Define, schedule, and execute DAG workflows | | orchestrator/eval-harness | Run evals, track quality, detect regressions |

🔒 Security

| Registry Path | Description | |--------------|-------------| | smithery/vulnerability-scanner | Scan dependencies for known CVEs | | smithery/secret-detector | Detect hardcoded secrets and credentials | | mcp/auth-manager | Auth, OAuth flows, API keys, permissions |

🚀 DevOps / Cloud

| Registry Path | Description | |--------------|-------------| | community/github-actions | Trigger and manage CI/CD workflows | | community/docker-manager | Build and manage Docker containers | | community/kubernetes-connector | Manage K8s clusters and deployments | | community/terraform-provider | Infrastructure as Code |

💬 Communication / Collaboration

| Registry Path | Description | |--------------|-------------| | community/slack-connector | Slack messaging and notifications | | community/discord-bot | Discord server bot integration | | community/telegram-connector | Telegram bot API integration | | community/notifications | Multi-channel notification dispatcher |

📋 Project Management

| Registry Path | Description | |--------------|-------------| | community/jira-connector | Jira issue tracking and sprint management | | community/linear-connector | Linear project management | | community/notion-connector | Notion workspace integration | | community/google-drive | Google Drive file management |

🎨 Creative / Design / Content

| Registry Path | Description | |--------------|-------------| | smithery/document-generator | Generate PDF, DOCX, HTML from templates | | smithery/api-tester | REST and GraphQL API testing | | smithery/doc-generator | Auto-generate API docs and README files | | smithery/code-formatter | Multi-language code formatting and linting | | community/figma-connector | Import Figma designs and export assets | | community/shopify-connector | Shopify e-commerce integration | | mcp/git-manager | Git repository operations (clone, branch, PR, merge) | | mcp/cms-connector | Content management system publishing |

🏗 Architecture

src/orchestrator-cli/
  config.ts    — Persistent config manager (.aura-config.json)
  agent.ts     — Agent CRUD + table rendering
  skill.ts     — Skill CRUD + catalog + table rendering
  todo.ts      — Task engine with NLP parsing + suggestion engine
  engine.ts    — Intent analysis + agent/skill matching + dispatch
  private.ts   — Premium feature gating
  index.ts     — CLI entry point (Commander.js)

🔒 Private Mode

AURA has a gated private mode for premium features. To unlock:

1. Create ~/.aura-private.json:

{
  "user": "your-name",
  "token": "your-private-token",
  "tier": "premium",
  "features": ["batch-run", "priority-queue", "bulk-import"],
  "expiresAt": "2026-12-31T23:59:59Z"
}

2. Run aura private to verify

🛠 Development

# Clone and install
git clone https://github.com/mjthedeveloper-07/aura-orchestrator-cli.git
cd aura
npm install

# Dev mode
npx tsx src/orchestrator-cli/index.ts status

# Type check
npm run lint

# Build
npm run build

# Test globally
npm link
aura

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md to get started.

📄 License

MIT License — see LICENSE for details.