UI Guide¶

AEGIS has three surfaces: the web app (browser), the desktop app (Windows/Linux), and the Android app. All three run the same interface — the desktop and Android apps wrap the web app in a native shell.

Launching the interface¶

Web app — start AEGIS and open http://localhost:8600 in a browser.

Desktop app — double-click the AEGIS shortcut or launch from your applications menu. The app connects to the AEGIS server automatically if one is running on the same machine, or prompts you for a server address.

Android — open the AEGIS app; enter your server's local IP address (e.g. http://192.168.1.10:8600) on the connect screen.

Connect screen¶

On first launch, the desktop and Android apps show a connect screen:

Server address — where AEGIS is running (default: http://localhost:8600)
API key — the value of AEGIS_API_KEY in your .env
Auto-discover — AEGIS scans the local network for a running server via mDNS; or enter a Tailscale hostname directly

The app remembers the last successful connection.

The sidebar contains:

Icon	Panel
💬	Chat
🧠	Memory
🗂	Modules
✅	Tasks
📦	Marketplace
📋	Logs
⚙️	Settings

Chat¶

The primary way to interact with AEGIS.

Typing a message: AEGIS routes your request through the cognitive layer — selects the best available engine, recalls relevant memories, executes any tools needed, and streams the reply.

Step trace: every reply has an expandable ▶ Trace section showing what AEGIS did behind the scenes: memory recall, engine selection, tool calls and their results. Click to expand.

Effort level: the status chip at the bottom of the chat lets you choose the reasoning effort for the next message: - Quick — lightweight model, fast - Balanced — default - Deep — more thorough reasoning, slower - Max — full reasoning budget

Model picker: click the model name in the status chip to see all available engines and select one explicitly. AEGIS auto-selects by default.

Stop: click the stop button during a reply to cancel the generation.

Conversations: each conversation is saved automatically. Use the Recent sidebar on the left to switch between conversations. The active project label appears above the input — switch projects from here.

Slash commands: type / to see available commands. Commands run deterministically (no LLM in the loop): - /memory — quick memory add - /tools — list all available tools - /build — launch HEPHAESTUS module builder - /interview — start a guided interview session - Module commands appear here when their module is enabled

Memory panel¶

Shows all stored memories. Memories are the long-term context AEGIS carries between conversations.

Adding a memory: click + Add → fill in the content → optionally set a category and tags → Save.

Editing: click any memory to edit it inline.

Deleting: click the trash icon. Deleted memories are removed permanently.

Filters: - Category — identity, goals, projects, people, facts, and custom categories - Project — filter by project label (📁 chip) - Search — keyword search across all memory content

Memory Fabric (Phase 11 additions): Each memory now carries connective metadata: - Entities — people, places, and things auto-extracted when the memory was stored (the "mycelial threads" of the knowledge graph) - Links — explicit relationships to other memories: supports / contradicts / elaborates / supersedes - About-time — the date the memory refers to (vs the date it was stored) - Lifecycle — active / superseded / expired / archived; AEGIS ignores non-active memories during recall - Recall strength — how often and how recently AEGIS has actually used this memory - Pin — pinned memories are never faded or archived by the system - Confidence + provenance — Interview answers have higher confidence than chat inferences; source link when the memory came from a document

Modules panel¶

Lists all installed modules with their enable/disable toggle and status badge.

🔒 = sandboxed (installed from the Marketplace — runs in an isolated worker process)

Tasks panel¶

Shows running and recent DAG tasks — each task is a directed graph of steps that AEGIS is executing or has executed.

Click any task to see its graph, step results, and current state. AEGIS can resume an interrupted task (e.g. after a restart) from exactly where it left off.

Marketplace panel¶

Browse and install community modules from the aegis-registry. See Modules & Marketplace for the full install and consent-gate walkthrough.

Logs panel¶

Live log stream from the running AEGIS process.

Level filter — All / Debug / Info / Warning / Error
Request ID — each log line is tagged with the request ID (rid) that generated it; use this to trace a specific request end-to-end
Clear — clears the display (does not delete the log file)

Settings panel¶

Organized into sections:

System - Engine and adapter status - Hardware capability profile (edge / standard / workstation) - Restart AEGIS in-place (backend restarts without losing conversation state)

Voice (when voice is configured) - Enable/disable STT (Whisper), TTS (Piper), and wake word - Wake word sensitivity - Follow-up window duration

Budget - Daily cloud token budget — configurable via slider - Gauges for context window usage and model window size

Dashboard¶

The Dashboard is the control center — the home screen of AEGIS.

Avatar presence — an animated shield at the center of the Dashboard: - Breathes slowly when idle - Pulses fast while AEGIS is thinking - Throbs in speech rhythm while AEGIS is talking

Status line — one line below the avatar showing what AEGIS is doing right now (idle, thinking, speaking, running a task).

Tile grid — quick-access tiles for Memory, Tasks, Recent conversations, and module widgets. Tiles can be shown or hidden from the Dashboard settings.

Floating presence dock — a small version of the avatar that follows you to every tab. It pulses when AEGIS becomes active and shows a contextual tip when clicked.

Desktop-specific features¶

Auto-update: when a new version of AEGIS is available, the desktop app shows an update notification. Click to download and install the update.

System tray: AEGIS stays in the system tray when the window is closed. Right-click the tray icon to open the app, check status, or quit.

Android-specific features¶

Voice is the primary input on Android — tap the microphone button or say the wake word to start talking. Piper replies through the device speaker.

Screen off + wake word: with native wake enabled, AEGIS listens for the wake word even when the screen is off (requires the foreground service to be running — check Settings → Voice).