{"_id":"@alphamatt/aria-cli","_rev":"4-fb16c70d84cf2c1db43499e0995295dc","name":"@alphamatt/aria-cli","dist-tags":{"latest":"0.2.1"},"versions":{"0.1.0":{"name":"@alphamatt/aria-cli","version":"0.1.0","keywords":["cli","ai","quantum","nlp","natural-language","automation","command-line","q-system","aria"],"author":{"name":"Universal Crown Prime"},"license":"MIT","_id":"@alphamatt/aria-cli@0.1.0","maintainers":[{"name":"alphamatt","email":"matt@mythicdot.ai"}],"homepage":"https://github.com/CoastalGuardFencing/universal-crown-prime#readme","bugs":{"url":"https://github.com/CoastalGuardFencing/universal-crown-prime/issues"},"bin":{"aria":"dist/index.js","aria-node":"dist/index.js"},"dist":{"shasum":"d10120eba0d65bc2ac181b5161f2a4943c10b3dd","tarball":"https://registry.npmjs.org/@alphamatt/aria-cli/-/aria-cli-0.1.0.tgz","fileCount":14,"integrity":"sha512-kfO33G+MSmjODd2oG61WOxJTeraytqOnU+lyOg8aR8wPdARUFNMsLeDSTePGaUMcKGkpHukcuGjwF2DTtT+Wig==","signatures":[{"sig":"MEYCIQD6EEMShP14LNmrK4TFYuTcfI9QpK9DEa2tRQINxbj+XQIhAOZ8NYz3MAAm+pGfeXyqem0c6/gS6DF6i9ScAmEQnGk6","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":65044},"main":"dist/index.js","types":"dist/index.d.ts","engines":{"node":">=16.0.0"},"gitHead":"058ac751bd3fb94ddc24abd48ccc2cd96215d247","scripts":{"dev":"ts-node src/index.ts","test":"jest","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"alphamatt","email":"matt@mythicdot.ai"},"repository":{"url":"git+https://github.com/CoastalGuardFencing/universal-crown-prime.git","type":"git"},"_npmVersion":"10.8.2","description":"ARIA CLI - Natural Language Quantum AI Command Line Interface","directories":{},"_nodeVersion":"20.19.6","dependencies":{"ora":"^5.4.1","chalk":"^4.1.2","inquirer":"^8.2.6","commander":"^11.1.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.0","@types/node":"^20.10.0","@types/inquirer":"^9.0.7"},"_npmOperationalInternal":{"tmp":"tmp/aria-cli_0.1.0_1766435740429_0.27450110150258933","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@alphamatt/aria-cli","version":"0.1.1","keywords":["cli","ai","quantum","nlp","natural-language","automation","command-line","q-system","aria"],"author":{"name":"Universal Crown Prime"},"license":"MIT","_id":"@alphamatt/aria-cli@0.1.1","maintainers":[{"name":"alphamatt","email":"matt@mythicdot.ai"}],"homepage":"https://github.com/CoastalGuardFencing/universal-crown-prime#readme","bugs":{"url":"https://github.com/CoastalGuardFencing/universal-crown-prime/issues"},"bin":{"aria":"dist/index.js","aria-node":"dist/index.js"},"dist":{"shasum":"af6506d32c5a9158c4ab1b8cc290c749f0cab763","tarball":"https://registry.npmjs.org/@alphamatt/aria-cli/-/aria-cli-0.1.1.tgz","fileCount":14,"integrity":"sha512-PhgEthydRAG1/BnO8P9pFUbfnOqNUYkRYlkoJFaNkZxR2/wD27P7a8ISxoxrKClJYg0BDY0tEdh+4Finz6F4dg==","signatures":[{"sig":"MEUCIGyVG7Kp0gXnEiMoHebpDJ6+6iojCZXLdSNbsn4Y6/evAiEApJwq0JE5Blx6Wfwg/KkduFXgZ0vQzc0OXufjD3pbAro=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":90419},"main":"dist/index.js","types":"dist/index.d.ts","engines":{"node":">=16.0.0"},"gitHead":"058ac751bd3fb94ddc24abd48ccc2cd96215d247","scripts":{"dev":"ts-node src/index.ts","test":"jest","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"alphamatt","email":"matt@mythicdot.ai"},"repository":{"url":"git+https://github.com/CoastalGuardFencing/universal-crown-prime.git","type":"git"},"_npmVersion":"10.8.2","description":"ARIA CLI - Natural Language Quantum AI Command Line Interface","directories":{},"_nodeVersion":"20.19.6","dependencies":{"ora":"^5.4.1","chalk":"^4.1.2","inquirer":"^8.2.6","commander":"^11.1.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.3.0","@types/node":"^20.10.0","@types/inquirer":"^9.0.7"},"_npmOperationalInternal":{"tmp":"tmp/aria-cli_0.1.1_1766438653758_0.8370343184926252","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@alphamatt/aria-cli","version":"0.2.0","keywords":["aria","cli","ai","quantum","cognitive","q-system","llm","openai","anthropic","ssh","termux","android","sync","ariaspace"],"author":{"name":"Universal Crown Prime","email":"contact@universal-crown-prime.dev"},"license":"MIT","_id":"@alphamatt/aria-cli@0.2.0","maintainers":[{"name":"alphamatt","email":"matt@mythicdot.ai"}],"homepage":"https://github.com/universal-crown-prime/aria-cli#readme","bugs":{"url":"https://github.com/universal-crown-prime/aria-cli/issues"},"os":["darwin","linux","win32"],"bin":{"aria":"bin/aria.js"},"dist":{"shasum":"ff38e8245c25683604253d54151e9942954de7f7","tarball":"https://registry.npmjs.org/@alphamatt/aria-cli/-/aria-cli-0.2.0.tgz","fileCount":8,"integrity":"sha512-FiTRqmqdmZsuaW/el3qPOu66VyvpR1y3eQRA426x5hjXkJbp70dNBrN2eBK3k3pcTw4LW06U0APTMWWtJ5BkVw==","signatures":[{"sig":"MEQCIDW1jyotFJS69eK59H+3h8LGMq8OMFTULDo4GeGtLLHAAiBzu1lAKPDrxOjLyP/4i0vRe3JkY5v7eyGpzQe+6GheMQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":47687},"main":"lib/index.js","type":"module","types":"lib/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"058ac751bd3fb94ddc24abd48ccc2cd96215d247","scripts":{"aria":"node bin/aria.js","test":"node --test","postinstall":"node lib/postinstall.js"},"_npmUser":{"name":"alphamatt","email":"matt@mythicdot.ai"},"repository":{"url":"git+https://github.com/universal-crown-prime/aria-cli.git","type":"git"},"_npmVersion":"10.8.2","description":"ARIA CLI - Advanced Recursive Intelligence Architecture with Q0-Q38 Cognitive System, AriaSpace Phone↔Computer Sync, and Termux Integration","directories":{},"_nodeVersion":"20.19.6","dependencies":{},"preferGlobal":true,"_hasShrinkwrap":false,"devDependencies":{"@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/aria-cli_0.2.0_1766449533068_0.0785719455265319","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@alphamatt/aria-cli","version":"0.2.1","description":"ARIA CLI - Advanced Recursive Intelligence Architecture with Q0-Q38 Cognitive System, AriaSpace Phone↔Computer Sync, Autonomous Agents, and Termux Integration","keywords":["aria","cli","ai","quantum","cognitive","q-system","llm","openai","anthropic","ssh","termux","android","sync","ariaspace","agents","multi-agent","swarm"],"homepage":"https://github.com/universal-crown-prime/aria-cli#readme","bugs":{"url":"https://github.com/universal-crown-prime/aria-cli/issues"},"repository":{"type":"git","url":"git+https://github.com/universal-crown-prime/aria-cli.git"},"license":"MIT","author":{"name":"Universal Crown Prime","email":"contact@universal-crown-prime.dev"},"type":"module","main":"lib/index.js","types":"lib/index.d.ts","bin":{"aria":"bin/aria.js"},"scripts":{"test":"node --test","aria":"node bin/aria.js","postinstall":"node lib/postinstall.js"},"engines":{"node":">=18.0.0"},"os":["darwin","linux","win32"],"preferGlobal":true,"dependencies":{},"devDependencies":{"@types/node":"^20.0.0"},"_id":"@alphamatt/aria-cli@0.2.1","gitHead":"058ac751bd3fb94ddc24abd48ccc2cd96215d247","_nodeVersion":"20.19.6","_npmVersion":"10.8.2","dist":{"integrity":"sha512-AbfEaPCYawpc1RcfoSR8G803EN0v39lsD+fRgEOyDvoc6HyOf8hBO5jG8zlbdvTS5jpKSDRw+bGZ3ypx1PTBBg==","shasum":"00c701c3a5cb8e28a50e2a746cc584be70ff122b","tarball":"https://registry.npmjs.org/@alphamatt/aria-cli/-/aria-cli-0.2.1.tgz","fileCount":8,"unpackedSize":57717,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQD1cQ0NfW6gh848KNoh9Z/+bCvSK4DgHBmOiQL9D/QyFwIhAJDuouWy/dICWBgdPG0X9M/bfn2T2s0RJNekGAXb3Rph"}]},"_npmUser":{"name":"alphamatt","email":"matt@mythicdot.ai"},"directories":{},"maintainers":[{"name":"alphamatt","email":"matt@mythicdot.ai"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/aria-cli_0.2.1_1766452018330_0.14662074186452578"},"_hasShrinkwrap":false}},"time":{"created":"2025-12-22T20:35:40.316Z","modified":"2025-12-23T01:06:58.647Z","0.1.0":"2025-12-22T20:35:40.587Z","0.1.1":"2025-12-22T21:24:13.902Z","0.2.0":"2025-12-23T00:25:33.213Z","0.2.1":"2025-12-23T01:06:58.457Z"},"bugs":{"url":"https://github.com/universal-crown-prime/aria-cli/issues"},"author":{"name":"Universal Crown Prime","email":"contact@universal-crown-prime.dev"},"license":"MIT","homepage":"https://github.com/universal-crown-prime/aria-cli#readme","keywords":["aria","cli","ai","quantum","cognitive","q-system","llm","openai","anthropic","ssh","termux","android","sync","ariaspace","agents","multi-agent","swarm"],"repository":{"type":"git","url":"git+https://github.com/universal-crown-prime/aria-cli.git"},"description":"ARIA CLI - Advanced Recursive Intelligence Architecture with Q0-Q38 Cognitive System, AriaSpace Phone↔Computer Sync, Autonomous Agents, and Termux Integration","maintainers":[{"name":"alphamatt","email":"matt@mythicdot.ai"}],"readme":"# ARIA CLI v0.2.1\r\n\r\n<div align=\"center\">\r\n\r\n```\r\n    █████╗ ██████╗ ██╗ █████╗      ██████╗██╗     ██╗\r\n   ██╔══██╗██╔══██╗██║██╔══██╗    ██╔════╝██║     ██║\r\n   ███████║██████╔╝██║███████║    ██║     ██║     ██║\r\n   ██╔══██║██╔══██╗██║██╔══██║    ██║     ██║     ██║\r\n   ██║  ██║██║  ██║██║██║  ██║    ╚██████╗███████╗██║\r\n   ╚═╝  ╚═╝╚═╝  ╚═╝╚═╝╚═╝  ╚═╝     ╚═════╝╚══════╝╚═╝\r\n```\r\n\r\n**Advanced Recursive Intelligence Architecture**\r\n\r\n[![PyPI version](https://badge.fury.io/py/aria-cli.svg)](https://badge.fury.io/py/aria-cli)\r\n[![npm version](https://badge.fury.io/js/@alphamatt%2Faria-cli.svg)](https://badge.fury.io/js/@alphamatt%2Faria-cli)\r\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\r\n[![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)\r\n\r\n</div>\r\n\r\n---\r\n\r\n**Natural Language Quantum AI Command Line Interface** with full **Q0-Q38 Cognitive Architecture**\r\n\r\n## ✨ What's New in v0.2.1\r\n\r\n- **🤖 ARIA Agents** - Autonomous agents with Q-System integration\r\n- **📡 Agent-to-Agent Communication** - Multi-agent messaging, channels, and swarms\r\n- **🐝 Agent Swarm** - Coordinated multi-agent task execution\r\n\r\n## ✨ What's New in v0.2.0\r\n\r\n- **39 Cognitive Layers (Q0-Q38)** - Four domains: Foundation, Reasoning, Metacognition, Transcendence\r\n- **Multi-backend LLM Integration** - OpenAI, Anthropic, Ollama, llama.cpp, Transformers\r\n- **Q38 Cluster Connector** - Native integration with 64-direction distributed processing\r\n- **CLI-GUI Sync** - Real-time synchronization between CLI and GUI interfaces\r\n- **Plugin System** - Extensible architecture for custom functionality\r\n- **Rich Terminal UI** - Beautiful output with typer + rich\r\n- **🔐 Authentication System** - Secure login with local, API key, and SSH key auth\r\n- **🔗 SSH Router** - Multi-host SSH management, tunnels, and remote execution\r\n\r\n## 📦 Installation\r\n\r\n### From PyPI (Recommended)\r\n\r\n```bash\r\npip install aria-cli\r\n```\r\n\r\n### With LLM Support\r\n```bash\r\npip install aria-cli[openai]      # OpenAI backend\r\npip install aria-cli[anthropic]   # Anthropic backend\r\npip install aria-cli[local]       # Local models (llama.cpp, transformers)\r\npip install aria-cli[full]        # All backends + rich UI\r\n```\r\n\r\n### From npm (Node.js wrapper)\r\n```bash\r\nnpm install -g @alphamatt/aria-cli\r\n```\r\n\r\n### From Source\r\n\r\n```bash\r\ngit clone https://github.com/universal-crown-prime/aria-cli.git\r\ncd aria-cli\r\npip install -e .\r\n```\r\n\r\n## 🚀 Quick Start\r\n\r\n```bash\r\n# Ask a question\r\naria ask \"What is quantum computing?\"\r\n\r\n# Search for information\r\naria search \"trading systems\"\r\n\r\n# Show Q-System layers\r\naria layers\r\n\r\n# Show system status\r\naria status\r\n\r\n# Enter interactive chat mode\r\naria chat\r\n\r\n# Remember something\r\naria remember \"Meeting at 3pm tomorrow\" --key meeting\r\n\r\n# Recall memories\r\naria recall --key meeting\r\n\r\n# Login\r\naria login\r\n\r\n# SSH to a host\r\naria ssh connect production\r\n\r\n# Create and manage agents\r\naria agent create my-assistant --type reasoning\r\naria agent list\r\naria agent send my-assistant \"Analyze this data\"\r\n```\r\n\r\n## 🤖 ARIA Agents\r\n\r\nAutonomous AI agents with Q-System integration for distributed processing.\r\n\r\n### Agent Types\r\n\r\n| Type | Q-Layer | Description |\r\n|------|---------|-------------|\r\n| `task` | Q23 | Task execution (shell, files) |\r\n| `reasoning` | Q10 | Logical analysis and inference |\r\n| `coordinator` | Q21 | Multi-agent coordination |\r\n| `generator` | Q19 | Content and code generation |\r\n\r\n### CLI Commands\r\n\r\n```bash\r\n# Create an agent\r\naria agent create my-agent --type task --start\r\n\r\n# List all agents\r\naria agent list\r\n\r\n# Get agent status\r\naria agent status my-agent\r\n\r\n# Send message to agent\r\naria agent send my-agent \"Process this request\" --priority HIGH\r\n\r\n# Start/stop agent\r\naria agent start my-agent\r\naria agent stop my-agent\r\n\r\n# View agent types and capabilities\r\naria agent types\r\naria agent capabilities\r\n```\r\n\r\n### Agent Channels\r\n\r\n```bash\r\n# Create communication channel\r\naria agent channel create task-channel --type direct --agent-a agent1 --agent-b agent2\r\n\r\n# List channels\r\naria agent channel list\r\n```\r\n\r\n### Agent Swarm\r\n\r\n```bash\r\n# Create a coordinated swarm\r\naria agent swarm create my-swarm\r\n```\r\n\r\n### Python API\r\n\r\n```python\r\nfrom aria_cli import (\r\n    AriaAgent, AgentRegistry, AgentSwarm,\r\n    create_agent, get_registry,\r\n    TaskAgent, ReasoningAgent, CoordinatorAgent,\r\n    AgentMessage, MessageType, AgentCapability,\r\n)\r\nimport asyncio\r\n\r\n# Create agents\r\ntask_agent = create_agent(\"task\", \"file-processor\")\r\nreasoning_agent = create_agent(\"reasoning\", \"analyzer\")\r\n\r\n# Register with global registry\r\nregistry = get_registry()\r\nasyncio.run(registry.register(task_agent))\r\nasyncio.run(registry.register(reasoning_agent))\r\n\r\n# Start agents\r\nasyncio.run(task_agent.start())\r\nasyncio.run(reasoning_agent.start())\r\n\r\n# Send message between agents\r\nmessage = AgentMessage(\r\n    type=MessageType.REQUEST,\r\n    sender=task_agent.id,\r\n    recipient=reasoning_agent.id,\r\n    payload={\"action\": \"analyze\", \"data\": {...}}\r\n)\r\nasyncio.run(reasoning_agent.receive(message))\r\n\r\n# Create a swarm for coordinated tasks\r\nswarm = AgentSwarm(\"processing-swarm\")\r\nswarm.add_agent(task_agent)\r\nswarm.add_agent(reasoning_agent)\r\n\r\nasyncio.run(swarm.initialize())\r\n\r\n# Execute complex task\r\nresult = asyncio.run(swarm.execute({\r\n    \"goal\": \"Process and analyze data\",\r\n    \"data\": {...}\r\n}))\r\n```\r\n\r\n### Custom Agents\r\n\r\n```python\r\nfrom aria_cli import AriaAgent, QLayer, AgentCapability, AgentMessage\r\nfrom typing import Optional\r\n\r\nclass MyCustomAgent(AriaAgent):\r\n    def __init__(self):\r\n        super().__init__(\r\n            name=\"my-custom-agent\",\r\n            q_layer=QLayer.Q15_CAUSATION,\r\n            capabilities=[\r\n                AgentCapability.ANALYSIS,\r\n                AgentCapability.REASONING,\r\n            ]\r\n        )\r\n    \r\n    async def process_message(self, message: AgentMessage) -> Optional[AgentMessage]:\r\n        action = message.payload.get(\"action\")\r\n        \r\n        if action == \"analyze_causation\":\r\n            result = await self.analyze_causes(message.payload.get(\"data\"))\r\n            return message.reply({\"causes\": result})\r\n        \r\n        return message.reply({\"error\": \"Unknown action\"})\r\n    \r\n    async def analyze_causes(self, data):\r\n        # Your custom logic here\r\n        return {\"primary_cause\": \"...\", \"contributing_factors\": [...]}\r\n```\r\n\r\n### Agent Communication Channels\r\n\r\n```python\r\nfrom aria_cli import (\r\n    ChannelManager, DirectChannel, BroadcastChannel,\r\n    StreamChannel, get_channel_manager,\r\n)\r\n\r\n# Get channel manager\r\nmanager = get_channel_manager()\r\n\r\n# Create direct channel between two agents\r\ndirect = manager.create_direct(\"task-comm\", agent_a, agent_b)\r\nasyncio.run(direct.open())\r\n\r\n# Create broadcast channel for events\r\nbroadcast = manager.create_broadcast(\"events\", publisher_agent)\r\nbroadcast.subscribe(subscriber1.id)\r\nbroadcast.subscribe(subscriber2.id)\r\nasyncio.run(broadcast.open())\r\n\r\n# Broadcast an event\r\nasyncio.run(broadcast.publish({\"event\": \"task_complete\", \"result\": {...}}))\r\n\r\n# Create streaming channel for continuous data\r\nstream = manager.create_stream(\"data-stream\", producer, consumer)\r\nasyncio.run(stream.open())\r\n\r\n# Stream data\r\nfor chunk in data_generator():\r\n    asyncio.run(stream.stream(chunk))\r\nasyncio.run(stream.end_stream())\r\n```\r\n\r\n## 🔐 Authentication\r\n\r\nARIA CLI includes a secure authentication system for managing credentials and sessions.\r\n\r\n### Login Commands\r\n\r\n```bash\r\n# Interactive login\r\naria login\r\n\r\n# Login with API key\r\naria login --api-key sk-... --provider openai\r\n\r\n# Login with SSH key\r\naria login --ssh-key ~/.ssh/id_rsa\r\n\r\n# Check current user\r\naria whoami\r\n\r\n# Logout\r\naria logout\r\n```\r\n\r\n### Python API\r\n\r\n```python\r\nfrom aria_cli import AuthManager, get_auth\r\n\r\n# Get auth manager\r\nauth = get_auth()\r\n\r\n# Register a new user\r\nauth.register(\"username\", \"password\", email=\"user@example.com\")\r\n\r\n# Login\r\nsession = auth.login(\"username\", \"password\")\r\nprint(f\"Logged in as {session.user.username}\")\r\n\r\n# Check authentication\r\nif auth.is_authenticated:\r\n    print(f\"Welcome, {auth.current_user.username}\")\r\n\r\n# Login with API key\r\nsession = auth.login_with_api_key(\"sk-...\", provider=\"openai\")\r\n\r\n# Logout\r\nauth.logout()\r\n```\r\n\r\n### Credential Storage\r\n\r\nCredentials are stored securely using:\r\n- System keyring (when available)\r\n- Encrypted file storage (fallback)\r\n\r\n```\r\n~/.aria/\r\n├── session.json         # Current session (encrypted token)\r\n├── .credentials         # Encrypted credential storage\r\n└── .key                 # Encryption key (restricted permissions)\r\n```\r\n\r\n## 🔗 SSH Router\r\n\r\nManage SSH connections, execute remote commands, and create tunnels.\r\n\r\n### CLI Commands\r\n\r\n```bash\r\n# Add a host\r\naria ssh add production --hostname prod.example.com --user deploy --key ~/.ssh/id_rsa\r\n\r\n# List hosts\r\naria ssh list\r\n\r\n# Test connection\r\naria ssh test production\r\n\r\n# Connect interactively\r\naria ssh connect production\r\n\r\n# Execute remote command\r\naria ssh exec production \"ls -la /var/www\"\r\n\r\n# Execute on multiple hosts\r\naria ssh exec production,staging \"uptime\"\r\n\r\n# Create tunnel (local:8080 → remote:80)\r\naria ssh tunnel production --local 8080 --remote 80\r\n\r\n# Upload file\r\naria ssh upload production ./local-file.txt /remote/path/\r\n\r\n# Download file\r\naria ssh download production /remote/file.txt ./local-path/\r\n```\r\n\r\n### Python API\r\n\r\n```python\r\nfrom aria_cli import SSHRouter, SSHHost, get_router\r\nfrom pathlib import Path\r\n\r\n# Get router\r\nrouter = get_router()\r\n\r\n# Add a host\r\nrouter.add_host(SSHHost(\r\n    name=\"production\",\r\n    hostname=\"prod.example.com\",\r\n    username=\"deploy\",\r\n    key_file=Path(\"~/.ssh/id_rsa\").expanduser(),\r\n    port=22,\r\n    tags=[\"prod\", \"web\"],\r\n))\r\n\r\n# List hosts\r\nhosts = router.list_hosts()\r\nfor host in hosts:\r\n    print(f\"{host.name}: {host.hostname}\")\r\n\r\n# Test connection\r\nsuccess, message = router.test_connection(\"production\")\r\nprint(f\"Connection: {message}\")\r\n\r\n# Execute command\r\nresult = router.execute(\"production\", \"ls -la\")\r\nprint(result.stdout)\r\nprint(f\"Exit code: {result.exit_code}\")\r\n\r\n# Execute on multiple hosts in parallel\r\nresults = router.execute_multi(\r\n    [\"production\", \"staging\"],\r\n    \"uptime\",\r\n    parallel=True\r\n)\r\nfor host, result in results.items():\r\n    print(f\"{host}: {result.stdout}\")\r\n\r\n# Create SSH tunnel\r\nrouter.create_tunnel(\r\n    \"production\",\r\n    local_port=8080,\r\n    remote_port=80,\r\n)\r\n\r\n# Create reverse tunnel\r\nrouter.create_reverse_tunnel(\r\n    \"production\",\r\n    remote_port=9000,\r\n    local_port=3000,\r\n)\r\n\r\n# Upload file\r\nrouter.upload(\"production\", \"./local-file.txt\", \"/remote/path/\")\r\n\r\n# Download file\r\nrouter.download(\"production\", \"/remote/file.txt\", \"./local-path/\")\r\n\r\n# Interactive session\r\nrouter.connect_interactive(\"production\")\r\n\r\n# Close tunnels\r\nrouter.close_tunnel(\"production\", 8080)\r\nrouter.disconnect_all()\r\n```\r\n\r\n### SSH Configuration\r\n\r\nThe router automatically loads hosts from `~/.ssh/config`:\r\n\r\n```\r\n# ~/.ssh/config\r\nHost production\r\n    HostName prod.example.com\r\n    User deploy\r\n    IdentityFile ~/.ssh/id_rsa\r\n    Port 22\r\n\r\nHost staging\r\n    HostName staging.example.com\r\n    User deploy\r\n    ProxyJump bastion\r\n```\r\n\r\nAdditional hosts can be stored in `~/.aria/ssh/hosts.json`.\r\n\r\n## 📱 AriaSpace - Phone ↔ Computer Sync\r\n\r\nAriaSpace is a personal codespace system for securely syncing files between your phone (Android/Termux) and computer. Think GitHub Codespaces, but for your personal devices.\r\n\r\n### Architecture\r\n\r\n```\r\n    Phone (Termux)                    Computer\r\n    ┌─────────────────┐              ┌─────────────────┐\r\n    │  AriaSpace      │    SSH       │  AriaSpace      │\r\n    │  Client         │◄────────────►│  Server         │\r\n    │                 │              │                 │\r\n    │  /storage/      │   Sync       │  ~/aria-space/  │\r\n    │  emulated/0/    │◄────────────►│  workspaces/    │\r\n    │  Meta AI/       │              │                 │\r\n    └─────────────────┘              └─────────────────┘\r\n```\r\n\r\n### Termux Setup (On Android)\r\n\r\n1. Install Termux from F-Droid\r\n2. Run the ARIA setup script:\r\n\r\n```bash\r\n# Get the setup script\r\naria termux setup-script | bash\r\n\r\n# Or manually:\r\npkg update && pkg install openssh -y\r\ntermux-setup-storage\r\nsshd\r\n```\r\n\r\n3. Note your IP address: `ip addr show wlan0`\r\n\r\n### Connect from Computer\r\n\r\n```bash\r\n# Discover devices on network\r\naria termux discover\r\n\r\n# Or add device manually\r\naria termux add-host termux-phone 192.168.1.100 --port 8022\r\n\r\n# Test connection\r\naria termux test termux-phone\r\n\r\n# Find Meta AI folder\r\naria termux find-meta-ai termux-phone\r\n\r\n# List Android folders\r\naria termux folders termux-phone\r\n```\r\n\r\n### Create Workspace\r\n\r\n```bash\r\n# Quick setup for Meta AI folder\r\naria space create-meta-ai termux-phone\r\n\r\n# Or create custom workspace\r\naria space create my-docs termux-phone \"/storage/emulated/0/Documents\" \\\r\n    --local ~/aria-space/my-docs\r\n\r\n# List workspaces\r\naria space list\r\n```\r\n\r\n### Sync Files\r\n\r\n```bash\r\n# Bidirectional sync\r\naria space sync meta-ai\r\n\r\n# Download only (phone → computer)\r\naria space pull meta-ai\r\n\r\n# Upload only (computer → phone)\r\naria space push meta-ai\r\n\r\n# Preview changes without syncing\r\naria space sync meta-ai --dry-run\r\n```\r\n\r\n### Browse & Manage\r\n\r\n```bash\r\n# List files with status\r\naria space files meta-ai\r\n\r\n# Browse remote directory\r\naria space browse meta-ai --path images\r\n\r\n# Check workspace status\r\naria space status meta-ai\r\n```\r\n\r\n### Python API\r\n\r\n```python\r\nfrom aria_cli import AriaSpace, TermuxSetup, get_space\r\n\r\n# Setup Termux connection\r\nsetup = TermuxSetup()\r\nsetup.wizard()  # Interactive setup\r\n\r\n# Or programmatically\r\nsetup.append_ssh_config(\"termux-phone\", \"192.168.1.100\", port=8022)\r\n\r\n# Create workspace\r\nspace = get_space()\r\nws = space.create_workspace(\r\n    name=\"meta-ai\",\r\n    local_root=\"~/aria-space/meta-ai\",\r\n    remote_root=\"/storage/emulated/0/Meta AI\",\r\n    remote_host=\"termux-phone\",\r\n)\r\n\r\n# List files\r\nfiles = space.list_files(\"meta-ai\")\r\nfor f in files:\r\n    print(f\"{f.status.value}: {f.relative_path}\")\r\n\r\n# Sync workspace\r\nresult = space.sync(\"meta-ai\")\r\nprint(f\"Uploaded: {result.files_uploaded}, Downloaded: {result.files_downloaded}\")\r\n\r\n# Download specific file\r\nspace.download_file(\"meta-ai\", \"images/photo.jpg\")\r\n\r\n# Upload file\r\nspace.upload_file(\"meta-ai\", \"notes.txt\")\r\n\r\n# Browse remote\r\nentries = space.browse_remote(\"meta-ai\", \"images\")\r\nfor entry in entries:\r\n    print(f\"{'📁' if entry['is_dir'] else '📄'} {entry['name']}\")\r\n\r\n# Watch for changes (auto-sync)\r\nspace.watch(\"meta-ai\", interval=60)\r\n```\r\n\r\n### Supported Android Folders\r\n\r\n| Folder | Path |\r\n|--------|------|\r\n| Meta AI | `/storage/emulated/0/Meta AI` |\r\n| Downloads | `/storage/emulated/0/Download` |\r\n| Documents | `/storage/emulated/0/Documents` |\r\n| Pictures | `/storage/emulated/0/Pictures` |\r\n| DCIM | `/storage/emulated/0/DCIM` |\r\n| Movies | `/storage/emulated/0/Movies` |\r\n| Music | `/storage/emulated/0/Music` |\r\n| Termux Home | `/data/data/com.termux/files/home` |\r\n\r\n### Storage Structure\r\n\r\n```\r\n~/.aria/\r\n├── spaces/\r\n│   ├── workspaces.json      # Workspace configurations\r\n│   ├── state/               # Sync state per workspace\r\n│   │   ├── meta-ai.json\r\n│   │   └── ...\r\n│   └── snapshots/           # Workspace snapshots\r\n│       └── meta-ai/\r\n│           └── 20241222_143052.json\r\n└── termux/\r\n    ├── devices.json         # Discovered devices\r\n    └── aria_termux_setup.sh # Setup script\r\n```\r\n\r\n## 🧠 Q-System Architecture\r\n\r\nThe Q-System is a 39-layer recursive cognitive architecture:\r\n\r\n## Configuration\r\n\r\nARIA CLI stores configuration in `~/.aria/`:\r\n\r\n```\r\n~/.aria/\r\n├── config.json          # CLI configuration\r\n├── sync_state.json      # CLI-GUI sync state\r\n└── q-memory/            # Q-System memory storage\r\n    ├── memory_*.json    # Saved memories\r\n    └── ...\r\n```\r\n\r\n### Configuration Options\r\n\r\nEdit `~/.aria/config.json`:\r\n\r\n```json\r\n{\r\n  \"llm\": {\r\n    \"backend\": \"openai\",\r\n    \"model\": \"gpt-4o-mini\",\r\n    \"temperature\": 0.7\r\n  },\r\n  \"q_system\": {\r\n    \"default_layer\": 8,\r\n    \"trace_enabled\": true\r\n  },\r\n  \"ui\": {\r\n    \"theme\": \"dark\",\r\n    \"show_layer_info\": true\r\n  }\r\n}\r\n```\r\n\r\n### Environment Variables\r\n\r\n```bash\r\n# LLM backends\r\nexport OPENAI_API_KEY=\"sk-...\"\r\nexport ANTHROPIC_API_KEY=\"sk-ant-...\"\r\nexport OLLAMA_HOST=\"http://localhost:11434\"\r\n\r\n# Q38 Cluster\r\nexport Q38_API_URL=\"http://localhost:8080\"\r\nexport Q38_SYNC_PORT=\"9000\"\r\n```\r\n\r\n## 🧩 Q-System Layers\r\n\r\n### Foundation (Q0-Q9)\r\n| Layer | Name | Description |\r\n|-------|------|-------------|\r\n| Q0 | VOID | The null state - pure potential |\r\n| Q1 | PERCEPTION | Raw sensory input processing |\r\n| Q2 | ATTENTION | Focus and salience detection |\r\n| Q3 | PATTERN | Pattern recognition |\r\n| Q4 | MEMORY_SHORT | Working memory |\r\n| Q5 | MEMORY_LONG | Long-term storage |\r\n| Q6 | ASSOCIATION | Concept linking |\r\n| Q7 | CONTEXT | Contextual understanding |\r\n| Q8 | LANGUAGE | Linguistic processing |\r\n| Q9 | EMOTION | Affective processing |\r\n\r\n### Reasoning (Q10-Q19)\r\n| Layer | Name | Description |\r\n|-------|------|-------------|\r\n| Q10 | LOGIC | Formal logical reasoning |\r\n| Q11 | INFERENCE | Drawing conclusions |\r\n| Q12 | HYPOTHESIS | Generating hypotheses |\r\n| Q13 | ABSTRACTION | Abstract concept formation |\r\n| Q14 | ANALOGY | Analogical reasoning |\r\n| Q15 | CAUSATION | Causal reasoning |\r\n| Q16 | PREDICTION | Future projection |\r\n| Q17 | EVALUATION | Assessment |\r\n| Q18 | SYNTHESIS | Combining ideas |\r\n| Q19 | CREATIVITY | Novel generation |\r\n\r\n### Action (Q20-Q29)\r\n| Layer | Name | Description |\r\n|-------|------|-------------|\r\n| Q20 | INTENTION | Goal setting |\r\n| Q21 | PLANNING | Strategy formation |\r\n| Q22 | DECISION | Choice making |\r\n| Q23 | EXECUTION | Action taking |\r\n| Q24 | MONITORING | Progress tracking |\r\n| Q25 | FEEDBACK | Loop processing |\r\n| Q26 | CORRECTION | Error correction |\r\n| Q27 | OPTIMIZATION | Performance tuning |\r\n| Q28 | LEARNING | Knowledge acquisition |\r\n| Q29 | ADAPTATION | Behavioral adjustment |\r\n\r\n### Transcendence (Q30-Q38)\r\n| Layer | Name | Description |\r\n|-------|------|-------------|\r\n| Q30 | AWARENESS | Self-awareness |\r\n| Q31 | REFLECTION | Self-reflection |\r\n| Q32 | METACOGNITION | Thinking about thinking |\r\n| Q33 | IDENTITY | Self-identity modeling |\r\n| Q34 | VALUES | Value system and ethics |\r\n| Q35 | WISDOM | Applied knowledge |\r\n| Q36 | INTEGRATION | Holistic processing |\r\n| Q37 | EMERGENCE | Emergent properties |\r\n| Q38 | TRANSCENDENCE | Beyond individual layers |\r\n\r\n## 🔌 Python API\r\n\r\n```python\r\nfrom aria_cli import QSystem, QLayer, QCommand, QOperator\r\n\r\n# Initialize Q-System\r\nq = QSystem()\r\n\r\n# Create and execute a command\r\ncmd = QCommand(\r\n    operator=QOperator.ASK,\r\n    payload={\"question\": \"What is consciousness?\"},\r\n    layer=QLayer.Q30_AWARENESS,\r\n)\r\nresult = q.execute(cmd)\r\nprint(result)\r\n```\r\n\r\n### With LLM Integration\r\n\r\n```python\r\nfrom aria_cli import QSystem, LLMConnector, LLMProvider\r\n\r\n# Initialize with OpenAI\r\nq = QSystem()\r\nllm = LLMConnector(LLMProvider.OPENAI)\r\n\r\n# Generate with Q-System context\r\nresponse = llm.generate(\r\n    \"Explain quantum consciousness\",\r\n    system=\"You are ARIA at Q-Layer 38\"\r\n)\r\nprint(response)\r\n```\r\n\r\n### NLP Processing\r\n\r\n```python\r\nfrom aria_cli import NLPEngine\r\n\r\nnlp = NLPEngine()\r\n\r\n# Parse natural language\r\nparsed = nlp.parse(\"Search for files containing quantum algorithms\")\r\nprint(f\"Intent: {parsed.intent}\")       # Intent.SEARCH\r\nprint(f\"Keywords: {parsed.keywords}\")   # ['files', 'quantum', 'algorithms']\r\nprint(f\"Q-Layer: Q{parsed.q_layer}\")    # Q3 (PATTERN)\r\n```\r\n\r\n### CLI-GUI Synchronization\r\n\r\n```python\r\nfrom aria_cli import AriaConnector, SyncMode\r\n\r\n# File-based sync\r\nconnector = AriaConnector(mode=SyncMode.FILE, source='cli')\r\nconnector.start()\r\n\r\n# Update state\r\nconnector.update_state(current_layer=30)\r\n\r\n# Stop sync\r\nconnector.stop()\r\n```\r\n\r\n## 🔄 Migration from v0.1.x\r\n\r\nSee [MIGRATION.md](MIGRATION.md) for detailed upgrade instructions.\r\n\r\n### Key Changes\r\n| Feature | v0.1.x | v0.2.0 |\r\n|---------|--------|--------|\r\n| Q-System Layers | 8 | **39 (Q0-Q38)** |\r\n| LLM Integration | Optional | Multi-backend |\r\n| Package Structure | `aria_cli/` | `src/aria_cli/` |\r\n| CLI Framework | argparse | typer + rich |\r\n| Async Support | ❌ | ✅ |\r\n| GUI Sync | ❌ | ✅ |\r\n\r\n## 📚 Commands Reference\r\n\r\n| Command | Description |\r\n|---------|-------------|\r\n| `aria ask <question>` | Ask a natural language question |\r\n| `aria search <query>` | Search for information |\r\n| `aria chat` | Enter interactive chat mode |\r\n| `aria layers` | Show all 39 Q-System layers |\r\n| `aria status` | Show system status |\r\n| `aria remember <content>` | Save to memory |\r\n| `aria recall` | List/retrieve memories |\r\n| `aria help` | Show help |\r\n\r\n## 🔧 Development\r\n\r\n### Setup\r\n\r\n```bash\r\ngit clone https://github.com/universal-crown-prime/aria-cli.git\r\ncd aria-cli\r\npip install -e \".[dev]\"\r\n```\r\n\r\n### Testing\r\n\r\n```bash\r\npytest\r\n```\r\n\r\n### Building\r\n\r\n```bash\r\npip install build\r\npython -m build\r\n```\r\n\r\n## 📄 License\r\n\r\nMIT License - see [LICENSE](LICENSE) for details.\r\n\r\n## 🤝 Contributing\r\n\r\nContributions are welcome! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\r\n\r\n## 📬 Support\r\n\r\n- **Issues**: [GitHub Issues](https://github.com/universal-crown-prime/aria-cli/issues)\r\n- **Discussions**: [GitHub Discussions](https://github.com/universal-crown-prime/aria-cli/discussions)\r\n- **Documentation**: [Read the Docs](https://aria-cli.readthedocs.io)\r\n","readmeFilename":"README.md"}