# jofyni/code-atlas architecture

> Architecture diagram of the GitHub repository jofyni/code-atlas, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jofyni/code-atlas
- Repository: https://github.com/jofyni/code-atlas

## Overview

CodeAtlas is a local Claude Code workbench: the user submits a request, Claude works in the selected project through the Python bridge, and the browser UI streams activity into a live code graph. The graph also supports review, approval, rollback, execution and analysis. The README documents these capabilities, but the sampled bridge excerpts do not expose most route-level wiring, so relationships below are limited to documented flows; the bridge is a monolithic implementation.

Main entry points: [`codeatlas_bridge.py`](https://github.com/jofyni/code-atlas/blob/main/codeatlas_bridge.py) (Local bridge), [`src/CodeAtlasLab.jsx`](https://github.com/jofyni/code-atlas/blob/main/src/CodeAtlasLab.jsx) (Live code graph)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_work["Work session"]
  node_ui["Workbench UI<br/>[CodeAtlasLab.jsx]"]
  node_bridge["Local bridge"]
  node_activity["Activity stream"]
  node_graph["Live code graph<br/>[CodeAtlasLab.jsx]"]
end

subgraph group_review["Review and control"]
  node_approvals["Command approvals"]
  node_change_review["Change review<br/>[CodeAtlasLab.jsx]"]
  node_snapshots[("Snapshots and rollback")]
end

subgraph group_run["Execution and tests"]
  node_runner["Program runner"]
  node_trace["Live call trace"]
  node_tests["Test runner"]
end

subgraph group_insight["Project insight"]
  node_mcp["MCP graph tools"]
  node_impact["Impact analysis"]
  node_architecture["Architecture analysis"]
end

subgraph group_coord["Planning and teams"]
  node_pipeline["Idea-to-task pipeline"]
  node_quality["Quality gate"]
  node_agents["Team agents"]
end

node_user(("Developer"))
node_claude(("Claude Code"))
node_project[("Project files")]

node_user -->|"submits request"| node_ui
node_ui -->|"sends session"| node_bridge
node_bridge -->|"runs Claude Code"| node_claude
node_claude -->|"reads and edits"| node_project
node_bridge -->|"streams steps"| node_activity
node_activity -->|"updates graph"| node_graph
node_user -->|"reviews commands"| node_approvals
node_approvals -->|"allows or denies"| node_claude
node_bridge -->|"saves checkpoint"| node_snapshots
node_user -->|"reviews changes"| node_change_review
node_change_review -->|"requests rollback"| node_snapshots
node_user -->|"starts program"| node_runner
node_runner -->|"captures calls"| node_trace
node_trace -->|"shows trace"| node_graph
node_user -->|"runs tests"| node_tests
node_claude -->|"queries graph"| node_mcp
node_mcp -->|"reads project graph"| node_graph
node_user -->|"requests impact"| node_impact
node_impact -->|"identifies affected tests"| node_tests
node_user -->|"reviews architecture"| node_architecture
node_user -->|"defines idea"| node_pipeline
node_pipeline -->|"assigns tasks"| node_claude
node_quality -->|"checks tests"| node_tests
node_quality -->|"returns failures"| node_claude
node_user -->|"starts team work"| node_agents
node_agents -->|"uses Git worktrees"| node_project

click node_ui "https://github.com/jofyni/code-atlas/blob/main/src/CodeAtlasLab.jsx"
click node_bridge "https://github.com/jofyni/code-atlas/blob/main/codeatlas_bridge.py"
click node_activity "https://github.com/jofyni/code-atlas/blob/main/codeatlas_bridge.py"
click node_graph "https://github.com/jofyni/code-atlas/blob/main/src/CodeAtlasLab.jsx"
click node_approvals "https://github.com/jofyni/code-atlas/blob/main/codeatlas_bridge.py"
click node_change_review "https://github.com/jofyni/code-atlas/blob/main/src/CodeAtlasLab.jsx"
click node_snapshots "https://github.com/jofyni/code-atlas/blob/main/codeatlas_bridge.py"
click node_runner "https://github.com/jofyni/code-atlas/blob/main/codeatlas_bridge.py"
click node_trace "https://github.com/jofyni/code-atlas/blob/main/codeatlas_bridge.py"
click node_tests "https://github.com/jofyni/code-atlas/blob/main/codeatlas_bridge.py"
click node_mcp "https://github.com/jofyni/code-atlas/blob/main/codeatlas_bridge.py"
click node_impact "https://github.com/jofyni/code-atlas/blob/main/codeatlas_bridge.py"
click node_architecture "https://github.com/jofyni/code-atlas/blob/main/codeatlas_bridge.py"
click node_pipeline "https://github.com/jofyni/code-atlas/blob/main/codeatlas_bridge.py"
click node_quality "https://github.com/jofyni/code-atlas/blob/main/codeatlas_bridge.py"
click node_agents "https://github.com/jofyni/code-atlas/blob/main/codeatlas_bridge.py"

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_ui,node_bridge,node_activity,node_graph toneBlue
class node_approvals,node_change_review,node_snapshots,node_project toneAmber
class node_runner,node_trace,node_tests toneMint
class node_mcp,node_impact,node_architecture toneRose
class node_pipeline,node_quality,node_agents,node_user,node_claude toneIndigo
```

## Components

### Work session

- [Workbench UI](https://github.com/jofyni/code-atlas/blob/main/src/CodeAtlasLab.jsx): `src/CodeAtlasLab.jsx`
- [Local bridge](https://github.com/jofyni/code-atlas/blob/main/codeatlas_bridge.py): `codeatlas_bridge.py`
- [Activity stream](https://github.com/jofyni/code-atlas/blob/main/codeatlas_bridge.py): `codeatlas_bridge.py`
- [Live code graph](https://github.com/jofyni/code-atlas/blob/main/src/CodeAtlasLab.jsx): `src/CodeAtlasLab.jsx`

### Review and control

- [Command approvals](https://github.com/jofyni/code-atlas/blob/main/codeatlas_bridge.py): `codeatlas_bridge.py`
- [Change review](https://github.com/jofyni/code-atlas/blob/main/src/CodeAtlasLab.jsx): `src/CodeAtlasLab.jsx`
- [Snapshots and rollback](https://github.com/jofyni/code-atlas/blob/main/codeatlas_bridge.py): `codeatlas_bridge.py`

### Execution and tests

- [Program runner](https://github.com/jofyni/code-atlas/blob/main/codeatlas_bridge.py): `codeatlas_bridge.py`
- [Live call trace](https://github.com/jofyni/code-atlas/blob/main/codeatlas_bridge.py): `codeatlas_bridge.py`
- [Test runner](https://github.com/jofyni/code-atlas/blob/main/codeatlas_bridge.py): `codeatlas_bridge.py`

### Project insight

- [MCP graph tools](https://github.com/jofyni/code-atlas/blob/main/codeatlas_bridge.py): `codeatlas_bridge.py`
- [Impact analysis](https://github.com/jofyni/code-atlas/blob/main/codeatlas_bridge.py): `codeatlas_bridge.py`
- [Architecture analysis](https://github.com/jofyni/code-atlas/blob/main/codeatlas_bridge.py): `codeatlas_bridge.py`

### Planning and teams

- [Idea-to-task pipeline](https://github.com/jofyni/code-atlas/blob/main/codeatlas_bridge.py): `codeatlas_bridge.py`
- [Quality gate](https://github.com/jofyni/code-atlas/blob/main/codeatlas_bridge.py): `codeatlas_bridge.py`
- [Team agents](https://github.com/jofyni/code-atlas/blob/main/codeatlas_bridge.py): `codeatlas_bridge.py`

### Other components

- **Developer**
- **Claude Code**
- **Project files**

## Connections

- Developer → Workbench UI: submits request (evidence: `README.md`)
- Workbench UI → Local bridge: sends session (evidence: `README.md`)
- Local bridge → Claude Code: runs Claude Code (evidence: `README.md`)
- Claude Code → Project files: reads and edits (evidence: `README.md`)
- Local bridge → Activity stream: streams steps (evidence: `README.md`)
- Activity stream → Live code graph: updates graph (evidence: `README.md`)
- Developer → Command approvals: reviews commands (evidence: `README.md`)
- Command approvals → Claude Code: allows or denies (evidence: `README.md`)
- Local bridge → Snapshots and rollback: saves checkpoint (evidence: `README.md`)
- Developer → Change review: reviews changes (evidence: `README.md`)
- Change review → Snapshots and rollback: requests rollback (evidence: `README.md`)
- Developer → Program runner: starts program (evidence: `README.md`)
- Program runner → Live call trace: captures calls (evidence: `README.md`)
- Live call trace → Live code graph: shows trace (evidence: `README.md`)
- Developer → Test runner: runs tests (evidence: `README.md`)
- Claude Code → MCP graph tools: queries graph (evidence: `README.md`)
- MCP graph tools → Live code graph: reads project graph (evidence: `README.md`)
- Developer → Impact analysis: requests impact (evidence: `README.md`)
- Impact analysis → Test runner: identifies affected tests (evidence: `README.md`)
- Developer → Architecture analysis: reviews architecture (evidence: `README.md`)
- Developer → Idea-to-task pipeline: defines idea (evidence: `README.md`)
- Idea-to-task pipeline → Claude Code: assigns tasks (evidence: `README.md`)
- Quality gate → Test runner: checks tests (evidence: `README.md`)
- Quality gate → Claude Code: returns failures (evidence: `README.md`)
- Developer → Team agents: starts team work (evidence: `README.md`)
- Team agents → Project files: uses Git worktrees (evidence: `README.md`)
