unicity-aos/aos-ce
74.0
Strong · 14 November 2026
68.3k
lines of production code
Rust
with Swift
5
measurements over time
What this system is
This system is an open-source Agent Operating System (AOS) that provides a modular, capsule-based runtime for executing AI agents with sandboxed tool access. It manages agent identity, conversation context, and LLM provider connections through a pluggable capsule architecture, while enforcing security via approval-gated permissions and signed installation channels. The platform includes native macOS interfaces and a headless shell for validation, enabling agents to interact with files, HTTP services, and shell commands within a secure, bounded environment.
Features
AOS Command Center and native private input console
The AOS bootstrap crate now includes a terminal-based Command Center console for reviewing agent requests and handling private input. This adds new CLI commands (\aos status\, \aos principals\, \aos native-setup\) and a \command\_center\ module that launches the native macOS Command Center app on start. The console handles approval requests and private input (secrets, text, arrays) via a secure Unix socket, enforcing strict file permissions and user ownership for credentials.
crates/unicity-aos-bootstrap · high confidence
AOS Community Edition initial release with signed channels and native macOS Command Center
AOS Community Edition is now available as an open agent operating system, dual-licensed under MIT or Apache 2.0. The release introduces a signed, authenticated installation pipeline supporting stable, dev, and nightly channels, with native Linux musl archives and macOS filesystem app installation. A new macOS Command Center provides a native menu-bar interface for permission approvals and private input, integrated with the \aos mcp serve\ command via a local interaction socket. The product includes a bounded Rhai script runtime, semantic surface catalogs, and a Forge tool for building capsules. The installer supports idempotent upgrades and state migration from standalone Astrid runtimes, while legacy private permissions are repaired during upgrades to ensure secure runtime state.
(repo-wide) · high confidence
Identity capsule introduces approval-gated persistence and onboarding flow
The new identity capsule in \capsules/capsule-identity\ manages the agent's persistent configuration (callsign, role, personality) via a \SparkConfig\ struct. On first boot, it injects an onboarding instruction into the system prompt, guiding the user to define their identity before calling \save\_identity\. Crucially, the \save\_identity\ action is gated by an approval mechanism, ensuring that identity changes require explicit user consent before being persisted to the key-value store. The capsule also supports exporting and importing this configuration via CLI commands and auto-detects existing configurations to handle state resilience.
capsules/capsule-identity · high confidence
Initial release of Unicity AOS capsule components
This change introduces the initial set of Unicity AOS capsule components, including the CLI proxy, context engine, agent injector, filesystem tools, and the forge development tooling. Each capsule is defined by a \Capsule.toml\ manifest specifying its WASM target, IPC subscriptions, and publish capabilities, and is supported by CI workflows that build the WASM artifacts and package them into installable \.capsule\ archives.
capsules · high confidence
Introduce AOS MCP broker capsule with authenticated host hooks
This change introduces the \capsules/capsule-mcp\ module, which acts as a central broker for MCP interactions across Codex, Claude, and Grok host adapters. It adds token-validated hook ingress points (\handle\_codex\_hook\, \handle\_claude\_hook\, \handle\_grok\_hook\) that verify caller identity and session tokens before relaying events. The broker also implements \relay\_host\_hook\_response\ to forward validated responses back to the host, specifically preserving policy decisions (veto/success) to ensure the native host renderer correctly interprets security outcomes. Additionally, it provides handlers for tool discovery, tool calls, and various elicited approval/consent decisions.
capsules/capsule-mcp · high confidence
Introduce Context Engine capsule for session compaction
The new Context Engine capsule manages conversation context windows by compacting messages when they exceed a token budget. It exposes IPC topics for compacting sessions and estimating token counts, and supports pluggable interceptor hooks that allow other capsules to protect specific messages or skip compaction entirely. The default compaction strategy preserves recent turns and protected messages while removing the oldest non-protected messages to stay within the target token limit.
capsules/capsule-context-engine, crates, distros/community · high confidence
Introduce MCP broker with approval gating and tool discovery
This change adds the \aos-mcp-broker\ crate, establishing a new front door for MCP tool interactions. It implements a tool discovery mechanism that collects and caches descriptors from host capsules, and a broker handler that routes \tools/list\ and \tools/call\ requests. A key addition is the approval bridge, which intercepts capability-gated tool calls, surfaces consent prompts to the user via the shim, and manages the result delivery once a decision is made. The broker also includes ingress trust gating for state-mutating calls and a native tool pre-use gate to enforce policy on direct tool executions.
crates/aos-mcp-broker · high confidence
Introduce OpenAI-compatible LLM provider capsule
Added a new \capsule-openai-compat\ component that enables the system to connect to any OpenAI-compatible Chat Completions API (such as OpenAI, Groq, Together, Mistral, DeepSeek, and Fireworks). This capsule subscribes to generation requests, forwards them via HTTP, parses SSE streaming responses, and publishes standardized stream events. It includes logic to discover available models from the upstream provider, handles environment-based configuration for base URLs and API keys, and ensures robust handling of whitespace-only credentials to prevent authentication errors.
capsules/capsule-openai-compat · high confidence
Introduce Unicity AOS agent capsule ecosystem
This change introduces the initial set of agent capsules for the Unicity AOS product, providing the core capabilities for agent interaction and tool execution. The \capsule-agents\ and \capsule-memory\ modules inject project-specific instructions (AGENTS.md) and cross-session memory (memory.md) into the system prompt. The \capsule-cli\ establishes the connection layer, binding CLI clients to principals and demuxing traffic by session to prevent cross-talk. The \capsule-fs\, \capsule-http\, and \capsule-shell\ modules provide agents with sandboxed tools for file operations, HTTP fetching, and secure shell command execution. Finally, \capsule-session\ manages conversation history and thread metadata, while \capsule-router\ and \capsule-users\ handle tool dispatch and user identity resolution respectively.
(repo-wide), capsules/capsule-shell · high confidence
Introduce Unicity CE distribution manifest
The Unicity CE distribution is now available as a curated bundle of capsules for the agent operating system experience. The new \Distro.toml\ manifest defines the complete set of components, including uplinks (CLI, MCP, registry), core infrastructure (session, identity, router, context-engine), tools (shell, http, fs), and extensions (skills, agents, memory). It also specifies the minimum compatible Astrid runtime version (\>=2026.9.4) and provides configuration variables for optional LLM providers like OpenAI. The distribution is dual-licensed under MIT or Apache 2.0.
distros/community/unicity-ce · high confidence
Introduce headless native Rust reference shell for the Adaptive Workspace
The \adaptive-shell\ crate provides a deterministic, headless Rust runner for the AOS Adaptive Workspace, enabling users to validate activity placement, layout, and theming without a browser or native window backend. It includes an Activity Atlas for live deterministic previews and direct placement (Master, Stack, Tab, Float, New-activity), supports desktop (master-plus-stack, grid, single, focus) and phone (one-card) layout rules, and exposes 62 semantic component identities with Fieldglass dark, light, and high-contrast themes (including density, text scale, and reduced-motion settings). Users can run deterministic snapshots via CLI flags (\--headless\, \--fixture desktop\|phone\|theme-lab\, \--theme\, \--density\, \--scale\, \--reduced-motion\, \--json\) to verify stable node identity, keyed reconciliation, and backend-neutral display lists.
apps/adaptive-shell · high confidence
Introduce native macOS menu-bar shell for AOS
Adds a new macOS menu-bar application (AOS Tray) that serves as a local companion for the AOS runtime. The app provides a native UI for inspecting runtime status and capsule libraries, managing volume mounts, and handling private input requests (text, secrets, selections, arrays) via a dedicated native window. It supports automatic login item registration, reconnection logic for volume-backed credentials, and explicit binary/home configuration without relying on system PATH or auto-starting daemons.
apps/aos-tray · high confidence
Introduce prompt builder capsule with plugin hook interception
The new \capsule-prompt-builder\ capsule now assembles LLM prompts by intercepting plugin hooks via IPC. It fires a \before\_build\ hook to collect plugin responses (such as system context additions or full prompt overrides), merges them according to defined semantics (e.g., last non-null system prompt wins, concatenated context prefixes), and returns the final assembled prompt to the react loop. The implementation includes configurable timeouts for hook responses and handles edge cases like empty overrides or slow plugins.
capsules/capsule-prompt-builder · high confidence
New LLM Provider Registry capsule for model discovery and selection
The capsule-registry capsule introduces a centralized registry for discovering available LLM providers via IPC fan-out and managing the active model selection. It exposes IPC topics for querying providers, getting/setting the active model, and receiving change events, while also providing a CLI interface for model management. The implementation includes robust validation for request IDs to prevent topic injection, deduplication of provider entries, and a multi-pass resolution algorithm for selecting models by canonical ID, bare model name, or qualified ID.
capsules/capsule-registry · high confidence
New capsule release validation script
A new Python script, \scripts/capsule\release.py\, has been added to validate Community Edition capsule source and release artifacts. This tool enforces release contracts by verifying that capsule directories are allowed, ensuring Cargo and Capsule manifests match, checking that package identities follow the \aos-\\ convention, and validating the structure and safety of the resulting capsule archives.
python · high confidence
New manifest validation and comprehensive Forge documentation
The capsule-forge tool now includes a new \validate\_manifest\ function that performs pragmatic linting on \Capsule.toml\ files, checking for required package fields, valid semantic versions, correct component definitions, and proper capability types (lists vs booleans) to catch common author mistakes early. This is accompanied by a complete set of new documentation guides covering the AOS architecture, capsule anatomy, manifest structure, IPC routing, security boundaries, and the meta-harness workflow, providing agents with authoritative reference material for building and managing capsules.
capsules/capsule-forge · high confidence
New release infrastructure and validation scripts
The scripts directory now includes a comprehensive suite of new tools to support the AOS release pipeline. This includes \build-command-center.sh\ for assembling and signing the macOS Command Center app, \build-capsule-assets.sh\ for building capsule packages, and \channel\_transaction.py\ / \channel\_publication.py\ for managing atomic channel updates. Security and compatibility are enforced via \check\_glibc.py\, \check\_static\_elf.py\, and \musl\_release\_metadata.py\. Additionally, \aos-filesystem.sh\ handles macOS filesystem provider setup, \bind-rehearsal-consumed-artifacts.sh\ manages rehearsal artifacts, and \nightly\_version.py\ automates nightly versioning. A frozen shape fixture (\astrid-094-frozen-shape.json\) and its generator (\create-astrid-094-fixture.py\) ensure consistent runtime environments.
scripts · high confidence
Test coverage
Added correlation tests for stale turn rejection; Added test-only Oracle hook policy responder.
Dependencies
Unicity AOS runtime and capsule dependencies pinned to Astrid 2026.9.4
The Unicity AOS runtime and its associated capsules now depend on the Astrid SDK and core libraries at version 2026.9.4. This update aligns the AOS product with the latest Astrid release, ensuring compatibility with the current runtime environment and providing access to the latest features and fixes available in the Astrid ecosystem.
(dependencies) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 73 → 74 (+1.1)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.
Lenses
- Code Health 75 → 88 (+12.3)
- Architecture 99 → 99 (+0.0)
- Maturity 71 → 71 (+0.1)
- Readiness 74 → 78 (+3.6)
- Security 88 → 82 (-5.2)
- Event Sourcing 100 → 100 (+0.0)
- Performance 70 → 70 (+0.0)
Resolved (26)
- Duplicated block (11 lines × 2) (apps/adaptive-shell/src/components.rs)
- Duplicated block (12 lines × 2) (crates/unicity-aos-bootstrap/src/mcp/interaction.rs)
- Duplicated block (12–14 lines × 2) (capsules/capsule-openai-compat/src/lib.rs)
- Duplicated block (15 lines × 2) (apps/aos-tray/Sources/AOSTrayCore/CommandCenterVolume.swift)
- Duplicated block (17–18 lines × 2) (apps/aos-tray/Sources/AOSTrayCore/PrincipalDiscovery.swift)
- Duplicated block (17–18 lines × 2) (scripts/musl_release_metadata.py)
- Duplicated block (19–22 lines × 2) (scripts/release_metadata.py)
- Duplicated block (5 lines × 2) (scripts/channel_transaction.py)
- Duplicated block (58 lines × 2) (apps/adaptive-shell/src/components.rs)
- Duplicated block (7 lines × 2) (capsules/capsule-system/src/lib.rs)
- Duplicated block (8 lines × 2) (capsules/capsule-openai-compat/src/lib.rs)
- Duplicated block (9 lines × 2) (crates/aos-mcp-broker/src/approval.rs)
- Hotspot: capsules/capsule-hook-adapter-oracle/src/lib.rs (capsules/capsule-hook-adapter-oracle/src/lib.rs)
- Hotspot: crates/unicity-aos-bootstrap/src/distro_trust.rs (crates/unicity-aos-bootstrap/src/distro_trust.rs)
- Hotspot: crates/unicity-aos-bootstrap/src/status.rs (crates/unicity-aos-bootstrap/src/status.rs)
- Leaked secret: hardcoded-credential (scripts/test_sign_command_center.sh)
- No ADRs found
- capsule_release.source_contract (cognitive 43) (scripts/capsule_release.py)
- capsule_release.source_contract (cyclomatic 26) (scripts/capsule_release.py)
- capsule_release.validate_archive (cognitive 31) (scripts/capsule_release.py)
- …and 6 more
New (63)
- Duplicated block (10 lines × 2) (capsules/capsule-workspace-recipes/src/service.rs)
- Duplicated block (12 lines × 2) (crates/unicity-aos-bootstrap/src/mcp/interaction.rs)
- Duplicated block (12–14 lines × 2) (capsules/capsule-openai-compat/src/lib.rs)
- Duplicated block (15 lines × 2) (apps/aos-tray/Sources/AOSTrayCore/CommandCenterVolume.swift)
- Duplicated block (17–18 lines × 2) (apps/aos-tray/Sources/AOSTrayCore/PrincipalDiscovery.swift)
- Duplicated block (58 lines × 2) (apps/adaptive-shell/src/components.rs)
- Duplicated block (7 lines × 2) (capsules/capsule-system/src/lib.rs)
- Duplicated block (8 lines × 2) (capsules/capsule-openai-compat/src/lib.rs)
- Duplicated block (9 lines × 2) (crates/aos-mcp-broker/src/approval.rs)
- Edited copies of one member (3 members, 12+ corresponding lines) (crates/aos-mcp-broker/src/approval.rs)
- Edited copies of one member (3 members, 13+ corresponding lines) (crates/aos-mcp-broker/src/approval.rs)
- Edited copies of one member (3 members, 15+ corresponding lines) (crates/aos-mcp-broker/src/cache.rs)
- Edited copies of one member (3 members, 17+ corresponding lines) (crates/unicity-aos-bootstrap/src/cli/principals.rs)
- Edited copies of one member (3 members, 19+ corresponding lines) (capsules/capsule-users/src/lib.rs)
- Edited copies of one member (3 members, 27+ corresponding lines) (capsules/capsule-users/src/lib.rs)
- Edited copies of one member (4 members, 4+ corresponding lines) (apps/adaptive-shell/src/activity.rs)
- Edited copies of one member (6 members, 18+ corresponding lines) (capsules/capsule-users/src/lib.rs)
- Edited copy of a member (11 corresponding lines) (capsules/capsule-react/src/lib.rs)
- Edited copy of a member (11 corresponding lines) (capsules/capsule-surface-catalog/src/theme.rs)
- Edited copy of a member (11 corresponding lines) (capsules/capsule-workspace-recipes/src/backend.rs)
- …and 43 more
Architecture
- Unchanged — 0 containers · 1 contexts · 0 edges
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
unicity-aos/aos-ce was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 14 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 6e4e8ec147ea693a895721c04811d69cee3268ed — the exact code this score is about.
- Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.65+preprod-e1a3b69fc8ee.