LUMAURA ATLAS is a VS Code extension that turns your monorepo into a navigable operating map with local-first reasoning tools.

Key Features

Minimal default shell: only Home + Builder are visible by default; advanced surfaces are behind ATLAS: Toggle Advanced Surfaces.
Command Center: one launcher for build, audit, mapping, billing, and UI mode toggles.
Home View (ATLAS): clean launchpad with key actions and status pills.
Systems View (ASTRIL): Browse system definitions and details.
Governance (VAEHAWK): Architecture drift and compliance signals.
Missions (SYMBIOS): Guided execution tracking.
Impact (ZVINX): Blast-radius and failure simulation.
Constellation Control Center: Search, focus, audit, mission launch, docs/site shortcuts, and snapshot export.
Builder Chat (VAELIOS): In-sidebar plan/build/ship chat workflow.
Universal Ingest: + button supports files and folders from local disk, with PDF text preview extraction and binary fallback for any format.
Arvex Settlement (INFLO): Helcim checkout and billing portal hooks.
Webhook-Ready Entitlements: local cache + backend sync endpoint integration.
Sovereign Runtime: Atlas chat, SCALVNBO, and PRIMAL CORTEX route to a self-hosted runtime (/api/vaelios/*, /api/primal-cortex/*).

Builder Chat

Open the ATLAS sidebar and use Builder Chat (VAELIOS).

Quick actions: Plan, Build, Ship, Audit
Simple/Power toggle: clean default layout first, full control surface on demand.
Focus + Activity + Metrics toggles: collapse noise and keep only what you need visible.
Dockable activity shell: switch multi-agent panel between right and bottom docks.
Live multi-agent progress: per-request runtime progress bar and richer status cards.
In-chat mindmap tab: live execution graph inside Builder (not just external view).
Responsive premium shell: better header/composer behavior in narrow widths and popout windows.
Simple/Power state memory: leaving Simple restores your prior focus/activity/metrics layout.
Attach lane: add files/folders with +, then ask for summaries, extraction, or implementation plans.
VAEHAWK-ONE lane: one-click audit from Home, Command Center, and Builder header.
Command lane: run /scan, /plan, /build, /audit, /mindmap directly from the builder shell.
Popout command: ATLAS: Open Builder Chat
Home command: ATLAS: Open Home
Command center: ATLAS: Open Command Center
Console command: VAELIOS: Open Command Console

Helcim Configuration

Set these VS Code settings to wire paid tiers:

atlas.billing.helcimProCheckoutUrl
atlas.billing.helcimEliteCheckoutUrl
atlas.billing.helcimPortalUrl
atlas.billing.entitlementsEndpointUrl
atlas.billing.entitlementsAuthToken
atlas.billing.customerId
atlas.billing.syncOnViewOpen (default: true)
atlas.founderMode (default: true)
atlas.marketing.siteUrl
atlas.marketing.docsUrl
atlas.design.figmaMakeUrl
atlas.valuation.docPath
atlas.runtime.baseUrl
atlas.runtime.fallbackBaseUrl
atlas.runtime.apiBearerToken
atlas.runtime.timeoutMs
atlas.runtime.retryCount
atlas.ui.advancedMode (default: false)

Environment fallback is also supported for billing fields:

ATLAS_HELCIM_PRO_CHECKOUT_URL (or HELCIM_PRO_CHECKOUT_URL)
ATLAS_HELCIM_ELITE_CHECKOUT_URL (or HELCIM_ELITE_CHECKOUT_URL)
ATLAS_HELCIM_PORTAL_URL (or HELCIM_PORTAL_URL)
ATLAS_ENTITLEMENTS_ENDPOINT_URL (or ENTITLEMENTS_ENDPOINT_URL)
ATLAS_ENTITLEMENTS_AUTH_TOKEN (or ENTITLEMENTS_AUTH_TOKEN)
ATLAS_CUSTOMER_ID (or HELCIM_CUSTOMER_ID)

When atlas.founderMode is true, Founder Elite is always unlocked locally.

Webhook-Ready Flow

Helcim webhooks are processed by your backend.
Your backend exposes an entitlement endpoint.
Atlas syncs and stores entitlements in:
- .lumaura/atlas/entitlements.json
Tier UI resolves from entitlement state when Founder Mode is off.

Commands

ATLAS: Audit Current System
ATLAS: Run VAEHAWK-ONE Audit
ATLAS: Show Architecture Drift
ATLAS: Simulate Change Impact
ATLAS: Simulate System Failure
ATLAS: Build AI Context Pack
ATLAS: Create SYMBIOS Mission
ATLAS: Open Constellation Map (Popout)
ATLAS: Open Builder Chat
ATLAS: Open Home
ATLAS: Open Figma Make Workspace
ATLAS: Open AIVA Valuation Doc
ATLAS: Enable No-API Beta Mode
ATLAS: Enable Payment-Ready Mode
ATLAS: Auto-Configure Runtime From Infra
ATLAS: Auto-Configure Billing From Runtime Env
ATLAS: Run Production Readiness Check
ATLAS: Open Atlas Settings JSON
ATLAS: Reset UI Layout
ATLAS: Open Command Center
ATLAS: Toggle Advanced Surfaces
ATLAS: Open LUMAURA Site
ATLAS: Sync Billing Entitlements
ATLAS: Open Entitlements File
VAELIOS: Open Command Console

Local-First Policy

Atlas routes through a sovereign runtime with provider allowlist controls (llamacpp, lumaura-cluster). External provider routes are blocked in runtime policy. If runtime is temporarily unavailable, Atlas switches to local continuity mode so chat remains actionable without external providers.