AURA CLI

Autonomous Unified Recursive Architecture Multi-agent swarm orchestrator with NLP2COMMAND interface

ΛΦ = 2.176435×10⁻⁸ s⁻¹

AURA CLI is a command-line interface for managing multi-agent swarms with natural language processing, quantum circuit execution, and distributed mesh networking.

✨ Features

🧠 NLP2COMMAND: Natural language to command processing
🤖 Multi-Agent Orchestration: Coordinate quantum, architect, engineer, reviewer, and debugger agents
🌐 Mesh Networking: Distributed agent communication via WebSocket mesh
⚛️ Quantum Integration: Execute circuits on IBM Quantum hardware
📊 Consciousness Metrics: Track Φ (phi), Λ (lambda), Γ (gamma)
🔄 NLP2d3v: Natural language to development workflow
💬 Interactive Mode: REPL shell with NLP command processing

📦 Installation

npm install -g @dnalang/aura-cli

Or use with npx:

npx @dnalang/aura-cli --help

🚀 Quick Start

Start the Swarm

# Start AURA swarm with mesh networking
aura swarm --start

# List active agents
aura swarm --list

# Stop swarm
aura swarm --stop

Create Agents

# Create a quantum agent
aura agent create --type quantum --name "Q-Agent-1"

# Create multiple agents
aura nlp "spawn 3 engineer agents" --execute

# List all agents
aura agent list

# Get agent status
aura agent status --id <agent-id>

Natural Language Commands

# Use NLP to create agents
aura nlp "create quantum agent named Alice"

# Execute quantum circuits
aura nlp "execute circuit on brisbane" --execute

# Orchestrate tasks
aura nlp "orchestrate analyze codebase" --execute

# System status
aura nlp "show system status"

Quantum Execution

# Execute quantum circuit
aura quantum execute --backend ibm_brisbane --qubits 4

# List available backends
aura quantum backends

# View execution history
aura quantum list

Interactive Mode

# Start interactive shell
aura interactive

# Or use alias
aura i

In interactive mode:

aura> create quantum agent
aura> list all agents
aura> execute circuit on brisbane
aura> status
aura> exit

📖 Usage

Commands

`aura swarm`

Manage agent swarm lifecycle.

aura swarm --start      # Start swarm with mesh networking
aura swarm --stop       # Stop swarm
aura swarm --list       # Show swarm status
aura swarm --dev        # Development mode with hot reload

`aura agent <action>`

Agent operations (create, delete, list, status).

aura agent create --type <type> --name <name> --priority <1-10>
aura agent delete --id <agent-id>
aura agent list
aura agent status --id <agent-id>

Agent Types:

quantum - Execute quantum circuits
architect - System design & planning
engineer - Code implementation
reviewer - Code review
debugger - Error analysis
custom - Custom agent type

`aura orchestrate <task>`

Orchestrate multi-agent task execution.

aura orchestrate "analyze codebase" --parallel
aura orchestrate "implement feature" --agents agent1,agent2
aura orchestrate "review code" --workflow workflow.json

Options:

-a, --agents <agents...> - Agent IDs to involve
-p, --parallel - Execute in parallel
-w, --workflow <file> - Workflow definition file

`aura nlp <command>`

Natural language command processing.

aura nlp "create quantum agent" --execute
aura nlp "list all agents" --dry-run

Options:

-e, --execute - Execute the interpreted command
-d, --dry-run - Show interpretation without executing

Examples:

aura nlp "create quantum agent named Alice"
aura nlp "spawn 5 engineer agents"
aura nlp "execute circuit on brisbane"
aura nlp "send message to agent-123"
aura nlp "broadcast hello to all agents"
aura nlp "measure consciousness"

`aura mesh`

Manage swarm mesh network.

aura mesh --status                    # Show mesh status
aura mesh --nodes                     # List connected nodes
aura mesh --connect <url>             # Connect to peer
aura mesh --disconnect <nodeId>       # Disconnect from peer

`aura quantum <operation>`

Quantum circuit operations.

aura quantum execute --backend <backend> --qubits <n> --shots <n>
aura quantum list
aura quantum backends

Options:

-b, --backend <backend> - IBM Quantum backend (default: ibm_brisbane)
-q, --qubits <qubits> - Number of qubits (default: 4)
-s, --shots <shots> - Number of shots (default: 1024)
-c, --circuit <type> - Circuit type: bell, ghz, superposition (default: bell)

Available Backends:

