Core Concepts

Aegis is a local supervised AI agent harness. The dashboard is not just chat; it is an operator console for planning, execution, approvals, artifacts, and audit trails.

Local Harness

The local API, dashboard, worker, database, workspace artifacts, policy boundaries, approvals, and trace history are owned by Aegis.

Runs

A run is a durable execution instance. It has state, jobs, task sessions, artifacts, evaluations, traces, and approvals.

Task Sessions

Task sessions represent delegated specialist work. They keep the role, model calls, tool calls, artifacts, guidance, evaluations, and progress inspectable.

Conversations And Command Center

Project Chat keeps conversation sessions, attachments, plans, summaries, runtime events, design docs, execution graphs, and delegated run links together. Command Center summarizes the operator’s current workload across active runs, approvals, blocked jobs, failures, and sessions.

Workflow Designer

Saved workflows are graph definitions made from triggers, tool steps, agent steps, branches, filters, retries, approvals, and notifications. They can be run manually, from automations, or through coordinator handoff when a project request needs repeatable execution.

Memory And Project Context

Memory records, promoted memory candidates, review reports, and project context documents give the coordinator durable context without relying on one chat transcript. Project context uploads and editable documents should contain reusable project facts, requirements, or reference material that future runs can cite.

Planner And Research

Planner turns calendar, task, source, and conflict data into local artifacts for search and schedule chat. Research Studio collects source metadata, previews, ingested sources, visual analysis, citations, notes, and generated assets.

Approvals

High-risk actions are gated by approval checkpoints. Repo writes are bound to exact patch bundles and file hashes rather than a broad permission to mutate files.

Artifacts

Artifacts preserve work output, evidence, logs, verifier results, patch bundles, and final summaries.

Local-First Model

Aegis keeps state under local storage by default. Hosted model providers and connectors can be configured when a workflow needs them.

Capability Inventory

For the current implemented route, connector, tool, and skill map, see Capability Inventory.