Embedded Console

Control Panel

The free-forever local sulcus binary serves a zero-dependency 5-tab Local Memory Panel at 127.0.0.1:4203/panel, while Sulcus Enterprise Server (Private VPC and Air-Gap appliances) expands /panel to an 8-tab Fleet Control Panel with Agent Bus, Two-Gate Namespace ACLs, and Apache AGE Cypher sync.

Loopback Port 4203Five Local TabsEight Server TabsAir Gap Ready

Workstation Versus Enterprise

On a standalone workstation (127.0.0.1:4203/panel), sulcus serves the 5-tab Local Memory Panel (overview, web, memories, ledger, settings) backed by embedded PostgreSQL 17 (127.0.0.1:4201) and SQL property graph traversal. On Sulcus Enterprise Server, the Enterprise Control Panel adds 3 Fleet Governance tabs (agents, bus, acl) plus external PostgreSQL 17 with Apache AGE Cypher graph traversal.
Runtime Modes

Launching Control Panel

The Control Panel is served automatically whenever Sulcus runs an HTTP listener.

Mode One

Workstation Daemon

Run sulcus daemon start or sulcus serve to bind 127.0.0.1:4203/panel over embedded PostgreSQL 17.

Mode Two

Cloud Inspection

Paste an sk-... key or OIDC JWT in Settings to inspect authorized remote namespaces.

Mode Three

Private VPC SSO

Docker Private VPC appliances serve https://<host>/panel with zero external CDN dependencies.

Mode Four

Air Gap Enclave

Operates 100% offline inside classified networks with Ed25519 seat license verification.

bashStart Local Panel
# Start background HTTP + MCP daemon with embedded Control Panel on 127.0.0.1:4203
sulcus daemon start

# Or run interactively in the foreground
sulcus serve

# Open the Control Panel in your browser
open http://127.0.0.1:4203/panel

# Note: pure stdio transports do NOT bind an HTTP port or serve /panel
sulcus stdio
sulcus mcp-proxy

Stdio Versus HTTP

When an IDE harness spawns sulcus stdio or sulcus mcp-proxy, that subprocess speaks pure MCP JSON-RPC over stdin/stdout and does not open port 4203. Run sulcus daemon start locally or open Sulcus Studio when inspecting a Cloud tenant.
Storage Architecture

Integral Postgres Boundary

100% PostgreSQL 17 schema parity from laptop HNSW/ONNX daemon to enterprise pgvector cluster.

In local workstation mode, sulcus manages an embedded PostgreSQL 17 instance (pg-embed) bound strictly to loopback 127.0.0.1:4201 under ~/.sulcus/local/postgres/, executing HNSW vector recall and SQL property graph traversal with zero external runtime dependencies. Sulcus Enterprise Server connects to external PostgreSQL 17 with pgvector and Apache AGE Cypher graph sync enabled.

bashLocal Postgres Configuration
# Default: zero-config integral PostgreSQL 17 (pg-embed) on 127.0.0.1:4201
# Data directory: ~/.sulcus/local/postgres/

# Optional local BYO PostgreSQL (MUST target localhost or 127.0.0.1)
export SULCUS_DATABASE_URL="postgres://sulcus:secret@127.0.0.1:5432/sulcus_local"
sulcus daemon restart

Localhost Database Guardrail

For security and tenant isolation, the client binary enforces that SULCUS_DATABASE_URL may only point to localhost or 127.0.0.1 (rejecting SQLite and non-loopback database hosts at startup). To connect workstations to a shared team or enterprise server, configure server_url via sulcus login.
Local Console

Five Workstation Tabs

Built directly into sulcus/src/panel.html at http://127.0.0.1:4203/panel for every local workstation.

Local Tab One

Overview

Top-level KPI strip (Total Nodes, Edges, Average Heat, Pinned Count, Session Operations, Storage Footprint), archetype distribution bars, salience histogram, and quick tables for Hottest Nodes and Recent Captures.

data-tab="overview"
Local Tab Two

Memory Web

Interactive concentric-ring canvas backed by GET /api/v1/agent/graph/snapshot over the SQL property graph locally (or Apache AGE Cypher on Enterprise Server), with zoom, pan, archetype filtering, and click-to-edit.

data-tab="web"
Local Tab Three

Memories Inspector

Full tabular CRUD browser across all 6 archetypes (episodic, semantic, preference, procedural, fact, synthesis). Includes manual creation, filter pills, debounced lexical search, inline Markdown edit, pin toggle, heat override, and delete.

data-tab="memories"
Local Tab Four

Ledger And Triggers

