---

🎯 What is Loxia Autopilot One?

Loxia Autopilot One is a production-ready autonomous AI agent system that empowers developers with intelligent coding assistance. It combines the power of multiple AI models with a comprehensive toolkit for software development, code analysis, and automation.

$3

- 🤖 Multi-Agent Orchestration - Run multiple AI agents simultaneously with isolated workspaces
- 🔧 Rich Tool Ecosystem - 18+ specialized tools for development, analysis, and automation
- 🌐 Dual Interface - Modern Web UI + powerful CLI for any workflow
- 📊 Real-Time Monitoring - Track agent activity, costs, and performance
- 💾 Persistent State - Resume conversations and continue work across sessions
- 🔒 Secure by Design - Agent isolation, resource limits, and security scanning

---

✨ Features

$3

#### 🤖 Intelligent Agent System - Multi-agent conversation orchestration - Automatic model selection and routing - Task-based agent specialization - Inter-agent communication - Background task management	#### 🛠️ Professional Tooling - Terminal command execution - File system operations - Web browsing and scraping - Image generation (DALL-E, Flux) - Code analysis and refactoring
#### 📈 Development Features - Import/export analysis - Dependency resolution - Static code analysis - Clone detection - Security scanning	#### 💡 Smart Assistance - Context-aware responses - File attachments in chat - Conversation compaction - Task management - Progress tracking

---

🚀 Quick Start

$3

Register at autopilot.loxia.ai to get started.

$3

``bash
npm install -g @loxia-labs/loxia-autopilot-one
`

$3

`bash
loxia --version


Should display: Loxia Autopilot One v1.8.0


`

$3

1. Sign in at autopilot.loxia.ai
2. Navigate to API Keys
3. Create a new API key and copy it

$3

#### Option A: Web UI
`bash
loxia web
`
This starts the server and opens the Web UI in your browser. Go to Settings and paste your API key.

#### Option B: Terminal UI
`bash
loxia plus-terminal
`
This starts the server + Terminal UI. Press Ctrl+, to open Settings, paste your API key. Press Alt+H for help.

$3

1. Create an agent using the interface
2. Send a message to start interacting
3. Enjoy autonomous AI assistance!

$3

`bash
loxia web # Start server + open Web UI in browser
loxia terminal # Start Terminal UI (server must be running)
loxia plus-terminal # Start server + Terminal UI together
loxia plus-web # Alias for 'web'
loxia --port 3000 # Use custom port (works with any command)
loxia --version # Show version
loxia --help # Show all options
`

---

🌐 Web Interface

The modern Web UI provides an intuitive interface for managing agents and conversations:

$3

- 💬 Chat Interface - Clean, responsive chat with markdown support
- 📁 File Attachments - Drag and drop files into conversations
- 🎛️ Agent Management - Create, switch, and manage multiple agents
- 📊 Real-Time Updates - Live agent status and output streaming
- 🎨 Model Selection - Switch between AI models on the fly
- 📝 Task Tracking - Visual task lists with progress indicators
- 🔍 Search & Filter - Find conversations and messages quickly
- 🌓 Modern UI - Built with React, TailwindCSS, and WebSockets

$3

Coming soon - the interface provides a clean, modern experience for interacting with AI agents

---

🔧 AI-Powered Tools

Loxia comes with 18+ specialized tools that agents can use autonomously:

$3

| Tool | Description | Key Features |
|------|-------------|--------------|
| 🖥️ Terminal | Execute shell commands | Background processes, stdin input, prompt detection |
| 📂 File System | File operations | Create, read, update, delete files and directories |
| 🌐 Browser | Web automation | Headless browsing, screenshots, scraping with Puppeteer |
| 🔍 Seek | Code search | Pattern matching, multi-directory support |
| 🌲 File Tree | Directory visualization | Tree structure generation, filtering |

$3

| Tool | Description | Key Features |
|------|-------------|--------------|
| 📦 Import Analyzer | Import/export analysis | ES6, CommonJS, circular dependencies, unused exports |
| 🔗 Dependency Resolver | Dependency management | Semantic versioning, conflict detection, upgrade paths |
| 🔬 Static Analysis | Code quality | ESLint, Prettier, TypeScript, Stylelint integration |
| 👯 Clone Detection | Code duplication | AST-based analysis, similarity scoring |
| 🔒 Security Scanner | Security audits | npm audit, dependency vulnerabilities, deployment checks |

$3

| Tool | Description | Key Features |
|------|-------------|--------------|
| 🖼️ Image Generator | AI image creation | Flux Pro support, high-quality outputs |
| 🎬 Video Generator | AI video creation | Azure OpenAI Sora integration, async processing |
| 📝 Task Manager | Task tracking | Todo lists, progress tracking, agent synchronization |
| 📡 Web Tool | HTTP requests | GET, POST, API testing, webhook debugging |
| 🔄 File Content Replace | Bulk replacements | Pattern-based, multi-file, preview changes |
| 💬 Agent Communication | Inter-agent messaging | Task delegation, collaborative workflows |

$3

| Tool | Description | Key Features |
|------|-------------|--------------|
| ⏸️ Agent Delay | Pause agent execution | Timed delays, background operation support |
| ✅ Job Done | Task completion | Mark autonomous work complete, exit to chat mode |
| 🔧 Async Tool Manager | Background task handling | Long-running operations, status tracking |
| 🔄 Loop Detection | Repetition prevention | Sliding window analysis, automatic termination |

---

📋 System Requirements

- Node.js: >= 16.0.0 (18.x or 20.x LTS recommended)
- npm: >= 7.0.0
- Operating System: Windows, macOS (Intel & Apple Silicon), Linux
- Memory: 2GB minimum, 4GB+ recommended
- Disk Space: 500MB for package and dependencies
- Shell: bash, zsh (macOS default), PowerShell, cmd

$3

For full functionality, install these tools:

`bash