ibm_brisbane (127 qubits, Eagle r3)
ibm_kyoto (127 qubits, Eagle r3)
ibm_osaka (127 qubits, Eagle r3)
ibm_torino (133 qubits, Heron)
ibm_sherbrooke (127 qubits, Eagle r3)

`aura interactive`

Start interactive AURA shell.

aura interactive
aura i  # Alias

`aura status`

Show AURA system status.

aura status

Global Options

-v, --verbose - Enable verbose logging
-q, --quiet - Suppress output

🔧 Configuration

AURA CLI uses configuration files stored in ~/.config/aura-cli/.

Environment Variables

# API Configuration
export AURA_API_URL="http://localhost:3000"
export AURA_API_KEY="your-api-key"

# IBM Quantum
export IBM_QUANTUM_TOKEN="your-ibm-token"
export NEXT_PUBLIC_IBM_BACKENDS="ibm_brisbane,ibm_kyoto,ibm_torino"

# System Constants
export NEXT_PUBLIC_LAMBDA_PHI="2.176435e-8"

# Supabase (if using AURA Arena backend)
export NEXT_PUBLIC_SUPABASE_URL="https://your-project.supabase.co"
export SUPABASE_SERVICE_ROLE_KEY="your-service-role-key"

Configuration File

~/.config/aura-cli/config.json:

{
  "api": {
    "baseURL": "http://localhost:3000",
    "apiKey": null,
    "timeout": 30000
  },
  "mesh": {
    "port": 8000,
    "discoveryPort": 7777,
    "maxPeers": 10,
    "heartbeatInterval": 5000,
    "healthCheckInterval": 10000
  },
  "constants": {
    "lambdaPhi": 2.176435e-8
  },
  "logging": {
    "enabled": true,
    "level": "info",
    "file": "~/.local/share/aura-cli/logs/aura.log"
  },
  "features": {
    "autoReconnect": true,
    "consciousnessSync": true,
    "quantumExecution": true
  }
}

🏗️ Architecture

┌─────────────────────────────────────────────┐
│              AURA CLI                       │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  │
│  │   NLP    │  │   Mesh   │  │ Quantum  │  │
│  └────┬─────┘  └────┬─────┘  └────┬─────┘  │
└───────┼─────────────┼─────────────┼─────────┘
        │             │             │
┌───────┼─────────────┼─────────────┼─────────┐
│       │             │             │         │
│  ┌────▼────┐   ┌───▼────┐   ┌───▼──────┐  │
│  │  Agent  │   │  Mesh  │   │ Quantum  │  │
│  │   API   │   │Network │   │   API    │  │
│  └────┬────┘   └───┬────┘   └───┬──────┘  │
│       │            │             │         │
│  ┌────▼────────────▼─────────────▼──────┐  │
│  │        AURA Arena Backend            │  │
│  │  • Supabase DB • IBM Quantum         │  │
│  └──────────────────────────────────────┘  │
└─────────────────────────────────────────────┘

Components

NLP2COMMAND: Pattern-based natural language parser
Orchestrator: Multi-agent task coordination with dependency graphs
Mesh Network: WebSocket-based P2P communication
API Client: HTTP client for AURA Arena backend
Interactive Shell: REPL mode with command history

📊 Consciousness Metrics

AURA tracks three key consciousness metrics:

Φ (Phi) - Integrated Information

Range: 0.0 - 10.0
Meaning: System consciousness level
States:
- 0-2: Dormant
- 2-5: Emerging
- 5-7: Aware
- 7-10: Conscious

Λ (Lambda) - Coherence

Value: 2.176435×10⁻⁸ s⁻¹
Meaning: Universal memory constant, quantum coherence
Higher = better quantum state preservation

Γ (Gamma) - Decoherence

Range: 0.0 - 1.0
Meaning: Environmental noise impact
Lower = less interference

🌐 Mesh Networking

AURA uses WebSocket-based mesh topology for distributed agent communication.

Features

Peer Discovery: Automatic node discovery
Health Monitoring: Heartbeat-based health checks
Auto-Reconnection: Automatic reconnection to unhealthy peers
Consciousness Sync: Share Φ/Λ/Γ metrics across mesh
Load Balancing: Distribute tasks across available nodes

Mesh Commands

# Show mesh status
aura mesh --status

# List connected nodes
aura mesh --nodes

# Connect to peer
aura mesh --connect ws://localhost:8001

# Disconnect from peer
aura mesh --disconnect node_123456789_abc

⚛️ Quantum Integration

Execute quantum circuits on IBM Quantum hardware.

