smlflg/AIOS-Cockpit

AIOS Cockpit

Local cockpit for the agentic operating system that is already spread across Samuel's projects.

This repo is the cockpit layer only. It does not replace the existing sources of truth:

• samuel-os-v2 owns focus, inbox, decisions, and learning discipline.
• KomandoZentral owns deterministic routing decisions.
• Zentrale owns context packs, harness profiles, and run records.
• ProjectDashboard remains useful prior art for project scanning.
• PromptGarage owns prompt memory.
• Sidecar-V8 owns assistant coaching and safety.
• Harness projects own evidence and eval results.

Run

cd /home/smlflg/Projekte/AIOS-Cockpit
python -m aios_cockpit.cli snapshot
python -m aios_cockpit.app

Then open:

http://127.0.0.1:8092

What the MVP does

• Shows today's focus from samuel-os-v2.
• Scans ~/Projekte for active, source-of-truth, experiment, and archive candidates.
• Provides project detail pages with README/PLAN excerpts and delegation warnings.
• Reads harness profiles and latest runs from Zentrale.
• Provides run detail pages for Zentrale RUN.json and log.json artifacts.
• Reads PromptGarage stats without mutating the database.
• Reads first harness-eval signals from the SWE-bench Lite experiment DB.
• Mounts CodexMaxHarnessHowTo as /codex-max-harness/.
• Produces canonical implementation handoffs for Codex/OpenCode/Claude.
• Saves handoffs as auditable Markdown artifacts under handoffs/.
• Calls KomandoZentral in-memory when available; otherwise returns a conservative fallback routing recommendation.

V2 flow

1. Open the cockpit and inspect today's focus.
2. Open a source-of-truth or active project detail page.
3. Create a handoff from that project page or from the cockpit form.
4. Review the saved handoff under /handoffs.
5. Use the handoff as the bounded implementation prompt for Codex/OpenCode.

Generated handoffs are local repo artifacts. They are the first intentional write flow in this cockpit and are kept small enough to inspect before use.

V3 workbench

V3 adds the first real working surface:

• /workbench is now the primary entry point.
• Pick a project and convert README/PLAN signals into sprint candidates.
• Add candidates to a cockpit-local task queue.
• Route tasks through KomandoZentral.
• Save agent-neutral handoffs from a task.
• Prepare and dry-run a Zentrale opencode-prompt launch command.

The run launcher is guarded: it writes instructions and preview records under workspace/, uses --dry-run, and does not edit source projects. A future version can add an explicit execute mode after the preview workflow proves useful.

Working rule

The cockpit is allowed to aggregate and display truth. It must not become a new competing truth store unless a field cannot reasonably live in an existing system.

Still out of scope

• Starting autonomous source-mutating agents from the UI.
• Writing into upstream projects.
• Replacing Zentrale or KomandoZentral.
• Importing every historical project into a new database.