Security scanning

npm install -g eslint prettier typescript stylelint

For development

npm install -g nodemon jest
`

---

🏗️ Architecture

$3

`
┌─────────────────────────────────────────────────┐
│ Client Interfaces │
│ ┌─────────────┐ ┌────────────────────────┐ │
│ │ Web UI │ │ CLI Interface │ │
│ │ (React) │ │ (Interactive Shell) │ │
│ └─────────────┘ └────────────────────────┘ │
└───────────────────┬─────────────────────────────┘
│ WebSocket / IPC
┌───────────▼──────────────┐
│ Orchestrator Service │
│ (Request Coordination) │
└────────┬────────┬────────┘
│ │
┌──────────▼──┐ ┌─▼──────────────┐
│ Agent Pool │ │ AI Service │
│ • Lifecycle │ │ • Model Router│
│ • Scheduling│ │ • Backend API │
└──────┬──────┘ └────────────────┘
│
┌──────▼──────────────────────┐
│ Message Processor │
│ • Tool Registry │
│ • Command Extraction │
│ • Execution Engine │
└─────────────────────────────┘
`

$3

- Orchestrator: Central coordination hub for all requests
- Agent Pool: Manages agent lifecycle, isolation, and communication
- Message Processor: Parses and executes tool commands from AI responses
- AI Service: Routes requests to appropriate AI backends
- State Manager: Persistent storage and session management
- Tool Registry: Extensible tool system with 18+ built-in tools

---

📖 Documentation

$3

- Installation Guide - Detailed installation and setup
- CLI Reference - Complete CLI command reference
- Tool Documentation - How to use each tool
- Configuration - Environment variables and settings

$3

- Architecture Overview - System design and components
- API Reference - Backend API specification
- Creating Tools - Build custom tools
- Contributing Guide - How to contribute

---

🔐 Security & Privacy

$3

- ✅ Agent Isolation - Each agent has isolated workspace and permissions
- ✅ Resource Limits - Prevents resource exhaustion (CPU, memory, commands)
- ✅ Path Validation - Prevents directory traversal attacks
- ✅ Command Sanitization - Protects against command injection
- ✅ Security Scanning - Built-in vulnerability detection
- ✅ Audit Logging - Comprehensive activity logs

$3

- 🔐 Authentication Only - Only credential verification communicates with servers
- 🏠 Local-First - All work data stays on your machine
- 🔒 No Usage Telemetry - No tracking or analytics of your work
- 📝 State Control - Full control over conversation history
- 🗑️ Easy Cleanup - Delete state directory to remove all local data
- ✅ Secure Communication - Authentication data protected during transmission

---

🎯 Use Cases

$3

`
✓ Code refactoring and modernization
✓ Dependency updates and conflict resolution
✓ Test generation and debugging
✓ Documentation generation
✓ Code review automation
`

$3

`
✓ Import/export dependency mapping
✓ Circular dependency detection
✓ Code duplication analysis
✓ Security vulnerability scanning
✓ Code quality assessment
`

$3

`
✓ Build and deployment scripts
✓ Batch file operations
✓ API testing and monitoring
✓ Web scraping and data collection
✓ Image generation workflows
`

---

📊 Performance

$3

- Agent Response Time: < 2s for simple queries
- Tool Execution: < 100ms overhead per tool
- Memory Usage: ~150-300MB per agent
- Concurrent Agents: Up to 10 agents per instance
- Message Processing: 1000+ messages/second
- Chat Scrolling: 60fps with 1000+ messages (virtualized rendering)

$3

Loxia automatically compacts long conversations to stay within token limits:

- Intelligent Summarization - Preserves context while reducing tokens
- Configurable Strategies - Aggressive or balanced compaction
- Index Tracking - References original message ranges for retrieval

---

🛣️ Roadmap

$3

- ✅ Teams - Organize agents into named teams with drag-and-drop
- ✅ Agent duplication - Clone agents with full configuration and optional conversation history
- ✅ Visual Flow Pipelines - Execute multi-agent workflows with real-time progress tracking
- ✅ Flow conversation clearing - Agents start with fresh context on each flow run
- ✅ Awaiting user input scheduling - Agents block on credentials/prompts without disappearing from other agents' radar
- ✅ Inter-agent reply defaults - requiresReply defaults to true for reliable agent-to-agent conversations
- ✅ Flow execution fixes - Progress indicators, completion detection, node count accuracy

$3

- ✅ Multi-agent orchestration with 18+ specialized tools
- ✅ Web UI + CLI interfaces with real-time streaming
- ✅ Conversation compaction with round-robin model selection
- ✅ File attachments, task management, and progress tracking
- ✅ Chat virtualization for smooth 60fps scrolling
- ✅ Full macOS compatibility with native zsh support
- ✅ Video and image generation (Sora, Flux Pro)
- ✅ Standalone binaries for Windows, macOS, and Linux
- ✅ API key persistence with AES-256-GCM encryption
- ✅ Structured file validation and security scanning

$3

- 🔄 VSCode Extension - Native IDE integration
- 🔄 Plugin System - Custom tool marketplace
- 🔄 Cloud Sync - Optional cloud backup (opt-in)
- 🔄 Voice Interface - Speech-to-text integration

---

🤝 Contributing

We welcome contributions! Here's how you can help:

$3

- 🐛 Report Bugs - Open an issue with reproduction steps
- 💡 Suggest Features - Share ideas for improvements
- 📝 Improve Documentation - Fix typos, add examples
- 🔧 Build Tools - Create new tools for the ecosystem
- 🎨 UI/UX - Enhance the Web interface

$3

`bash