Local Activity Ledger (embedded PostgreSQL activity_ledger) with surgical file-mutation Undo alongside the Reactive Trigger builder supporting the 6 Core Events and 6 Core Actions locally (plus 4 Bus Events and broadcast on Enterprise Server).

data-tab="ledger"
Local Tab Five

Settings

Thermodynamic retention tuning, System 1 VCR cartridge status, authentication token configuration, and server connection status.

data-tab="settings"
Enterprise Console

Three Enterprise Tabs

Added on Sulcus Enterprise Server Private VPC and Air-Gap appliances (8 tabs total in enterprise/panel/panel.html).

Enterprise Tab

Agents And VCR

Enterprise Server only: multi-seat registered agent roster, tenant System 1 VCR weight overrides, domain signal inspection, and active harness telemetry.

data-tab="agents"
Enterprise Tab

Comms Bus

Enterprise Server only: real-time SSE event stream (/api/v1/agent/bus/stream), peer presence cards with 120s live and 15m (900s) idle TTL badges, active file overlap alerts, and manual broadcast composer.

data-tab="bus"
Enterprise Tab

Access Control

Enterprise Server only: Two-Gate Namespace ACL permission matrix (allow, read, or deny per agent and namespace) paired with Persistent Linked Namespaces (auto_search and on_match).

data-tab="acl"
Enterprise Bus

Comms Bus Tab

Enterprise Server tab (data-tab=bus): monitor cross-agent broadcasts, active file claims, and SSE coordination traffic live.

Live Comms Bus
Sulcus Enterprise Control Panel Comms Bus tab showing live peer presence, active file tracking, and SSE event stream
Enterprise Server Comms Bus view rendering peer presence cards (120s live and 15m / 900s idle TTL), active file claims, namespace subscriptions, and real-time SSE broadcast events.
Enterprise Governance

Access Control Tab

Enterprise Server tab (data-tab=acl): configure Two-Gate Namespace ACL rules and persistent cross-namespace recall links visually.

Namespace ACL Matrix
Sulcus Control Panel Access Control tab displaying the Two-Gate Namespace ACL matrix
Grant or revoke per-agent read and write permissions across organizational namespaces. Cross-namespace reads without an explicit grant fail closed with 404 masking.
Linked Namespaces
Sulcus Control Panel Linked Namespaces configuration card
Attach read-only reference namespaces (such as shared-platform or security-playbooks) to a primary project namespace so recall automatically populates <sulcus-namespaces>.
Auditability And Automation

Ledger And Triggers

Roll back unwanted agent file edits and wire event-driven memory rules from one tab.

Activity Ledger
Sulcus Control Panel Activity Ledger showing recorded file mutations and surgical Undo controls
Every captured tool mutation records pre/post SHA-256 hashes and diff hunks so operators can execute a verified surgical Undo with conflict checking.
Reactive Trigger Builder
Sulcus Control Panel Reactive Triggers builder showing core and enterprise events and actions
Visual trigger rule editor supporting the 6 Core Events and 6 Core Actions on every local workstation, plus the 4 Agent Bus Events and broadcast action on Enterprise Server.
Appliance Governance

Authentication And Licensing

One unified Control Panel adapts automatically to Local, Cloud, Connected Private VPC SSO, and Offline Air-Gap deployments.

Deployment ModeConsole SurfaceAuthentication Behavior
Local Workstation Daemonhttp://127.0.0.1:4203/panelLoopback-bound local session with optional local bearer token when SULCUS_HTTP_AUTH is enabled.
Sulcus Cloud Tokenhttps://<tenant-or-local>/panelAuthenticate with an sk-... API key or OIDC JWT bearer token to inspect a remote tenant graph.
Private VPC SSOPOST /api/v1/onprem/loginSelf-hosted Docker VPC appliances federated with OIDC exchange credentials directly from the #auth-form-onprem panel sign-in tab.
Air Gap IntranetPOST /api/v1/airgap/loginZero-internet VPC or classified enclaves bootstrap the initial admin account on first boot and authenticate locally with Ed25519-verified offline seat licenses.

License Continuity Guarantee

Enterprise Private VPC and Air-Gap appliances never lock operators out of their own institutional memory. If an annual seat license enters its grace window (grace) or expires (expired_readonly), the Control Panel displays a clear status banner while keeping all memory reads, vector searches, graph snapshots, exports, and audit logs 100% accessible; only new memory writes pause until license renewal.
Engineering Dispatches

Architecture Release Notes

Receive technical deep dives on thermodynamic context engineering, System 1 VCR cartridge updates, SulcusBench evaluations, and signed v3.1 engine releases directly from Digital Forge Studios.