# littlegenius44/local-harness-pi architecture

> Architecture diagram of the GitHub repository littlegenius44/local-harness-pi, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/littlegenius44/local-harness-pi
- Repository: https://github.com/littlegenius44/local-harness-pi

## Overview

This repository contains architecture, requirements, contracts, and implementation plans—not executable product code. The graph therefore represents the documented V1 design: a local-first desktop coding agent using DSH as its product platform and conversation/execution recovery authority, with Pi as the tool-loop kernel. Paths identify the relevant design documents; connections are limited to relationships stated by the README and the documented product scope. Detailed runtime wiring cannot be verified here.

Main entry points: [`docs/superpowers/plans/2026-09-10-local-harness-pi-pr-c-product-loop.md`](https://github.com/littlegenius44/local-harness-pi/blob/main/docs/superpowers/plans/2026-09-10-local-harness-pi-pr-c-product-loop.md) (Desktop app), [`docs/superpowers/specs/2026-09-09-local-harness-pi-v1-design.md`](https://github.com/littlegenius44/local-harness-pi/blob/main/docs/superpowers/specs/2026-09-09-local-harness-pi-v1-design.md) (DSH platform), [`docs/superpowers/plans/2026-09-18-agent-machine-seam-rectification.md`](https://github.com/littlegenius44/local-harness-pi/blob/main/docs/superpowers/plans/2026-09-18-agent-machine-seam-rectification.md) (Agent machine seam), [`docs/architecture/interface-contracts.md`](https://github.com/littlegenius44/local-harness-pi/blob/main/docs/architecture/interface-contracts.md) (Interface contracts)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop product"]
  node_desktop["Desktop app"]
  node_workspace["Local workspace<br/>[v1-requirements.md]"]
end

subgraph group_runtime["Agent runtime"]
  node_dsh["DSH platform"]
  node_agent["Agent machine seam"]
  node_pi["Pi tool-loop kernel"]
  node_authority["Conversation/recovery authority"]
  node_contracts["Interface contracts"]
end

subgraph group_configuration["Configuration"]
  node_provider_config["Provider configuration"]
end

node_user(("Developer"))
node_provider["OpenAI-compatible provider"]

node_user -->|"uses"| node_desktop
node_desktop -->|"uses platform"| node_dsh
node_dsh -->|"integrates seam"| node_agent
node_agent -->|"hosts kernel"| node_pi
node_dsh -->|"owns recovery truth"| node_authority
node_desktop -->|"works locally"| node_workspace
node_desktop -->|"configures"| node_provider_config
node_provider_config -.->|"configures access"| node_provider
node_contracts -->|"specifies interfaces"| node_dsh

click node_desktop "https://github.com/littlegenius44/local-harness-pi/blob/main/docs/superpowers/plans/2026-09-10-local-harness-pi-pr-c-product-loop.md"
click node_workspace "https://github.com/littlegenius44/local-harness-pi/blob/main/docs/requirements/v1-requirements.md"
click node_dsh "https://github.com/littlegenius44/local-harness-pi/blob/main/docs/superpowers/specs/2026-09-09-local-harness-pi-v1-design.md"
click node_agent "https://github.com/littlegenius44/local-harness-pi/blob/main/docs/superpowers/plans/2026-09-18-agent-machine-seam-rectification.md"
click node_pi "https://github.com/littlegenius44/local-harness-pi/blob/main/docs/superpowers/plans/2026-09-10-local-harness-pi-pr-b-pi-kernel.md"
click node_authority "https://github.com/littlegenius44/local-harness-pi/blob/main/docs/architecture/session-consistency.md"
click node_contracts "https://github.com/littlegenius44/local-harness-pi/blob/main/docs/architecture/interface-contracts.md"
click node_provider_config "https://github.com/littlegenius44/local-harness-pi/blob/main/docs/superpowers/plans/2026-09-10-local-harness-pi-pr-c-product-loop.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_desktop,node_workspace toneBlue
class node_dsh,node_agent,node_pi,node_authority,node_contracts toneAmber
class node_provider_config toneMint
class node_user,node_provider toneIndigo
```

## Components

### Desktop product

- [Desktop app](https://github.com/littlegenius44/local-harness-pi/blob/main/docs/superpowers/plans/2026-09-10-local-harness-pi-pr-c-product-loop.md): `docs/superpowers/plans/2026-09-10-local-harness-pi-pr-c-product-loop.md`
- [Local workspace](https://github.com/littlegenius44/local-harness-pi/blob/main/docs/requirements/v1-requirements.md): `docs/requirements/v1-requirements.md`

### Agent runtime

- [DSH platform](https://github.com/littlegenius44/local-harness-pi/blob/main/docs/superpowers/specs/2026-09-09-local-harness-pi-v1-design.md): `docs/superpowers/specs/2026-09-09-local-harness-pi-v1-design.md`
- [Agent machine seam](https://github.com/littlegenius44/local-harness-pi/blob/main/docs/superpowers/plans/2026-09-18-agent-machine-seam-rectification.md): `docs/superpowers/plans/2026-09-18-agent-machine-seam-rectification.md`
- [Pi tool-loop kernel](https://github.com/littlegenius44/local-harness-pi/blob/main/docs/superpowers/plans/2026-09-10-local-harness-pi-pr-b-pi-kernel.md): `docs/superpowers/plans/2026-09-10-local-harness-pi-pr-b-pi-kernel.md`
- [Conversation/recovery authority](https://github.com/littlegenius44/local-harness-pi/blob/main/docs/architecture/session-consistency.md): `docs/architecture/session-consistency.md`
- [Interface contracts](https://github.com/littlegenius44/local-harness-pi/blob/main/docs/architecture/interface-contracts.md): `docs/architecture/interface-contracts.md`

### Configuration

- [Provider configuration](https://github.com/littlegenius44/local-harness-pi/blob/main/docs/superpowers/plans/2026-09-10-local-harness-pi-pr-c-product-loop.md): `docs/superpowers/plans/2026-09-10-local-harness-pi-pr-c-product-loop.md`

### Other components

- **Developer**
- **OpenAI-compatible provider**

## Connections

- Developer → Desktop app: uses
- Desktop app → DSH platform: uses platform
- DSH platform → Agent machine seam: integrates seam
- Agent machine seam → Pi tool-loop kernel: hosts kernel
- DSH platform → Conversation/recovery authority: owns recovery truth
- Desktop app → Local workspace: works locally
- Desktop app → Provider configuration: configures
- Provider configuration → OpenAI-compatible provider: configures access
- Interface contracts → DSH platform: specifies interfaces