Clone the repository

git clone https://github.com/loxia-ai/autopilot-cli-v10.git
cd autopilot-cli-v10

Install dependencies

npm install

Build Web UI

cd web-ui && npm install && npm run build && cd ..

Start in development mode

npm run dev
`

See CONTRIBUTING.md for detailed guidelines.

---

📜 License

Commercial License - see LICENSE file for complete terms.

$3

- 🔐 Authentication Required - Valid subscription or license needed to use
- ✅ Commercial Use - Use in your own projects and services (with active subscription)
- ✅ Modify Configuration - Customize settings and configuration files
- ❌ No Free Use - Requires active subscription or valid license
- ❌ No Credential Sharing - Personal credentials cannot be shared
- ❌ No Redistribution - Cannot resell, redistribute, or sublicense
- ❌ No Reverse Engineering - Code is obfuscated and protected
- ❌ No Derivative Products - Cannot create competing products

$3

- Registration: Sign up at autopilot.loxia.ai
- Authentication: Software requires valid API key to operate
- Verification: Periodic authentication checks with licensing server
- Expiration: Access ends when subscription expires (renewable)

Copyright © 2025-2026 Loxia AI. All rights reserved.

By installing or using this software, you agree to the terms of the LICENSE.

---

🆘 Support

$3

- 📖 Documentation: Check the docs directory
- 💬 Discussions: GitHub Discussions
- 🐛 Bug Reports: GitHub Issues
- 📧 Email: support@loxia.ai

$3

Web UI won't start?
`bash


Check if port is in use

lsof -i :8080

Use a different port

loxia --port 3000
`

Agent not responding?
`bash


Check logs

cat .loxia-state/logs/system.log

Restart with debug logging

LOXIA_LOG_LEVEL=debug loxia
`

Installation issues?
`bash


Clear npm cache

npm cache clean --force

Reinstall

npm install -g @loxia-labs/loxia-autopilot-one --force
`

macOS Installation

On macOS, you may need to use sudo for global installation:
`bash
sudo npm install -g @loxia-labs/loxia-autopilot-one
`

Or better, configure npm to use a user-writable directory:
`bash


Create a directory for global packages

mkdir ~/.npm-global

Configure npm to use it

npm config set prefix '~/.npm-global'

Add to your shell (zsh is default on macOS)

echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

Now install without sudo

npm install -g @loxia-labs/loxia-autopilot-one
`

macOS Python Scanners

If using Homebrew Python, security scanner installation will automatically detect it:
`bash


Verify with

which python3

Should show /opt/homebrew/bin/python3 (Apple Silicon) or /usr/local/bin/python3 (Intel)

``

---