# dayuanjiang/pecofence architecture

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

- Interactive diagram: https://gitdiagram.com/dayuanjiang/pecofence
- Repository: https://github.com/dayuanjiang/pecofence

## Overview

PecoFence is a native Windows desktop organizer that groups desktop files in glass panels (fences), with tabs, automatic sorting rules, and file-management interactions. The main workflow is user or CLI request → app command handling → persistent layout/configuration and fence windows → rendered desktop panels; file-system changes can then be sorted into groups by rules. The README documents CLI and feature behavior, while sampled sources confirm app startup, command queuing, rendering, and named-pipe transport. Some feature internals were not sampled, so those documented connections are marked dashed.

Main entry points: [`crates/app/src/app/mod.rs`](https://github.com/dayuanjiang/pecofence/blob/main/crates/app/src/app/mod.rs) (App runtime), [`crates/cli/src/run.rs`](https://github.com/dayuanjiang/pecofence/blob/main/crates/cli/src/run.rs) (CLI commands), [`crates/app/src/fence_window/mod.rs`](https://github.com/dayuanjiang/pecofence/blob/main/crates/app/src/fence_window/mod.rs) (Fence windows), [`crates/app/src/ipc_server.rs`](https://github.com/dayuanjiang/pecofence/blob/main/crates/app/src/ipc_server.rs) (App IPC server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["Desktop interaction"]
  node_app["App runtime<br/>[mod.rs]"]
  node_fence["Fence windows<br/>[mod.rs]"]
  node_fileops["File interactions<br/>[fileops.rs]"]
  node_tabs["Tabs and portals<br/>[tabs.rs]"]
  node_peek["Peek desktop<br/>[peek.rs]"]
  node_settings["Settings panel<br/>[settings_host.rs]"]
end

subgraph group_domain["Organization state"]
  node_layout["Layout state<br/>[model.rs]"]
  node_rules["Auto-sort rules<br/>[rules.rs]"]
  node_config[("Config storage<br/>[config_store.rs]")]
end

subgraph group_presentation["Native presentation"]
  node_chrome["Fence rendering<br/>[fence_chrome.rs]"]
  node_glass["Glass effects<br/>[liquid_glass.rs]"]
end

subgraph group_integration["System integration"]
  node_anchor["Desktop anchoring<br/>[anchor.rs]"]
  node_platform["Windows services<br/>[shell.rs]"]
end

subgraph group_automation["CLI automation"]
  node_ipc["IPC protocol<br/>[dto.rs]"]
  node_server["App IPC server<br/>[ipc_server.rs]"]
  node_cli["CLI commands<br/>[run.rs]"]
  node_client["Named-pipe client<br/>[client.rs]"]
  node_snapshot["Snapshots and config transfer<br/>[ipc.rs]"]
end

node_user(("Desktop user"))
node_agent(("AI agent"))
node_shell["Windows Explorer"]

node_user -.->|"organizes desktop"| node_app
node_agent -.->|"issues commands"| node_cli
node_app -->|"manages windows"| node_fence
node_fence -.->|"reads layout"| node_layout
node_fence -.->|"renders panels"| node_chrome
node_chrome -->|"uses glass effects"| node_glass
node_fence -.->|"handles file actions"| node_fileops
node_app -.->|"sorts new files"| node_rules
node_rules -->|"assigns files"| node_layout
node_app -.->|"manages workspaces"| node_tabs
node_app -->|"handles peek"| node_peek
node_app -->|"anchors fences"| node_anchor
node_anchor -->|"uses desktop APIs"| node_platform
node_platform -.->|"invokes Explorer"| node_shell
node_app -->|"hosts settings"| node_settings
node_settings -.->|"persists settings"| node_config
node_app -->|"serves requests"| node_server
node_agent -.->|"requests changes"| node_cli
node_cli -->|"sends request"| node_client
node_client -->|"exchanges pipe data"| node_server
node_cli -.->|"uses request schema"| node_ipc
node_server -->|"uses IPC types"| node_ipc
node_server -->|"dispatches commands"| node_app
node_cli -.->|"exports or restores"| node_snapshot
node_snapshot -.->|"transfers configuration"| node_config

click node_app "https://github.com/dayuanjiang/pecofence/blob/main/crates/app/src/app/mod.rs"
click node_fence "https://github.com/dayuanjiang/pecofence/blob/main/crates/app/src/fence_window/mod.rs"
click node_fileops "https://github.com/dayuanjiang/pecofence/blob/main/crates/app/src/app/fileops.rs"
click node_tabs "https://github.com/dayuanjiang/pecofence/blob/main/crates/app/src/app/tabs.rs"
click node_peek "https://github.com/dayuanjiang/pecofence/blob/main/crates/app/src/peek.rs"
click node_layout "https://github.com/dayuanjiang/pecofence/blob/main/crates/core/src/model.rs"
click node_rules "https://github.com/dayuanjiang/pecofence/blob/main/crates/core/src/rules.rs"
click node_config "https://github.com/dayuanjiang/pecofence/blob/main/crates/core/src/config_store.rs"
click node_settings "https://github.com/dayuanjiang/pecofence/blob/main/crates/app/src/settings_host.rs"
click node_chrome "https://github.com/dayuanjiang/pecofence/blob/main/crates/render/src/fence_chrome.rs"
click node_glass "https://github.com/dayuanjiang/pecofence/blob/main/crates/render/src/liquid_glass.rs"
click node_anchor "https://github.com/dayuanjiang/pecofence/blob/main/crates/app/src/anchor.rs"
click node_platform "https://github.com/dayuanjiang/pecofence/blob/main/crates/platform/src/shell.rs"
click node_ipc "https://github.com/dayuanjiang/pecofence/blob/main/crates/ipc/src/dto.rs"
click node_server "https://github.com/dayuanjiang/pecofence/blob/main/crates/app/src/ipc_server.rs"
click node_cli "https://github.com/dayuanjiang/pecofence/blob/main/crates/cli/src/run.rs"
click node_client "https://github.com/dayuanjiang/pecofence/blob/main/crates/cli/src/client.rs"
click node_snapshot "https://github.com/dayuanjiang/pecofence/blob/main/crates/app/src/app/ipc.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_app,node_fence,node_fileops,node_tabs,node_peek,node_settings,node_user toneBlue
class node_layout,node_rules,node_config toneAmber
class node_chrome,node_glass toneMint
class node_anchor,node_platform toneRose
class node_ipc,node_server,node_cli,node_client,node_snapshot,node_agent,node_shell toneIndigo
```

## Components

### Desktop interaction

- [App runtime](https://github.com/dayuanjiang/pecofence/blob/main/crates/app/src/app/mod.rs): `crates/app/src/app/mod.rs`
- [Fence windows](https://github.com/dayuanjiang/pecofence/blob/main/crates/app/src/fence_window/mod.rs): `crates/app/src/fence_window/mod.rs`
- [File interactions](https://github.com/dayuanjiang/pecofence/blob/main/crates/app/src/app/fileops.rs): `crates/app/src/app/fileops.rs`
- [Tabs and portals](https://github.com/dayuanjiang/pecofence/blob/main/crates/app/src/app/tabs.rs): `crates/app/src/app/tabs.rs`
- [Peek desktop](https://github.com/dayuanjiang/pecofence/blob/main/crates/app/src/peek.rs): `crates/app/src/peek.rs`
- [Settings panel](https://github.com/dayuanjiang/pecofence/blob/main/crates/app/src/settings_host.rs): `crates/app/src/settings_host.rs`

### Organization state

- [Layout state](https://github.com/dayuanjiang/pecofence/blob/main/crates/core/src/model.rs): `crates/core/src/model.rs`
- [Auto-sort rules](https://github.com/dayuanjiang/pecofence/blob/main/crates/core/src/rules.rs): `crates/core/src/rules.rs`
- [Config storage](https://github.com/dayuanjiang/pecofence/blob/main/crates/core/src/config_store.rs): `crates/core/src/config_store.rs`

### Native presentation

- [Fence rendering](https://github.com/dayuanjiang/pecofence/blob/main/crates/render/src/fence_chrome.rs): `crates/render/src/fence_chrome.rs`
- [Glass effects](https://github.com/dayuanjiang/pecofence/blob/main/crates/render/src/liquid_glass.rs): `crates/render/src/liquid_glass.rs`

### System integration

- [Desktop anchoring](https://github.com/dayuanjiang/pecofence/blob/main/crates/app/src/anchor.rs): `crates/app/src/anchor.rs`
- [Windows services](https://github.com/dayuanjiang/pecofence/blob/main/crates/platform/src/shell.rs): `crates/platform/src/shell.rs`

### CLI automation

- [IPC protocol](https://github.com/dayuanjiang/pecofence/blob/main/crates/ipc/src/dto.rs): `crates/ipc/src/dto.rs`
- [App IPC server](https://github.com/dayuanjiang/pecofence/blob/main/crates/app/src/ipc_server.rs): `crates/app/src/ipc_server.rs`
- [CLI commands](https://github.com/dayuanjiang/pecofence/blob/main/crates/cli/src/run.rs): `crates/cli/src/run.rs`
- [Named-pipe client](https://github.com/dayuanjiang/pecofence/blob/main/crates/cli/src/client.rs): `crates/cli/src/client.rs`
- [Snapshots and config transfer](https://github.com/dayuanjiang/pecofence/blob/main/crates/app/src/app/ipc.rs): `crates/app/src/app/ipc.rs`

### Other components

- **Desktop user**
- **AI agent**
- **Windows Explorer**

## Connections

- Desktop user → App runtime: organizes desktop
- AI agent → CLI commands: issues commands
- App runtime → Fence windows: manages windows (evidence: `crates/app/src/app/mod.rs`)
- Fence windows → Layout state: reads layout
- Fence windows → Fence rendering: renders panels
- Fence rendering → Glass effects: uses glass effects (evidence: `crates/render/src/fence_chrome.rs`)
- Fence windows → File interactions: handles file actions
- App runtime → Auto-sort rules: sorts new files
- Auto-sort rules → Layout state: assigns files (evidence: `crates/core/src/rules.rs`)
- App runtime → Tabs and portals: manages workspaces (evidence: `crates/app/src/app/mod.rs`)
- App runtime → Peek desktop: handles peek (evidence: `crates/app/src/main.rs`)
- App runtime → Desktop anchoring: anchors fences (evidence: `crates/app/src/main.rs`)
- Desktop anchoring → Windows services: uses desktop APIs (evidence: `crates/app/src/anchor.rs`)
- Windows services → Windows Explorer: invokes Explorer
- App runtime → Settings panel: hosts settings (evidence: `crates/app/src/main.rs`)
- Settings panel → Config storage: persists settings
- App runtime → App IPC server: serves requests (evidence: `crates/app/src/main.rs`)
- AI agent → CLI commands: requests changes
- CLI commands → Named-pipe client: sends request (evidence: `crates/cli/src/main.rs`)
- Named-pipe client → App IPC server: exchanges pipe data
- CLI commands → IPC protocol: uses request schema
- App IPC server → IPC protocol: uses IPC types (evidence: `crates/app/src/ipc_server.rs`)
- App IPC server → App runtime: dispatches commands (evidence: `crates/app/src/ipc_server.rs`)
- CLI commands → Snapshots and config transfer: exports or restores
- Snapshots and config transfer → Config storage: transfers configuration
