A-Z Features
Comprehensive feature inventory for the QuoxCORE verifiable AI operations platform.
Comprehensive, structured feature list for the QuoxCORE verifiable AI operations platform. All counts and descriptions are from the current codebase.
At a Glance
| Metric | Count |
|---|
| Plugins | 26 (4 tiers) |
| AI Agents | 49 specialist agent personas |
| Services | 14 (5 critical) |
| Application Routes | 106 |
| LLM Providers | 9 (43+ models) |
| Visualizer Themes | 13 |
| Cognitive Implants | 14 |
| Open Protocol Specs | 4 (AEE, AOCL, VOLT, WARD) |
| Workflow Templates | 1,340+ indexed |
| MCP Tools | 83+ |
1. Plugin System
QuoxCORE uses a plugin architecture. Each plugin is independently activated, licence-validated, and scoped to a tier. Plugins gate features, agents, routes, and sidebar entries.
Plugin Registry (26 Plugins)
| Plugin | Tier | Price | Description |
|---|
| Prompts Library | Standard | Included | Curated prompt templates with categories, search, and favourites |
| Core Communications | Standard | Included | Telegram, Slack, Discord, and email alert channels |
| Advanced Memory | Pro | $99 | Semantic search, style engine, belief memory, failure memory, ChatGPT import |
| Advanced Voice | Standard | Included | ElevenLabs TTS, Whisper STT, push-to-talk, per-agent voice assignment |
| Files | Standard | Included | File storage, folder organisation, scoped chat, ARCHIVIST skills |
| Uptime Kuma | Standard | Included | Availability monitoring integration with dashboard widgets |
| Grafana | Standard | Included | Metrics dashboard embedding and alert forwarding |
| Prometheus | Standard | Included | Metric scraping, PromQL queries, alert rules |
| Proxmox | Standard | Included | VM and LXC management, resource monitoring, console access |
| QuoxAgent Fleet | Standard | Included | Host monitoring daemon, heartbeat aggregation, fleet dashboard |
| Bastion Fleet | Standard | Included | SSH gateway management, session recording, access control |
| Cognitive Topology | Standard | Included | Neural-style system health visualisation with implant mapping |
| AOCL Compliance Suite | Enterprise | $599/yr | Trace replay, multi-agent correlation, SOC2/HIPAA/GDPR/ISO 27001 exports |
| AOCL Developer Kit | Standard | Included | Developer tools for AOCL layer inspection and envelope debugging |
| Backup & Restore | Standard | Included | Scheduled backups, one-click restore, pre-update snapshots |
| System Maintenance | Standard | Included | Version tracking, one-click updates, rolling restarts, rollback |
| MikroTik RouterOS | Standard | Included | RouterOS API integration, NETWATCH agent, firewall management |
| Workflow Library | Standard | Included | 1,340+ indexed workflow templates with search and 1-click import |
| Web Terminal | Standard | $20 | Multi-pane terminal, AI chat, error detection, vim keybindings |
| Action Tracker | Standard | Included | Track commitments, follow-ups, and action items across conversations |
| Codebase Mirror | Standard | Included | AI-readable code indexing with repo maps and dependency graphs |
| OpsDeck | Standard | Included | Unified operations dashboard with customisable widget grid |
| Wazuh | Standard | Included | SIEM integration, security event correlation, compliance reporting |
| Docker Fleet | Standard | Included | Multi-host container management with DOCKULA agent |
| Decision Evidence | Standard | Included | AI decision rationale capture, evidence storage, VOLT recording |
| Local Inference | Standard | Included | Ollama, vLLM, llama.cpp, NIM backend support for local models |
Plugin Tiers
| Tier | Included | Audience |
|---|
| Free | Core functionality | All users |
| Standard | Most plugins | Licensed users |
| Pro | Advanced Memory | Power users |
| Enterprise | AOCL Compliance Suite | Regulated industries |
2. AI Agents
QuoxCORE runs a flat two-tier agent hierarchy. CommanderQ is the orchestrator (level 0). All specialist agents are level 1 and receive delegated queries via the smart router.
Agent Registry (49 Agents total; this table lists the core roster)
| Agent | Domain | Role | Description |
|---|
| CommanderQ | Coordination | Orchestrator | Routes queries, coordinates multi-agent tasks, manages conversation context |
| SENTINEL | Security | Manager | Threat detection, compliance audits, access control, vulnerability assessment |
| CIPHER | Network | Manager | Connectivity diagnostics, DNS, routing, firewall rules, MikroTik RouterOS |
| NOVA | DevOps | Manager | Servers, VMs, containers, resource provisioning, deployment |
| PRISM | Analysis | Analyst | Pattern detection, data classification, cross-referencing, anomaly identification |
| ATLAS | Virtualisation | Specialist | Proxmox VE management, VM lifecycle, resource allocation |
| METRICS | Monitoring | Specialist | Prometheus, Grafana, metric analysis, alert triage |
| INSIGHT | Visualisation | Specialist | Data visualisation, dashboard creation, trend analysis |
| SCHOLAR | Research | Specialist | Technical research, documentation lookup, knowledge synthesis |
| BEACON | Availability | Specialist | Uptime monitoring, SLA tracking, incident response |
| FORGE | Engineering | Specialist | Code generation, scripts, infrastructure-as-code, configuration |
| COREY | Core Systems | Specialist | Self-diagnostics, cognitive topology, plugin status, health checks |
| TESTER | Quality Assurance | Specialist | Test execution, regression detection, quality metrics |
| NANOBANANA | Image Generation | Specialist | AI image generation and visual content creation |
| GEMINI | Review & Synthesis | Specialist | Cross-model review, synthesis, second-opinion analysis (Google Gemini) |
| ARCHIVIST | Files | Specialist | Document intelligence, summarisation, comparison, data extraction (plugin-gated) |
| NETWATCH | Network Infra | Specialist | MikroTik RouterOS monitoring and management (plugin-gated) |
Additional specialist agents registered by plugins:
| Agent | Plugin | Domain |
|---|
| PERPLEXITY | Core | Web research via Perplexity API |
| QUOXCODE | Web Terminal | Interactive shell operations, error diagnosis |
| DOCKULA | Docker Fleet | Multi-host container management |
Agent Features
- Smart routing: Natural language queries automatically routed to the correct specialist
- Multi-agent delegation: CommanderQ can invoke multiple specialists for complex queries
- Per-agent memory: Each agent maintains its own conversation context and learned facts
- Per-agent visualiser: 13 canvas-based themes assigned per agent (see Visualisations)
- Per-agent voice: ElevenLabs voice assignment with verbosity modes (quiet/normal/verbose)
- Per-agent model: Each agent can use a different LLM (Claude, GPT, Gemini, local)
3. Memory System
Six memory types with tiered access. Free tier uses keyword search. Premium tier adds semantic (vector) search via Qdrant.
Memory Types
| Type | Storage | Purpose |
|---|
| Episodic | SQLite + FTS5 | Full conversation history with timestamps and correlation IDs |
| Semantic | Qdrant vectors | Facts, preferences, learned knowledge (AI-searchable by meaning) |
| Entity | SQLite + FTS5 | Infrastructure knowledge: hosts, IPs, services, containers, relationships |
| Working Set | In-memory | Active context ("AI's RAM"): current task, open loops, recent entities |
| Belief | SQLite | Agent beliefs and confidence levels (premium) |
| Failure | SQLite | Error patterns, past failures, remediation history (premium) |
Memory Tiers
| Feature | Free | Premium |
|---|
| Learned items | 10 max | Unlimited |
| Episodic items | 20 max | Unlimited |
| Preferences | 3 max | Unlimited |
| Context tokens | 500 | 4,000+ |
| Search | Keyword only | Semantic (vector) |
| Style Engine | No | Yes |
| Belief Memory | No | Yes |
| Failure Memory | No | Yes |
| ChatGPT Import | No | Yes |
| Memory Visualisation | No | Yes |
Key Capabilities
- Explicit storage: "Remember that production uses port 8443" stores with high priority
- Auto-extraction: Entity and preference extraction from natural conversation
- Working Set Memory (WSM): Focused context window for the current task
- Cross-session persistence: Memory survives browser refresh, container restart, and redeployment
- Per-agent scoping: Each agent can access shared memory plus its own private store
4. Chat Pipeline
Three execution paths through the collector service, selected automatically based on available authentication.
Execution Paths
| Path | Auth Method | Mechanism | Latency | Tool Support |
|---|
| PATH 1 | API Key | Anthropic Messages API | 3-8s | Native tool_use |
| PATH 2A | OAuth + MCP | Claude CLI with MCP server | 5-12s | MCP tools (83+) |
| PATH 2B | OAuth (legacy) | Regex pre-execution | 8-20s | Pattern matching |
Chat Features
- Streaming responses: Server-sent events for real-time token delivery
- Voice input: Whisper transcription with push-to-talk
- Voice output: ElevenLabs text-to-speech with per-agent voice assignment
- Tool execution: Infrastructure tools run in-context (SSH, Docker, API calls)
- Voice summary: Separate concise summary generated for TTS output
- Session management: Persistent sessions with conversation history
- Agent handoff: Mid-conversation delegation to specialist agents
- Smart Router bypass: Common queries handled in <50ms without LLM calls
5. LLM Model Support
Providers (9 Providers, 43+ Models)
| Provider | Models | Default | Notes |
|---|
| Anthropic | 7 | Claude Sonnet 4.6 | Primary provider, native tool_use |
| OpenAI | 7 | GPT-4o | Embeddings and alternative reasoning |
| Google Gemini | 5 | Gemini 2.0 Flash | 1M context window, GEMINI agent |
| Perplexity | 5 | Sonar Large | Online search integration |
| Groq | 3 | Llama 3.1 70B | Fast inference |
| Mistral | 4 | Mistral Large | European provider |
| xAI (Grok) | 2 | Grok 2 | Alternative reasoning |
| DeepSeek | 2 | DeepSeek V3 | Cost-effective |
| Together AI | 3 | Llama 3.1 70B Turbo | Open-source models |
Model Tiers
- Fast: Low-latency models for quick queries (Haiku, GPT-4o Mini, Gemini Flash)
- Smart: Balanced performance (Sonnet, GPT-4o, Gemini Pro)
- Frontier: Maximum capability (Opus, o1, Gemini Ultra)
- Local: Self-hosted via Ollama, vLLM, llama.cpp, or NIM backends
Per-Agent Model Assignment
Each agent can be assigned a different model. CommanderQ defaults to Claude Sonnet 4.6. GEMINI uses Google Gemini. PERPLEXITY uses Perplexity Sonar. All configurable per deployment.
6. Workflow Engine (QuoxFlow)
Accountable workflow execution with full audit trails. Every node execution is recorded and traceable.
Workflow Builder
- Split-pane UI: AI chat on the left, live WireMap preview on the right
- 7-phase guided creation: Intent, nodes, connections, parameters, review, deploy, monitor
- 21 node types in 6 categories: Triggers, logic, integrations, AI, data, output
- 1-click deploy: Publish directly to QuoxFlow runtime
- Back-navigation: Move between phases without losing work
Runtime Features
- Real-time monitoring: Running Now dashboard with animated progress bars
- APM-style drilldown: Click any execution to see node-by-node timing and output
- Schedule visibility: Countdown timers for next scheduled runs
- Error handling: Per-node retry policies, fallback paths, error notification
- Execution history: Full audit trail with input/output for every node
Workflow Library
- 1,340+ indexed templates: Pre-built workflows across monitoring, alerting, data sync, AI processing
- Search and filter: By category, integration, complexity
- 1-click import: Import any template into the workflow builder
- WireMap format: Portable workflow definition format
Enterprise Governance
- Policy management: Define approval rules with inline testing
- Approval workflows: Inbox-based approval with bulk actions and keyboard shortcuts
- Evidence browser: Correlation search across execution records
- Compliance exports: SOC2, HIPAA, GDPR, ISO 27001 format exports
7. Agent Visualisations
13 canvas-based visualiser themes that react to agent state and audio in real-time. Each agent gets a unique visual identity displayed in the chat sidebar.
Themes (13)
| Theme | Description | Default Agent |
|---|
| HAL | Red iris with audio-reactive pupil dilation and glowing ring | CommanderQ |
| Sphere | Pulsing 3D sphere with surface distortion | SENTINEL, ATLAS |
| Atom | Orbiting electrons around a nucleus | NOVA |
| DNA | Double helix with rotating base pairs | CIPHER |
| Brain | Neural network with firing synapses | PRISM |
| Fluid | Particle physics simulation | (configurable) |
| HoloField | Holographic MFCC frequency rings | SCHOLAR |
| Nexus | JARVIS-style 3D network graph | FORGE |
| KITT | Knight Rider scanner bar | METRICS |
| Ripple | Concentric expanding rings | INSIGHT, BEACON |
| Iris | Hyper-realistic eye with light refraction | (configurable) |
| Codex | Scrolling manuscript with pattern highlighting | ARCHIVIST |
| Core | Five-layer orbital system with cognitive nodes | COREY |
Visualiser Features
- 5 agent states: Idle, listening, speaking, thinking, error
- Audio reactivity: Web Audio API frequency data drives particle speed, ring intensity, pupil dilation
- Per-state configuration: Speed, scale, sensitivity, and HSL hue per state per agent
- Settings editor: Live preview with simulated audio, changes persist per agent
- Sidebar integration: Collapse/expand toggle, popout window, push-to-talk button, status badge
- HAL is free: Included with every installation. 12 premium themes require a licence.
8. Cognitive Topology
A neural-style system health visualisation that maps platform components to "cognitive implants" on a grid.
Implants (14)
| Implant | Type | Grid Position | Description |
|---|
| Cognitive Core | Core | Centre (2,2) | Central processing hub, spans 2 rows |
| Memory Lattice | Implant | (1,1) | Memory system health and capacity |
| Tooling Cortex | Implant | (1,3) | Tool execution status and latency |
| Integration Spine | Implant | (2,3) | External service connectivity |
| Execution Memory | Implant | (3,2) | Workflow execution state |
| Context Horizon | Implant | (2,1) | Context window utilisation |
| Agent Mesh | Implant | (3,1) | Agent availability and load |
| Reliability Index | Implant | (3,3) | System uptime and error rates |
| Continuity Anchor | Implant | (4,2) | Backup and persistence status |
| Governance Layer | Implant | (4,1) | Policy compliance status (enterprise) |
| Data Fabric | Implant | (4,3) | File system health (premium) |
| Codebase Fabric | Implant | (5,2) | Code index freshness |
Visual Palettes (4)
Observable 10, Tableau 10, Pastel (ColorBrewer), Vivid. Each implant mapped to a palette index for consistent colour coding.
9. Services
Service Registry (14 Services)
| Service | Port | Category | Critical | Description |
|---|
| QuoxAgent | 9847 | Core | Yes | Host monitoring daemon, fleet heartbeat aggregation |
| Collector | 9848 | Core | Yes | Chat pipeline, tool execution, AEE envelope storage |
| Auth | 3101 | Core | Yes | JWT authentication, RBAC, API key management |
| Qdrant | 6333 | Data | No | Vector database for semantic memory search |
| Orchestrator | 3100 | Infrastructure | No | Container lifecycle management |
| Nginx | 443 | Infrastructure | Yes | Reverse proxy, TLS termination |
| Memory | 3103 | Data | No | SQLite + FTS5 persistent memory storage |
| Files | 3102 | Data | No | File storage, folder management, ARCHIVIST backend |
| PostgreSQL | 5432 | Data | Yes | QuoxFlow database (PG 16.4) |
| QuoxFlow | 3200 | Core | No | Auditable workflow engine runtime |
| Tasks | 3104 | Core | No | Background objective execution |
| Bastion | 9850 | Infrastructure | No | SSH gateway for fleet access |
| n8n | 5678 | Optional | No | Legacy workflow engine (opt-in via --profile) |
| Grafana | 3000 | Monitoring | No | Metrics dashboards |
Startup Dependencies
Auth (3101) must be healthy before Collector (9848) starts. Collector must be healthy before the dashboard frontend can proxy requests. PostgreSQL (5432) must be healthy before QuoxFlow (4100).
10. Application Routes (106)
Route Categories
| Category | Count | Examples |
|---|
| Home & Dashboard | 4 | /, /dashboard, /soc, /noc |
| Agents | 4 | /agents, /agents/stream, /agents/family-tree, /agents/:id |
| Memory & Files | 3 | /files, /archivist, /memory |
| QuoxVault | 5 | /vault, /vault/browse, /vault/credentials, /vault/folders, /vault/leases |
| Builder+ | 11 | /tools, /workflows, /workflow-builder, /schedules, /terminal, /docker |
| Admin+ | 6 | /policies, /evidence, /volt, /ward, /certification, /layer-plugins |
| Governance | 2 | /backup, /system |
| Ungated | 11 | /workflow-library, /prompts-library, /assistants, /inbox, /comms |
| Monitoring | 4 | /monitoring/grafana, /monitoring/prometheus, /monitoring/uptime-kuma |
| Infrastructure | 6 | /bastion, /docker, /wazuh, /routeros, /opsdeck, /codebase-mirror |
| Organisation | 8 | /orgs, /divisions, /departments, /teams, /org |
| Agentic Teams | 2 | /teams-overview, /agentic-teams/:teamId |
| Standalone | 7 | /login, /setup, /store, /visualizer-popup, /noc/popout |
| Settings | 1 | /settings (scope-aware: Account / Organization / Instance blocks rendered per role) |
| Observability | 1 | /observability (peer top-nav: overview, health, logs, errors, feedback — instance admins only) |
Access Control
Routes are gated by role (viewer, operator, runner, builder, admin) and by plugin activation. The sidebar dynamically shows only routes the current user can access.
11. Security & Compliance
Authentication
- JWT tokens: Access + refresh token pair with configurable expiry
- Argon2 password hashing: Memory-hard hashing algorithm
- OAuth: Claude CLI OAuth for MCP path
- API keys: Per-user API keys for programmatic access and CI/CD
- SSO: SAML, OIDC, and LDAP support (enterprise)
- Multi-profile: Switch between local, staging, and production environments
Access Control
- Role-based (RBAC): Admin, Operator, Runner, Builder, Viewer
- Custom roles: Create organisation-specific roles with fine-grained permissions
- Plugin-scoped: Features gated by plugin activation and licence validation
- Organisation-scoped: Resources isolated by org, division, department, team
Audit & Compliance
- AEE envelopes: Every AI interaction wrapped in a tamper-evident envelope
- AOCL layers: OSI-style audit layers for multi-agent tracing
- VOLT ledger: Immutable append-only audit trail with hash chains
- WARD receipts: Write-once receipt digests for external verification
- Compliance exports: SOC2, HIPAA, GDPR, ISO 27001 formatted reports
- Evidence browser: Correlation search across execution records
- DEFCON levels: Graduated risk control with automatic policy tightening
12. Open Protocol Specifications
Four open protocols, specified, implemented and independently verifiable today, all four filed as individual IETF Internet-Drafts. These define how AI agent operations are recorded, traced, and verified.
Protocol Suite
| Protocol | Full Name | Purpose |
|---|
| AEE | Agent Envelope Exchange | Standard envelope format for AI agent messages and tool calls |
| AOCL | Agent Orchestration Control Layers | OSI-style audit layer model for multi-agent systems |
| VOLT | Verifiable Operations Ledger & Trace | Immutable, hash-chained audit trail for AI operations |
| WARD | Write-once Append-only Receipt Digests | Tamper-evident receipt format for external verification |
Implementation in QuoxCORE
- AEE envelopes stored in SQLite (backend) and IndexedDB (browser)
- Browser-to-server sync via POST /collector/aee/sync
- AOCL layer visualisation with real-time processing view and waterfall timeline
- VOLT certification and hash chain verification
- WARD receipt generation for compliance archives
13. Voice System
Input (Speech-to-Text)
- Whisper transcription: OpenAI Whisper for accurate speech recognition
- Push-to-talk: Hold button in the sidebar visualiser to speak
- Language detection: Automatic language identification
Output (Text-to-Speech)
- ElevenLabs: 20 voice options across accents and styles
- Per-agent assignment: Each agent gets a unique voice
- Verbosity modes: Quiet (150 chars), Normal (500 chars), Verbose (1,000 chars)
- Voice summary: Separate concise summary generated specifically for TTS
Voice Categories
- American Female (2 variants)
- American Male (multiple variants)
- British (Authoritative, Confident)
- Australian, Swedish, Transatlantic accents
14. Terminal
Web Terminal (QuoxCORE Plugin)
- Multi-pane layout: Up to 4 terminal panes with keyboard shortcuts (Ctrl+1-4)
- AI chat panel: Ask questions about terminal output, get suggestions
- Error detection: Automatic error recognition with suggestion chips
- Vim keybindings: Ctrl+Shift+V toggle, NORMAL/INSERT modes, j/k/G/gg scroll
- Workspace tabs: Ctrl+Shift+N/W for workspace management
- Terminal Memory Bridge: Entity extraction, error tracking, WSM focus, command recording
- Offline detection: Auto-resume reconnect with offline banner
- Keyboard help: Ctrl+? shows all shortcuts
Desktop Terminal (QuoxTerminal)
- Tauri 2.0 + Rust: Native app for macOS (Apple Silicon + Intel) and Linux
- Local PTY: Native terminal emulation with full shell support
- Native SSH: russh-based SSH without system OpenSSH dependency
- AI chat: Anthropic Claude integration with SSE streaming
- Fleet dashboard: Connect to any host in your fleet with one click
- Command safety: Denylist for dangerous commands with confirmation modal
- Session persistence: Restore terminal sessions after app restart
- System tray: Background operation with global hotkey (Cmd/Ctrl+`)
- Auto-updater: GitHub Releases integration for seamless updates
15. Infrastructure Monitoring
QuoxAgent Fleet
- Host daemon: Go binary deployed to every monitored host
- Heartbeat: Regular health check-ins with system metrics
- Fleet dashboard: Real-time grid of all hosts with status indicators
- SSH execution: Run commands on fleet hosts via bastion gateway
- GPU monitoring: NVML + nvidia-smi for GPU fleet visibility (QuoxGPU)
Monitoring Integrations
| Integration | Capabilities |
|---|
| Prometheus | Metric scraping, PromQL queries, alert rules |
| Grafana | Dashboard embedding, alert forwarding, iframe integration |
| Uptime Kuma | Availability monitoring, SLA tracking, status pages |
| Wazuh | SIEM, security events, compliance reporting |
| Proxmox VE | VM/LXC management, resource monitoring, console access |
| MikroTik RouterOS | Network device management, firewall rules, traffic monitoring |
NOC (Network Operations Centre)
- Popout window: Dedicated monitoring view (/noc/popout)
- SOC dashboard: Security operations centre view (/soc)
- OpsDeck: Customisable widget grid for operations teams
- DEFCON indicators: Graduated alert levels with colour coding
16. File System
Core Features
- Folder organisation: Create, rename, move folders with drag-and-drop
- Right-click context menus: Quick actions on files and folders
- Scoped chat: Chat with files in a specific folder, get cited answers
- Bulk operations: Multi-select, bulk move, bulk delete
ARCHIVIST Skills (Premium)
- Summarise: Generate document summaries at configurable detail levels
- Compare: Side-by-side file comparison with diff highlighting
- Extract: Pull structured data from unstructured documents
- Quiz: Generate quiz questions from document content
- Contradictions: Find inconsistencies across a knowledge base
- Semantic search: Find documents by meaning, not just keywords
17. Organisation & Teams
Hierarchy
Organisation
Division
Department
Team
Members
Features
- Multi-tenant isolation: Data never crosses organisational boundaries
- Scoped chat: Start conversations scoped to a division or team
- Team workspaces: Each team gets its own dashboard, workflows, inbox, and activity feed
- Delegated administration: Team leads manage their own members and resources
- Usage quotas: Set limits on API calls, storage, and compute per team
- Resource sharing: Share workflows, templates, and knowledge across teams with permissions
Agentic Teams
- Multi-agent collaboration: Define teams of agents that work together on complex tasks
- Team overview: Dashboard showing team composition, capabilities, and activity
- Scoped delegation: CommanderQ delegates to teams rather than individual agents
18. Secrets Management (QuoxVault)
- Encrypted storage: API keys and credentials encrypted at rest
- Folder organisation: Group credentials by environment, service, or team
- Lease management: Time-limited access to credentials with automatic revocation
- Activity log: Full audit trail of credential access
- Per-org scoping: Credentials isolated by organisation
19. QuoxMCP (Model Context Protocol)
Capabilities
- 168 governed tools: Infrastructure, memory, files, workflows, fleet, monitoring
- 5 resources: System status, agent list, memory, fleet, services
- 4 prompts: Triage, security sweep, health check, deployment
- STDIO transport: Local connection between collector and MCP server
- Tool streaming: Long-running tools stream output via SSE
| Category | Examples |
|---|
| Fleet | SSH exec, host status, deploy, restart services |
| Memory | Store, recall, search, entity CRUD |
| Files | Upload, download, list, folder management |
| Workflows | Create, execute, monitor, template import |
| Monitoring | Health check, metrics query, alert management |
| Admin | User management, plugin activation, configuration |
20. QuoxCLI (Command-Line Interface)
- 36 commands: Auth, agents, fleet, memory, chat, backups, admin, integrations
- 175+ API endpoints: Wrapped across all 5 microservices
- Multi-profile auth: JWT login with auto-refresh, switch between environments
- 4 output modes: Table, JSON, CSV, Quiet (for scripting)
- CI/CD ready: API key auth via QUOX_TOKEN, structured exit codes, non-interactive mode
- Composable: Pipe JSON to jq, quiet mode for xargs, CSV for spreadsheets
21. System Maintenance
- Version tracking: Polls GitHub Releases every 6 hours, semver comparison
- One-click updates: Preflight checks, automatic backup, git pull, per-service build, rolling restart
- Real-time progress: SSE streaming shows each pipeline step as it happens
- Rollback: One-click revert to pre-update state
- Inbox notifications: Update available alerts in the notification inbox
22. Smart Router
Handles 60-80% of common queries without invoking an LLM, reducing latency from 2-5 seconds to under 50ms.
Routing Logic
- Exact match: Known commands (status, help, version) handled instantly
- Pattern match: Regex patterns for common query shapes
- Agent delegation: Unmatched queries routed to the best specialist agent
- Model selection: Queries that need an LLM are routed to the assigned model
| Metric | Smart Router | Full LLM |
|---|
| Latency | <50ms | 2-5s |
| Token cost | Zero | 100-500 |
| Coverage | 60-80% | 100% |
23. Inbox & Actions
- Approval queue: Pending approvals with full context, bulk approve/deny
- Keyboard shortcuts: j/k navigation, Enter to open, Escape to close
- Urgent indicators: Pulsing sidebar badge for time-sensitive items
- Agent-created items: Agents can create inbox items via MCP tools
- Action tracking: Track commitments and follow-ups across conversations
- Assignee filtering: Filter by who the action is assigned to
24. Deployment
Docker Compose Stack
- 12 containers in default profile (auth, collector, dashboard, memory, files, tasks, nginx, postgres, qdrant, quoxflow, orchestrator, bastion)
- Optional profiles:
--profile with-n8n adds n8n, --profile monitoring adds Grafana/Prometheus
- Rolling updates: Per-service build and restart with health checks
- Pre-update backups: Automatic snapshot before any update
Desktop App (QuoxTerminal)
- Platforms: macOS (Apple Silicon + Intel), Linux (x64)
- Distribution: .dmg (macOS), .deb + .AppImage (Linux)
- Auto-updater: GitHub Releases integration
- 130 tests: Vitest + @testing-library/react
See Also