# bzilee/craft-anything architecture

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

- Interactive diagram: https://gitdiagram.com/bzilee/craft-anything
- Repository: https://github.com/bzilee/craft-anything

## Overview

Craft Anything studies websites, apps, games, and files, then uses a coding agent to build a clean-room recreation, checks it against the target, and supports refinement. Desktop UI and CLI drive a shared Rust engine; a browser viewer provides a narrower, in-page file-triage experience. The README documents the product workflow and capabilities; sampled source confirms key app, session, project, and tool boundaries, but many implementation links remain unverified.

Main entry points: [`crates/engine/src/session.rs`](https://github.com/bzilee/craft-anything/blob/main/crates/engine/src/session.rs) (Session), [`apps/craft-anything/src/main.rs`](https://github.com/bzilee/craft-anything/blob/main/apps/craft-anything/src/main.rs) (Desktop app), [`apps/craft-anything-cli/src/main.rs`](https://github.com/bzilee/craft-anything/blob/main/apps/craft-anything-cli/src/main.rs) (CLI tools), [`crates/ai/src/rebuild/mod.rs`](https://github.com/bzilee/craft-anything/blob/main/crates/ai/src/rebuild/mod.rs) (Study and rebuild)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entrypoints["User entrypoints"]
  node_desktop["Desktop app<br/>[main.rs]"]
  node_cli["CLI tools<br/>[main.rs]"]
  node_web["Browser viewer<br/>[viewer.rs]"]
  node_ui["Workbench UI<br/>[engine_ui.rs]"]
end

subgraph group_workflow["Rebuild workflow"]
  node_session["Session<br/>[session.rs]"]
  node_target["Target handling<br/>[target.rs]"]
  node_rebuild["Study and rebuild<br/>[mod.rs]"]
  node_check["Build comparison<br/>[check.rs]"]
end

subgraph group_inspection["Inspection engine"]
  node_tooling["Tool registry<br/>[tool.rs]"]
  node_investigation["Investigation tools"]
  node_analysis["File analysis<br/>[native.rs]"]
  node_disassembly["Disassembly<br/>[program.rs]"]
  node_formats["File formats<br/>[pe.rs]"]
  node_engines["Inspection engines<br/>[lib.rs]"]
end

subgraph group_intelligence["AI and evidence"]
  node_ai["AI providers<br/>[providers.rs]"]
  node_agents["Coding agents<br/>[mod.rs]"]
  node_evidence[("Evidence ledger<br/>[lib.rs]")]
end

subgraph group_runtime["Persistence and integrations"]
  node_project[("Project store<br/>[project.rs]")]
  node_cleanroom["Clean-room policy<br/>[clean_room.rs]"]
  node_mcp["MCP interface<br/>[lib.rs]"]
end

node_user(("Person or agent"))

node_user -->|"starts work"| node_desktop
node_user -->|"runs commands"| node_cli
node_user -->|"opens file"| node_web
node_desktop -->|"opens interface"| node_ui
node_cli -->|"dispatches tools"| node_tooling
node_desktop -->|"creates session"| node_session
node_cli -.->|"uses engine"| node_session
node_ui -.->|"drives workflow"| node_session
node_session -->|"opens targets"| node_target
node_session -->|"loads project"| node_project
node_session -->|"tracks findings"| node_evidence
node_session -->|"applies policy"| node_cleanroom
node_tooling -.->|"registers tools"| node_investigation
node_investigation -.->|"inspects targets"| node_analysis
node_analysis -.->|"analyzes programs"| node_disassembly
node_analysis -.->|"parses formats"| node_formats
node_investigation -.->|"uses engines"| node_engines
node_session -.->|"starts rebuild"| node_rebuild
node_rebuild -.->|"delegates build"| node_agents
node_agents -.->|"uses provider"| node_ai
node_rebuild -->|"checks result"| node_check
node_check -.->|"records findings"| node_evidence
node_web -->|"triages file"| node_target
node_user -->|"connects agent"| node_mcp

click node_desktop "https://github.com/bzilee/craft-anything/blob/main/apps/craft-anything/src/main.rs"
click node_cli "https://github.com/bzilee/craft-anything/blob/main/apps/craft-anything-cli/src/main.rs"
click node_web "https://github.com/bzilee/craft-anything/blob/main/apps/craft-anything-web/src/viewer.rs"
click node_ui "https://github.com/bzilee/craft-anything/blob/main/crates/ui-egui/src/engine_ui.rs"
click node_session "https://github.com/bzilee/craft-anything/blob/main/crates/engine/src/session.rs"
click node_target "https://github.com/bzilee/craft-anything/blob/main/crates/engine/src/target.rs"
click node_rebuild "https://github.com/bzilee/craft-anything/blob/main/crates/ai/src/rebuild/mod.rs"
click node_check "https://github.com/bzilee/craft-anything/blob/main/crates/ai/src/rebuild/check.rs"
click node_tooling "https://github.com/bzilee/craft-anything/blob/main/crates/engine/src/tool.rs"
click node_investigation "https://github.com/bzilee/craft-anything/blob/main/crates/engine/src/tools/investigation_tools.rs"
click node_analysis "https://github.com/bzilee/craft-anything/blob/main/crates/analysis/src/native.rs"
click node_disassembly "https://github.com/bzilee/craft-anything/blob/main/crates/disasm/src/program.rs"
click node_formats "https://github.com/bzilee/craft-anything/blob/main/crates/formats/src/pe.rs"
click node_engines "https://github.com/bzilee/craft-anything/blob/main/crates/engines/src/lib.rs"
click node_ai "https://github.com/bzilee/craft-anything/blob/main/crates/ai/src/providers.rs"
click node_agents "https://github.com/bzilee/craft-anything/blob/main/crates/ai/src/cli_agents/mod.rs"
click node_evidence "https://github.com/bzilee/craft-anything/blob/main/crates/evidence/src/lib.rs"
click node_project "https://github.com/bzilee/craft-anything/blob/main/crates/engine/src/project.rs"
click node_cleanroom "https://github.com/bzilee/craft-anything/blob/main/crates/engine/src/clean_room.rs"
click node_mcp "https://github.com/bzilee/craft-anything/blob/main/crates/mcp/src/lib.rs"

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_cli,node_web,node_ui toneBlue
class node_session,node_target,node_rebuild,node_check toneAmber
class node_tooling,node_investigation,node_analysis,node_disassembly,node_formats,node_engines toneMint
class node_ai,node_agents,node_evidence toneRose
class node_project,node_cleanroom,node_mcp,node_user toneIndigo
```

## Components

### User entrypoints

- [Desktop app](https://github.com/bzilee/craft-anything/blob/main/apps/craft-anything/src/main.rs): `apps/craft-anything/src/main.rs`
- [CLI tools](https://github.com/bzilee/craft-anything/blob/main/apps/craft-anything-cli/src/main.rs): `apps/craft-anything-cli/src/main.rs`
- [Browser viewer](https://github.com/bzilee/craft-anything/blob/main/apps/craft-anything-web/src/viewer.rs): `apps/craft-anything-web/src/viewer.rs`
- [Workbench UI](https://github.com/bzilee/craft-anything/blob/main/crates/ui-egui/src/engine_ui.rs): `crates/ui-egui/src/engine_ui.rs`

### Rebuild workflow

- [Session](https://github.com/bzilee/craft-anything/blob/main/crates/engine/src/session.rs): `crates/engine/src/session.rs`
- [Target handling](https://github.com/bzilee/craft-anything/blob/main/crates/engine/src/target.rs): `crates/engine/src/target.rs`
- [Study and rebuild](https://github.com/bzilee/craft-anything/blob/main/crates/ai/src/rebuild/mod.rs): `crates/ai/src/rebuild/mod.rs`
- [Build comparison](https://github.com/bzilee/craft-anything/blob/main/crates/ai/src/rebuild/check.rs): `crates/ai/src/rebuild/check.rs`

### Inspection engine

- [Tool registry](https://github.com/bzilee/craft-anything/blob/main/crates/engine/src/tool.rs): `crates/engine/src/tool.rs`
- [Investigation tools](https://github.com/bzilee/craft-anything/blob/main/crates/engine/src/tools/investigation_tools.rs): `crates/engine/src/tools/investigation_tools.rs`
- [File analysis](https://github.com/bzilee/craft-anything/blob/main/crates/analysis/src/native.rs): `crates/analysis/src/native.rs`
- [Disassembly](https://github.com/bzilee/craft-anything/blob/main/crates/disasm/src/program.rs): `crates/disasm/src/program.rs`
- [File formats](https://github.com/bzilee/craft-anything/blob/main/crates/formats/src/pe.rs): `crates/formats/src/pe.rs`
- [Inspection engines](https://github.com/bzilee/craft-anything/blob/main/crates/engines/src/lib.rs): `crates/engines/src/lib.rs`

### AI and evidence

- [AI providers](https://github.com/bzilee/craft-anything/blob/main/crates/ai/src/providers.rs): `crates/ai/src/providers.rs`
- [Coding agents](https://github.com/bzilee/craft-anything/blob/main/crates/ai/src/cli_agents/mod.rs): `crates/ai/src/cli_agents/mod.rs`
- [Evidence ledger](https://github.com/bzilee/craft-anything/blob/main/crates/evidence/src/lib.rs): `crates/evidence/src/lib.rs`

### Persistence and integrations

- [Project store](https://github.com/bzilee/craft-anything/blob/main/crates/engine/src/project.rs): `crates/engine/src/project.rs`
- [Clean-room policy](https://github.com/bzilee/craft-anything/blob/main/crates/engine/src/clean_room.rs): `crates/engine/src/clean_room.rs`
- [MCP interface](https://github.com/bzilee/craft-anything/blob/main/crates/mcp/src/lib.rs): `crates/mcp/src/lib.rs`

### Other components

- **Person or agent**

## Connections

- Person or agent → Desktop app: starts work (evidence: `README.md`)
- Person or agent → CLI tools: runs commands (evidence: `README.md`)
- Person or agent → Browser viewer: opens file (evidence: `README.md`)
- Desktop app → Workbench UI: opens interface (evidence: `apps/craft-anything/src/main.rs`)
- CLI tools → Tool registry: dispatches tools (evidence: `apps/craft-anything-cli/src/main.rs`)
- Desktop app → Session: creates session (evidence: `apps/craft-anything/src/main.rs`)
- CLI tools → Session: uses engine
- Workbench UI → Session: drives workflow
- Session → Target handling: opens targets (evidence: `crates/engine/src/session.rs`)
- Session → Project store: loads project (evidence: `crates/engine/src/project.rs`)
- Session → Evidence ledger: tracks findings (evidence: `crates/engine/src/session.rs`)
- Session → Clean-room policy: applies policy (evidence: `crates/engine/src/session.rs`)
- Tool registry → Investigation tools: registers tools
- Investigation tools → File analysis: inspects targets
- File analysis → Disassembly: analyzes programs
- File analysis → File formats: parses formats
- Investigation tools → Inspection engines: uses engines
- Session → Study and rebuild: starts rebuild
- Study and rebuild → Coding agents: delegates build
- Coding agents → AI providers: uses provider
- Study and rebuild → Build comparison: checks result (evidence: `README.md`)
- Build comparison → Evidence ledger: records findings
- Browser viewer → Target handling: triages file
- Person or agent → MCP interface: connects agent (evidence: `README.md`)
