Package Exports

onbuzz
onbuzz/src/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (onbuzz) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Loxia OnBuzz

Your AI Fleet

Quick Start | Features | Documentation | Tools | Web UI

What is Loxia OnBuzz?

Loxia OnBuzz 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.

Why OnBuzz?

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

Core Capabilities

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

1. Create an Account

2. Install the Package

npm install -g onbuzz

3. Verify Installation

onbuzz --version

4. Create an API Key

Sign in at onbuzz.loxia.ai
Navigate to API Keys
Create a new API key and copy it

5. Launch & Configure

Option A: Web UI

onbuzz 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

onbuzz plus-terminal

This starts the server + Terminal UI. Press Ctrl+, to open Settings, paste your API key. Press Alt+H for help.

6. Start Using OnBuzz

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

CLI Reference

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

Web Interface

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

Key Features

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

AI-Powered Tools

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

Development Tools

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

Analysis Tools

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

AI & Automation Tools

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

System Tools

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: >= 20.0.0 (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

Architecture

High-Level Overview

+--------------------------------------------------+
|               Client Interfaces                  |
|  +-------------+  +-------------------------+   |
|  |   Web UI    |  |     CLI Interface       |   |
|  |  (React)    |  |  (Interactive Shell)    |   |
|  +-------------+  +-------------------------+   |
+------------------------+-------------------------+
                         | WebSocket / IPC
           +-------------v--------------+
           |   Orchestrator Service     |
           |  (Request Coordination)    |
           +---------+--------+--------+
                     |        |
          +----------v--+  +--v--------------+
          | Agent Pool  |  |  AI Service     |
          | - Lifecycle |  |  - Model Router |
          | - Scheduling|  |  - Backend API  |
          +------+------+  +-----------------+
                 |
          +------v--------------------------+
          |   Message Processor             |
          |   - Tool Registry               |
          |   - Command Extraction          |
          |   - Execution Engine            |
          +----------------------------------+

Security & Privacy

Built-In Security Features

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

Privacy

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

License

Commercial License - see LICENSE file for complete terms.

Authentication Required - Valid subscription or license needed to use
Commercial Use - Use in your own projects and services (with active subscription)
No Free Use - Requires active subscription or valid license
No Redistribution - Cannot resell, redistribute, or sublicense

Support

Documentation: Check the docs directory
Email: contact@loxia.ai

Troubleshooting

Web UI won't start?

# Check if port is in use
lsof -i :8080

# Use a different port
onbuzz --port 3000

Agent not responding?

# Check logs
cat .loxia-state/logs/system.log

# Restart with debug logging
LOXIA_LOG_LEVEL=debug onbuzz

Installation issues?

# Clear npm cache
npm cache clean --force

# Reinstall
npm install -g onbuzz --force

macOS Installation

On macOS, configure npm to use a user-writable directory:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc
npm install -g onbuzz

Made with care by the Loxia Labs LLC team

Website