onbuzz 3.3.0 → 3.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,11 +1,11 @@
1
1
  <div align="center">
2
2
 
3
- # Loxia Autopilot One
3
+ # Loxia OnBuzz
4
4
 
5
- **Autonomous AI Agent System for Software Development**
5
+ **Your AI Fleet**
6
6
 
7
- [![npm version](https://img.shields.io/npm/v/@loxia-labs/loxia-autopilot-one.svg?style=flat-square)](https://www.npmjs.com/package/@loxia-labs/loxia-autopilot-one)
8
- [![Node.js Version](https://img.shields.io/node/v/@loxia-labs/loxia-autopilot-one.svg?style=flat-square)](https://nodejs.org)
7
+ [![npm version](https://img.shields.io/npm/v/onbuzz.svg?style=flat-square)](https://www.npmjs.com/package/onbuzz)
8
+ [![Node.js Version](https://img.shields.io/node/v/onbuzz.svg?style=flat-square)](https://nodejs.org)
9
9
  [![License: Commercial](https://img.shields.io/badge/License-Commercial-blue.svg?style=flat-square)](./LICENSE)
10
10
 
11
11
  **[Quick Start](#-quick-start)** | **[Features](#-features)** | **[Documentation](#-documentation)** | **[Tools](#-ai-powered-tools)** | **[Web UI](#-web-interface)**
@@ -14,11 +14,11 @@
14
14
 
15
15
  ---
16
16
 
17
- ## What is Loxia Autopilot One?
17
+ ## What is Loxia OnBuzz?
18
18
 
19
- 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.
19
+ 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.
20
20
 
21
- ### Why Loxia?
21
+ ### Why OnBuzz?
22
22
 
23
23
  - **Multi-Agent Orchestration** - Run multiple AI agents simultaneously with isolated workspaces
24
24
  - **Rich Tool Ecosystem** - 18+ specialized tools for development, analysis, and automation
@@ -86,42 +86,41 @@ Loxia Autopilot One is a **production-ready autonomous AI agent system** that em
86
86
 
87
87
  ### 1. Create an Account
88
88
 
89
- Register at **[autopilot.loxia.ai](https://autopilot.loxia.ai)** to get started.
89
+ Register at **[onbuzz.loxia.ai](https://onbuzz.loxia.ai)** to get started.
90
90
 
91
91
  ### 2. Install the Package
92
92
 
93
93
  ```bash
94
- npm install -g @loxia-labs/loxia-autopilot-one
94
+ npm install -g onbuzz
95
95
  ```
96
96
 
97
97
  ### 3. Verify Installation
98
98
 
99
99
  ```bash
100
- loxia --version
101
- # Should display: Loxia Autopilot One v2.3.0
100
+ onbuzz --version
102
101
  ```
103
102
 
104
103
  ### 4. Create an API Key
105
104
 
106
- 1. Sign in at [autopilot.loxia.ai](https://autopilot.loxia.ai)
107
- 2. Navigate to [API Keys](https://autopilot.loxia.ai/api-keys)
105
+ 1. Sign in at [onbuzz.loxia.ai](https://onbuzz.loxia.ai)
106
+ 2. Navigate to [API Keys](https://onbuzz.loxia.ai/api-keys)
108
107
  3. Create a new API key and copy it
109
108
 
110
109
  ### 5. Launch & Configure
111
110
 
112
111
  #### Option A: Web UI
113
112
  ```bash
114
- loxia web
113
+ onbuzz web
115
114
  ```
116
115
  This starts the server and opens the Web UI in your browser. Go to **Settings** and paste your API key.
117
116
 
118
117
  #### Option B: Terminal UI
119
118
  ```bash
120
- loxia plus-terminal
119
+ onbuzz plus-terminal
121
120
  ```
122
121
  This starts the server + Terminal UI. Press `Ctrl+,` to open Settings, paste your API key. Press `Alt+H` for help.
123
122
 
124
- ### 6. Start Using Loxia
123
+ ### 6. Start Using OnBuzz
125
124
 
126
125
  1. **Create an agent** using the interface
127
126
  2. **Send a message** to start interacting
@@ -130,13 +129,13 @@ This starts the server + Terminal UI. Press `Ctrl+,` to open Settings, paste you
130
129
  ### CLI Reference
131
130
 
132
131
  ```bash
133
- loxia web # Start server + open Web UI in browser
134
- loxia terminal # Start Terminal UI (server must be running)
135
- loxia plus-terminal # Start server + Terminal UI together
136
- loxia plus-web # Alias for 'web'
137
- loxia --port 3000 # Use custom port (works with any command)
138
- loxia --version # Show version
139
- loxia --help # Show all options
132
+ onbuzz web # Start server + open Web UI in browser
133
+ onbuzz terminal # Start Terminal UI (server must be running)
134
+ onbuzz plus-terminal # Start server + Terminal UI together
135
+ onbuzz plus-web # Alias for 'web'
136
+ onbuzz --port 3000 # Use custom port (works with any command)
137
+ onbuzz --version # Show version
138
+ onbuzz --help # Show all options
140
139
  ```
141
140
 
142
141
  ---
@@ -160,7 +159,7 @@ The modern Web UI provides an intuitive interface for managing agents and conver
160
159
 
161
160
  ## AI-Powered Tools
162
161
 
163
- Loxia comes with 18+ specialized tools that agents can use autonomously:
162
+ OnBuzz comes with 18+ specialized tools that agents can use autonomously:
164
163
 
165
164
  ### Development Tools
166
165
 
@@ -247,31 +246,6 @@ Loxia comes with 18+ specialized tools that agents can use autonomously:
247
246
  +----------------------------------+
248
247
  ```
249
248
 
250
- ### Key Components
251
-
252
- - **Orchestrator**: Central coordination hub for all requests
253
- - **Agent Pool**: Manages agent lifecycle, isolation, and communication
254
- - **Message Processor**: Parses and executes tool commands from AI responses
255
- - **AI Service**: Routes requests to appropriate AI backends
256
- - **State Manager**: Persistent storage and session management
257
- - **Tool Registry**: Extensible tool system with 18+ built-in tools
258
-
259
- ---
260
-
261
- ## Documentation
262
-
263
- ### For Users
264
-
265
- - **[Installation Guide](./INSTALLATION.md)** - Detailed installation and setup
266
- - **[Tool Documentation](./docs/CREATING_TOOLS.md)** - How to use and create tools
267
- - **[Architecture Docs](./docs/README.md)** - Interactive architecture diagrams
268
-
269
- ### For Developers
270
-
271
- - **[Architecture Overview](./docs/architecture/)** - System design and components
272
- - **[API Agent Capabilities](./docs/API-AGENT-CAPABILITIES.md)** - Agent API reference
273
- - **[Creating Tools](./docs/CREATING_TOOLS.md)** - Build custom tools
274
-
275
249
  ---
276
250
 
277
251
  ## Security & Privacy
@@ -295,66 +269,6 @@ Loxia comes with 18+ specialized tools that agents can use autonomously:
295
269
 
296
270
  ---
297
271
 
298
- ## Roadmap
299
-
300
- ### Current Version (2.2.5)
301
-
302
- - Two-layer tool descriptions: compact index + on-demand full docs via Help tool
303
- - Document creation tools: DOCX (Word) and Excel read/create support
304
- - PDF creation: HTML to PDF via Puppeteer with full CSS support
305
- - Tool result turn tracking: batched results grouped by turn with manifest headers
306
- - Unified `MAX_OUTPUT_TOKENS` constant (10,000) shared by aiService and compaction check
307
- - Compaction: preserve recent achievements, file paths, meaningful tool outcomes; 8K summary tokens
308
-
309
- ### v2.0.6
310
- - Tool path sync: terminal `cd` now propagates to all tools (filesystem, seek, pdf, etc.)
311
- - Streaming performance: chunk batching, incremental parser, reduced overscan
312
- - WebSocket log suppression for high-frequency stream chunks
313
-
314
- ### Previous Versions
315
-
316
- - v2.0.2: Compaction system rewrite, SSE stream parser fix, token usage tracking
317
- - v2.0.0: System port protection, UI responsiveness fixes, model error handling
318
- - v1.9.x: Port registry fix, startup timeout fix, agent creation UX, flow agent visibility
319
- - v1.8.0: Teams, agent duplication, flow execution, awaiting user input scheduling
320
- - v1.6.x: JSON repair, filesystem hardening, streaming abort, stop button visibility
321
- - v1.5.0: Dynamic version display, tool builtin delay, compaction indicator redesign
322
- - v1.4.x: Parallel agent processing, streaming response display, smart auto-scroll
323
- - v1.3.x: Binary distribution, video tool (Sora), PDF tool, API key persistence
324
- - v1.2.x: Full macOS compatibility, help modal, keyboard shortcuts
325
- - v1.1.x: Multi-agent orchestration, 18+ tools, conversation compaction
326
-
327
- ### Upcoming Features
328
-
329
- - **VSCode Extension** - Native IDE integration
330
- - **Plugin System** - Custom tool marketplace
331
- - **Cloud Sync** - Optional cloud backup (opt-in)
332
-
333
- ---
334
-
335
- ## Contributing
336
-
337
- We welcome contributions! See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.
338
-
339
- ### Development Setup
340
-
341
- ```bash
342
- # Clone the repository
343
- git clone https://github.com/loxia-ai/autopilot-cli-v10.git
344
- cd autopilot-cli-v10
345
-
346
- # Install dependencies
347
- npm install
348
-
349
- # Build Web UI
350
- cd web-ui && npm install && npm run build && cd ..
351
-
352
- # Start in development mode
353
- npm run dev
354
- ```
355
-
356
- ---
357
-
358
272
  ## License
359
273
 
360
274
  **Commercial License** - see [LICENSE](./LICENSE) file for complete terms.
@@ -364,15 +278,14 @@ npm run dev
364
278
  - **No Free Use** - Requires active subscription or valid license
365
279
  - **No Redistribution** - Cannot resell, redistribute, or sublicense
366
280
 
367
- **Copyright (c) 2025-2026 Loxia AI. All rights reserved.**
281
+ **Copyright (c) 2025-2026 Loxia Labs LLC. All rights reserved.**
368
282
 
369
283
  ---
370
284
 
371
285
  ## Support
372
286
 
373
287
  - **Documentation**: Check the [docs](./docs/) directory
374
- - **Bug Reports**: [GitHub Issues](https://github.com/loxia-ai/autopilot-cli-v10/issues)
375
- - **Email**: support@loxia.ai
288
+ - **Email**: contact@loxia.ai
376
289
 
377
290
  ### Troubleshooting
378
291
 
@@ -382,7 +295,7 @@ npm run dev
382
295
  lsof -i :8080
383
296
 
384
297
  # Use a different port
385
- loxia --port 3000
298
+ onbuzz --port 3000
386
299
  ```
387
300
 
388
301
  **Agent not responding?**
@@ -391,7 +304,7 @@ loxia --port 3000
391
304
  cat .loxia-state/logs/system.log
392
305
 
393
306
  # Restart with debug logging
394
- LOXIA_LOG_LEVEL=debug loxia
307
+ LOXIA_LOG_LEVEL=debug onbuzz
395
308
  ```
396
309
 
397
310
  **Installation issues?**
@@ -400,7 +313,7 @@ LOXIA_LOG_LEVEL=debug loxia
400
313
  npm cache clean --force
401
314
 
402
315
  # Reinstall
403
- npm install -g @loxia-labs/loxia-autopilot-one --force
316
+ npm install -g onbuzz --force
404
317
  ```
405
318
 
406
319
  **macOS Installation**
@@ -411,15 +324,15 @@ mkdir ~/.npm-global
411
324
  npm config set prefix '~/.npm-global'
412
325
  echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
413
326
  source ~/.zshrc
414
- npm install -g @loxia-labs/loxia-autopilot-one
327
+ npm install -g onbuzz
415
328
  ```
416
329
 
417
330
  ---
418
331
 
419
332
  <div align="center">
420
333
 
421
- **Made with care by the Loxia team**
334
+ **Made with care by the Loxia Labs LLC team**
422
335
 
423
- [Website](https://loxia.ai) | [Twitter](https://twitter.com/loxia_ai)
336
+ [Website](https://loxia.ai)
424
337
 
425
338
  </div>
@@ -0,0 +1,338 @@
1
+ <div align="center">
2
+
3
+ # {{FULL_PRODUCT_NAME}}
4
+
5
+ **{{TAGLINE}}**
6
+
7
+ [![npm version](https://img.shields.io/npm/v/{{NPM_PACKAGE}}.svg?style=flat-square)](https://www.npmjs.com/package/{{NPM_PACKAGE}})
8
+ [![Node.js Version](https://img.shields.io/node/v/{{NPM_PACKAGE}}.svg?style=flat-square)](https://nodejs.org)
9
+ [![License: Commercial](https://img.shields.io/badge/License-Commercial-blue.svg?style=flat-square)](./LICENSE)
10
+
11
+ **[Quick Start](#-quick-start)** | **[Features](#-features)** | **[Documentation](#-documentation)** | **[Tools](#-ai-powered-tools)** | **[Web UI](#-web-interface)**
12
+
13
+ </div>
14
+
15
+ ---
16
+
17
+ ## What is {{FULL_PRODUCT_NAME}}?
18
+
19
+ {{FULL_PRODUCT_NAME}} 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.
20
+
21
+ ### Why {{PRODUCT_NAME}}?
22
+
23
+ - **Multi-Agent Orchestration** - Run multiple AI agents simultaneously with isolated workspaces
24
+ - **Rich Tool Ecosystem** - 18+ specialized tools for development, analysis, and automation
25
+ - **Dual Interface** - Modern Web UI + powerful CLI for any workflow
26
+ - **Real-Time Monitoring** - Track agent activity, costs, and performance
27
+ - **Persistent State** - Resume conversations and continue work across sessions
28
+ - **Secure by Design** - Agent isolation, resource limits, and security scanning
29
+
30
+ ---
31
+
32
+ ## Features
33
+
34
+ ### Core Capabilities
35
+
36
+ <table>
37
+ <tr>
38
+ <td width="50%">
39
+
40
+ #### Intelligent Agent System
41
+ - Multi-agent conversation orchestration
42
+ - Automatic model selection and routing
43
+ - Task-based agent specialization
44
+ - Inter-agent communication
45
+ - Background task management
46
+
47
+ </td>
48
+ <td width="50%">
49
+
50
+ #### Professional Tooling
51
+ - Terminal command execution
52
+ - File system operations
53
+ - Web browsing and scraping
54
+ - Image generation (DALL-E, Flux)
55
+ - Code analysis and refactoring
56
+
57
+ </td>
58
+ </tr>
59
+ <tr>
60
+ <td width="50%">
61
+
62
+ #### Development Features
63
+ - Import/export analysis
64
+ - Dependency resolution
65
+ - Static code analysis
66
+ - Clone detection
67
+ - Security scanning
68
+
69
+ </td>
70
+ <td width="50%">
71
+
72
+ #### Smart Assistance
73
+ - Context-aware responses
74
+ - File attachments in chat
75
+ - Conversation compaction
76
+ - Task management
77
+ - Progress tracking
78
+
79
+ </td>
80
+ </tr>
81
+ </table>
82
+
83
+ ---
84
+
85
+ ## Quick Start
86
+
87
+ ### 1. Create an Account
88
+
89
+ Register at **[{{DOMAIN}}](https://{{DOMAIN}})** to get started.
90
+
91
+ ### 2. Install the Package
92
+
93
+ ```bash
94
+ {{INSTALL_COMMAND}}
95
+ ```
96
+
97
+ ### 3. Verify Installation
98
+
99
+ ```bash
100
+ {{CLI_COMMAND}} --version
101
+ ```
102
+
103
+ ### 4. Create an API Key
104
+
105
+ 1. Sign in at [{{DOMAIN}}](https://{{DOMAIN}})
106
+ 2. Navigate to [API Keys](https://{{DOMAIN}}/api-keys)
107
+ 3. Create a new API key and copy it
108
+
109
+ ### 5. Launch & Configure
110
+
111
+ #### Option A: Web UI
112
+ ```bash
113
+ {{CLI_COMMAND}} web
114
+ ```
115
+ This starts the server and opens the Web UI in your browser. Go to **Settings** and paste your API key.
116
+
117
+ #### Option B: Terminal UI
118
+ ```bash
119
+ {{CLI_COMMAND}} plus-terminal
120
+ ```
121
+ This starts the server + Terminal UI. Press `Ctrl+,` to open Settings, paste your API key. Press `Alt+H` for help.
122
+
123
+ ### 6. Start Using {{PRODUCT_NAME}}
124
+
125
+ 1. **Create an agent** using the interface
126
+ 2. **Send a message** to start interacting
127
+ 3. **Enjoy** autonomous AI assistance!
128
+
129
+ ### CLI Reference
130
+
131
+ ```bash
132
+ {{CLI_COMMAND}} web # Start server + open Web UI in browser
133
+ {{CLI_COMMAND}} terminal # Start Terminal UI (server must be running)
134
+ {{CLI_COMMAND}} plus-terminal # Start server + Terminal UI together
135
+ {{CLI_COMMAND}} plus-web # Alias for 'web'
136
+ {{CLI_COMMAND}} --port 3000 # Use custom port (works with any command)
137
+ {{CLI_COMMAND}} --version # Show version
138
+ {{CLI_COMMAND}} --help # Show all options
139
+ ```
140
+
141
+ ---
142
+
143
+ ## Web Interface
144
+
145
+ The modern Web UI provides an intuitive interface for managing agents and conversations:
146
+
147
+ ### Key Features
148
+
149
+ - **Chat Interface** - Clean, responsive chat with markdown support
150
+ - **File Attachments** - Drag and drop files into conversations
151
+ - **Agent Management** - Create, switch, and manage multiple agents
152
+ - **Real-Time Updates** - Live agent status and output streaming
153
+ - **Model Selection** - Switch between AI models on the fly
154
+ - **Task Tracking** - Visual task lists with progress indicators
155
+ - **Search & Filter** - Find conversations and messages quickly
156
+ - **Modern UI** - Built with React, TailwindCSS, and WebSockets
157
+
158
+ ---
159
+
160
+ ## AI-Powered Tools
161
+
162
+ {{PRODUCT_NAME}} comes with 18+ specialized tools that agents can use autonomously:
163
+
164
+ ### Development Tools
165
+
166
+ | Tool | Description | Key Features |
167
+ |------|-------------|--------------|
168
+ | **Terminal** | Execute shell commands | Background processes, stdin input, prompt detection |
169
+ | **File System** | File operations | Create, read, update, delete files and directories |
170
+ | **Browser** | Web automation | Headless browsing, screenshots, scraping with Puppeteer |
171
+ | **Seek** | Code search | Pattern matching, multi-directory support |
172
+ | **File Tree** | Directory visualization | Tree structure generation, filtering |
173
+
174
+ ### Analysis Tools
175
+
176
+ | Tool | Description | Key Features |
177
+ |------|-------------|--------------|
178
+ | **Import Analyzer** | Import/export analysis | ES6, CommonJS, circular dependencies, unused exports |
179
+ | **Dependency Resolver** | Dependency management | Semantic versioning, conflict detection, upgrade paths |
180
+ | **Static Analysis** | Code quality | ESLint, Prettier, TypeScript, Stylelint integration |
181
+ | **Clone Detection** | Code duplication | AST-based analysis, similarity scoring |
182
+ | **Security Scanner** | Security audits | npm audit, dependency vulnerabilities, deployment checks |
183
+
184
+ ### AI & Automation Tools
185
+
186
+ | Tool | Description | Key Features |
187
+ |------|-------------|--------------|
188
+ | **Image Generator** | AI image creation | Flux Pro support, high-quality outputs |
189
+ | **Video Generator** | AI video creation | Azure OpenAI Sora integration, async processing |
190
+ | **Task Manager** | Task tracking | Todo lists, progress tracking, agent synchronization |
191
+ | **Web Tool** | HTTP requests | GET, POST, API testing, webhook debugging |
192
+ | **File Content Replace** | Bulk replacements | Pattern-based, multi-file, preview changes |
193
+ | **Agent Communication** | Inter-agent messaging | Task delegation, collaborative workflows |
194
+
195
+ ### System Tools
196
+
197
+ | Tool | Description | Key Features |
198
+ |------|-------------|--------------|
199
+ | **Agent Delay** | Pause agent execution | Timed delays, background operation support |
200
+ | **Job Done** | Task completion | Mark autonomous work complete, exit to chat mode |
201
+ | **Async Tool Manager** | Background task handling | Long-running operations, status tracking |
202
+ | **Loop Detection** | Repetition prevention | Sliding window analysis, automatic termination |
203
+
204
+ ---
205
+
206
+ ## System Requirements
207
+
208
+ - **Node.js**: >= 20.0.0 (20.x LTS recommended)
209
+ - **npm**: >= 7.0.0
210
+ - **Operating System**: Windows, macOS (Intel & Apple Silicon), Linux
211
+ - **Memory**: 2GB minimum, 4GB+ recommended
212
+ - **Disk Space**: 500MB for package and dependencies
213
+ - **Shell**: bash, zsh (macOS default), PowerShell, cmd
214
+
215
+ ---
216
+
217
+ ## Architecture
218
+
219
+ ### High-Level Overview
220
+
221
+ ```
222
+ +--------------------------------------------------+
223
+ | Client Interfaces |
224
+ | +-------------+ +-------------------------+ |
225
+ | | Web UI | | CLI Interface | |
226
+ | | (React) | | (Interactive Shell) | |
227
+ | +-------------+ +-------------------------+ |
228
+ +------------------------+-------------------------+
229
+ | WebSocket / IPC
230
+ +-------------v--------------+
231
+ | Orchestrator Service |
232
+ | (Request Coordination) |
233
+ +---------+--------+--------+
234
+ | |
235
+ +----------v--+ +--v--------------+
236
+ | Agent Pool | | AI Service |
237
+ | - Lifecycle | | - Model Router |
238
+ | - Scheduling| | - Backend API |
239
+ +------+------+ +-----------------+
240
+ |
241
+ +------v--------------------------+
242
+ | Message Processor |
243
+ | - Tool Registry |
244
+ | - Command Extraction |
245
+ | - Execution Engine |
246
+ +----------------------------------+
247
+ ```
248
+
249
+ ---
250
+
251
+ ## Security & Privacy
252
+
253
+ ### Built-In Security Features
254
+
255
+ - **Agent Isolation** - Each agent has isolated workspace and permissions
256
+ - **Resource Limits** - Prevents resource exhaustion (CPU, memory, commands)
257
+ - **Path Validation** - Prevents directory traversal attacks
258
+ - **Command Sanitization** - Protects against command injection
259
+ - **Security Scanning** - Built-in vulnerability detection
260
+ - **Audit Logging** - Comprehensive activity logs
261
+
262
+ ### Privacy
263
+
264
+ - **Authentication Only** - Only credential verification communicates with servers
265
+ - **Local-First** - All work data stays on your machine
266
+ - **No Usage Telemetry** - No tracking or analytics of your work
267
+ - **State Control** - Full control over conversation history
268
+ - **Easy Cleanup** - Delete state directory to remove all local data
269
+
270
+ ---
271
+
272
+ ## License
273
+
274
+ **Commercial License** - see [LICENSE](./LICENSE) file for complete terms.
275
+
276
+ - **Authentication Required** - Valid subscription or license needed to use
277
+ - **Commercial Use** - Use in your own projects and services (with active subscription)
278
+ - **No Free Use** - Requires active subscription or valid license
279
+ - **No Redistribution** - Cannot resell, redistribute, or sublicense
280
+
281
+ **Copyright (c) 2025-2026 {{LEGAL_COMPANY}}. All rights reserved.**
282
+
283
+ ---
284
+
285
+ ## Support
286
+
287
+ - **Documentation**: Check the [docs](./docs/) directory
288
+ - **Email**: {{CONTACT_EMAIL}}
289
+
290
+ ### Troubleshooting
291
+
292
+ **Web UI won't start?**
293
+ ```bash
294
+ # Check if port is in use
295
+ lsof -i :8080
296
+
297
+ # Use a different port
298
+ {{CLI_COMMAND}} --port 3000
299
+ ```
300
+
301
+ **Agent not responding?**
302
+ ```bash
303
+ # Check logs
304
+ cat .loxia-state/logs/system.log
305
+
306
+ # Restart with debug logging
307
+ LOXIA_LOG_LEVEL=debug {{CLI_COMMAND}}
308
+ ```
309
+
310
+ **Installation issues?**
311
+ ```bash
312
+ # Clear npm cache
313
+ npm cache clean --force
314
+
315
+ # Reinstall
316
+ {{INSTALL_COMMAND}} --force
317
+ ```
318
+
319
+ **macOS Installation**
320
+
321
+ On macOS, configure npm to use a user-writable directory:
322
+ ```bash
323
+ mkdir ~/.npm-global
324
+ npm config set prefix '~/.npm-global'
325
+ echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
326
+ source ~/.zshrc
327
+ {{INSTALL_COMMAND}}
328
+ ```
329
+
330
+ ---
331
+
332
+ <div align="center">
333
+
334
+ **Made with care by the {{LEGAL_COMPANY}} team**
335
+
336
+ [Website](https://{{WEBSITE}})
337
+
338
+ </div>
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "onbuzz",
3
- "version": "3.3.0",
4
- "description": "Loxia OnBuzz Your AI Fleet",
3
+ "version": "3.4.0",
4
+ "description": "Loxia OnBuzz - Your AI Fleet",
5
5
  "type": "module",
6
6
  "main": "src/index.js",
7
7
  "bin": {
@@ -24,7 +24,7 @@
24
24
  "build:binary:linux": "pkg . --target node20-linux-x64 --output dist/loxia-linux --compress GZip",
25
25
  "docs": "jsdoc -c jsdoc.config.json",
26
26
  "postinstall": "node scripts/install-scanners.js",
27
- "prepublishOnly": "npm run build"
27
+ "generate-readme": "node scripts/generate-readme.js"
28
28
  },
29
29
  "keywords": [
30
30
  "ai",
@@ -0,0 +1,60 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * Generate branded README.md from README.template.md
4
+ *
5
+ * Usage:
6
+ * node scripts/generate-readme.js autopilot
7
+ * node scripts/generate-readme.js onbuzz
8
+ * VITE_BRAND=onbuzz node scripts/generate-readme.js
9
+ */
10
+
11
+ import { readFileSync, writeFileSync } from 'fs';
12
+ import { dirname, join } from 'path';
13
+ import { fileURLToPath } from 'url';
14
+
15
+ const __dirname = dirname(fileURLToPath(import.meta.url));
16
+ const root = join(__dirname, '..');
17
+
18
+ const BRANDS = {
19
+ autopilot: {
20
+ FULL_PRODUCT_NAME: 'Loxia Autopilot',
21
+ PRODUCT_NAME: 'Autopilot',
22
+ TAGLINE: 'Break All Barriers',
23
+ NPM_PACKAGE: '@loxia-labs/loxia-autopilot-one',
24
+ INSTALL_COMMAND: 'npm install -g @loxia-labs/loxia-autopilot-one',
25
+ CLI_COMMAND: 'loxia',
26
+ DOMAIN: 'autopilot.loxia.ai',
27
+ WEBSITE: 'loxia.ai',
28
+ CONTACT_EMAIL: 'contact@loxia.ai',
29
+ LEGAL_COMPANY: 'Loxia Labs LLC',
30
+ },
31
+ onbuzz: {
32
+ FULL_PRODUCT_NAME: 'Loxia OnBuzz',
33
+ PRODUCT_NAME: 'OnBuzz',
34
+ TAGLINE: 'Your AI Fleet',
35
+ NPM_PACKAGE: 'onbuzz',
36
+ INSTALL_COMMAND: 'npm install -g onbuzz',
37
+ CLI_COMMAND: 'onbuzz',
38
+ DOMAIN: 'onbuzz.loxia.ai',
39
+ WEBSITE: 'loxia.ai',
40
+ CONTACT_EMAIL: 'contact@loxia.ai',
41
+ LEGAL_COMPANY: 'Loxia Labs LLC',
42
+ },
43
+ };
44
+
45
+ const brand = process.argv[2] || process.env.VITE_BRAND || 'autopilot';
46
+ const vars = BRANDS[brand];
47
+
48
+ if (!vars) {
49
+ console.error(`Unknown brand: ${brand}. Use: autopilot | onbuzz`);
50
+ process.exit(1);
51
+ }
52
+
53
+ let template = readFileSync(join(root, 'README.template.md'), 'utf8');
54
+
55
+ for (const [key, value] of Object.entries(vars)) {
56
+ template = template.replaceAll(`{{${key}}}`, value);
57
+ }
58
+
59
+ writeFileSync(join(root, 'README.md'), template);
60
+ console.log(`✅ README.md generated for ${brand}`);