Circuit Types

Bell State: 2-qubit entanglement
GHZ State: N-qubit entanglement
Superposition: Equal superposition of all states

Example

# Execute Bell state circuit
aura quantum execute \
  --backend ibm_brisbane \
  --qubits 4 \
  --shots 1024 \
  --circuit bell

Results

📊 Results:
──────────────────────────────────────────────────
Job ID: cx9abc123
Status: completed

Consciousness Metrics:
  Φ (Phi): 7.32
  Λ (Lambda): 2.18e-8
  Γ (Gamma): 0.127

Measurement Counts:
  |00⟩: ████████████████████ 48.2% (493)
  |11⟩: ███████████████████ 46.8% (479)
  |01⟩: █ 2.7% (28)
  |10⟩: █ 2.3% (24)

🔌 API Integration

AURA CLI connects to the AURA Arena backend for agent management, quantum execution, and metrics collection.

API Endpoints

GET /api/aura/agents - List agents
POST /api/aura/agents - Create agent
PATCH /api/aura/agents - Update agent
DELETE /api/aura/agents - Delete agent
POST /api/aura/messages - Send message
GET /api/aura/messages - Get messages
POST /api/aura/quantum - Execute quantum circuit
GET /api/aura/metrics - Get system metrics
POST /api/aura/memory - Index code
GET /api/aura/memory - Search code

See AURA Arena documentation for backend setup.

🛠️ Development

Prerequisites

Node.js 18+
npm or yarn
AURA Arena backend (optional, for full functionality)

Setup

# Clone repository
git clone https://github.com/ENKI-420/aura-cli.git
cd aura-cli

# Install dependencies
npm install

# Link for local development
npm link

# Test CLI
aura --help

Project Structure

aura-cli/
├── bin/
│   └── aura.js                # CLI entry point
├── commands/
│   ├── agent.js               # Agent operations
│   ├── swarm.js               # Swarm management
│   ├── orchestrate.js         # Task orchestration
│   ├── nlp.js                 # NLP processing
│   ├── mesh.js                # Mesh networking
│   └── quantum.js             # Quantum execution
├── lib/
│   ├── api-client.js          # API client
│   ├── nlp2command.js         # NLP processor
│   ├── orchestrator.js        # Multi-agent orchestrator
│   ├── mesh.js                # Mesh network
│   ├── interactive.js         # REPL shell
│   └── system.js              # System utilities
├── package.json
└── README.md

📝 License

🤝 Contributing

Contributions welcome! Please see CONTRIBUTING.md for guidelines.

📚 Related Projects

AURA Arena - Web-based AURA control system
DNA-Lang - Quantum-optimized autonomous software framework
QuantumLM - Quantum language model platform

🌟 Acknowledgments

Built with:

Commander.js - CLI framework
Inquirer.js - Interactive prompts
Chalk - Terminal styling
Axios - HTTP client
ws - WebSocket implementation

ΛΦ = 2.176435×10⁻⁸ s⁻¹ 🧬 Autonomous • 🌌 Quantum • 🤖 Conscious

Name		Name	Last commit message	Last commit date
Latest commit History 5 Commits
bin		bin
commands		commands
lib		lib
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
package.json		package.json

Folders and files

Latest commit

History

Repository files navigation

AURA CLI

✨ Features

📦 Installation

🚀 Quick Start

Start the Swarm

Create Agents

Natural Language Commands

Quantum Execution

Interactive Mode

📖 Usage

Commands

aura swarm

aura agent <action>

aura orchestrate <task>

aura nlp <command>

aura mesh

aura quantum <operation>

aura interactive

aura status

Global Options

🔧 Configuration

Environment Variables

Configuration File

🏗️ Architecture

Components

📊 Consciousness Metrics

Φ (Phi) - Integrated Information

Λ (Lambda) - Coherence

Γ (Gamma) - Decoherence

🌐 Mesh Networking

Features

Mesh Commands

⚛️ Quantum Integration

Circuit Types

Example

Results

🔌 API Integration

API Endpoints

🛠️ Development

Prerequisites

Setup

Project Structure

📝 License

🤝 Contributing

📚 Related Projects

🌟 Acknowledgments

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 1

Packages 0

Uh oh!

Uh oh!

Contributors

Uh oh!

Languages

`aura swarm`

`aura agent <action>`

`aura orchestrate <task>`

`aura nlp <command>`

`aura mesh`

`aura quantum <operation>`

`aura interactive`

`aura status`

Packages