# AgentOS

**Repository Path**: Infinora/agent-os

## Basic Information

- **Project Name**: AgentOS
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-11-11
- **Last Updated**: 2026-11-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AgentOS

A from-scratch **Rust coding-agent harness**, re-implemented against the `omp²` architecture
(one authoritative session journal → DOM, controller/actor separation, in-process shell,
document authority with LSP/DAP, Directors, versioned tool contracts), with the terminal TUI
replaced by a **local Web + Electron** frontend gateway.

**Bar: capability and engineering quality must be no lower than upstream `omp` itself.**
Nothing is silently dropped; every deviation is recorded with evidence in the parity ledger.

## Specification set

| Doc | Purpose |
| --- | --- |
| [`specs/01-SRS-系统需求规格说明书.md`](specs/01-SRS-系统需求规格说明书.md) | System requirements: design envelope, layer/authority invariants, platform rules, performance & code-quality discipline, security. |
| [`specs/02-FDD-详细功能规格说明书.md`](specs/02-FDD-详细功能规格说明书.md) | Functional design: state/journal/DOM, control plane, catalog & inference, envd/docserver, full tool matrix, extensions, frontend gateway. |
| [`specs/03-ACCEPTANCE-验收标准与测试矩阵.md`](specs/03-ACCEPTANCE-验收标准与测试矩阵.md) | Acceptance: G0 commit gates + P1–P13 joined-system proofs (Windows included), documentation/SDK gate. |
| [`specs/04-MASTER-PLAN-重构实施总计划.md`](specs/04-MASTER-PLAN-重构实施总计划.md) | Staged implementation plan; harness core first (Stages 1–6), frontend gateway last (Stage 7). |
| [`specs/05-PARITY-能力对等台账与差异裁决.md`](specs/05-PARITY-能力对等台账与差异裁决.md) | **Authoritative counts/lists/defaults.** v1 ∪ v2 capability union, per-item PORT/UPGRADE/REPLACE/DROP rulings, hard runtime limits, upstream Windows gaps. |
| [`specs/06-PROGRAMMATIC-编程接入面与可验证界面规格.md`](specs/06-PROGRAMMATIC-编程接入面与可验证界面规格.md) | CLI subcommands, print/rpc/rpc-ui/acp/sdk/gRPC adapters, 28-module Python SDK, and the **headless verifiable UI protocol** required by ADR 0033. |

## Implementation status

The Rust workspace is [`harness/`](harness/README.md).

- **Stage 1 — complete**: core primitives, convars, journal/DOM/session state
  authority. 178 tests + 2,000 property cases, P6 crash/resume proofs, and the
  1,000-event fold budget (29.59 ms release) pass the full G0 gate.
- **Stage 2 — complete**: 87 provider records / 63 selectable providers / 4,461
  models, DPAPI-backed secrets, PKCE/OAuth pools, deterministic prompt bands,
  bitmap compaction, and typed provider inference. Full workspace G0 passes;
  see [`harness/docs/stage2-gate.md`](harness/docs/stage2-gate.md).
- **Stage 3 — complete**: process-internal Bash and 84 builtins, archive/
  walker/AST/edit/VCS engines, sandbox process groups, and the envd document
  authority with LSP/DAP support. Real P1 concurrent rebase and full workspace
  G0 pass; see [`harness/docs/stage3-gate.md`](harness/docs/stage3-gate.md).
- **Stage 4 — complete**: full builtin tool union, durable Mnemopi memory, and
  the zero-tax `dyn` bus. 497 tool tests + 18 doctests and 58 memory tests pass;
  see [`harness/docs/stage4-gate.md`](harness/docs/stage4-gate.md).
- **Stage 5 shared contract — complete**: object-safe agent kernel, ten Director families plus
  TTSR, rule discovery and CLI, approval/budget controls, production assembly,
  and real durable subagents with IRC and a live Gateway Agents panel. Shared
  read-only child transcripts never double-open a journal; see
  [`harness/docs/stage5-gate.md`](harness/docs/stage5-gate.md). The complete
  Stage 5 control surface (`cli`/`sdk`/`serve`, ≥92 slash commands, and full
  role routing) remains in progress.
- **Native TUI — available**: `cargo run -p omp-cli -- --root <project>` starts
  the inline `omp` workbench with streaming tools, approvals, subagents, and
  durable sessions. `omp print` and `omp render` cover headless turns and replay.
- **Local web UI — available**: `cargo run -p omp-gateway -- --root <project>`
  opens a loopback workbench (sessions, streaming, real tools, subagents,
  settings) with a credential-free Demo provider. See
  [`harness/crates/gateway/README.md`](harness/crates/gateway/README.md).

Run the workspace gate with:

```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File harness/scripts/gate.ps1
```

## Upstream reference (not vendored)

This repo does **not** contain upstream source. Clone the two reference trees locally:

```sh
git clone --depth 1 --branch main https://github.com/can1357/oh-my-pi.git oh-my-pi
git -C oh-my-pi fetch --depth 1 origin omp2:omp2
git -C oh-my-pi worktree add ../oh-my-pi-v2 omp2
```

> **Windows note:** upstream v2 ships `crates/con`, and `CON` is a reserved Windows device
> name, so a plain checkout of that branch fails. Check out with `--no-checkout` plus
> sparse-checkout excluding `crates/con`, then extract it under a safe name:
>
> ```sh
> git -C oh-my-pi config core.protectNTFS false
> git -C oh-my-pi worktree add --no-checkout ../oh-my-pi-v2 omp2
> git -C oh-my-pi-v2 sparse-checkout init --no-cone
> git -C oh-my-pi-v2 sparse-checkout set '/*' '!/crates/con/'
> git -C oh-my-pi-v2 checkout omp2
> mkdir -p oh-my-pi-v2/crates/convar
> git -C oh-my-pi archive omp2:crates/con | tar -x -C oh-my-pi-v2/crates/convar
> ```
>
> Our own tree renames that crate to `omp-convar` permanently (see SRS `PLT-02`).

## License

Upstream `omp` is MIT (© Mario Zechner, © Can Bölük, © Stencil Labs, Inc.).
This project's own specifications and code are MIT; any ported upstream code retains its
original notices.