# leon4z/modus architecture

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

- Interactive diagram: https://gitdiagram.com/leon4z/modus
- Repository: https://github.com/leon4z/modus

## Overview

Modus is a local-first macOS workspace for inspecting and managing AI coding tools’ rules, Skills, MCP entries, and configuration files. Users select a management surface, review local tool state and proposed file changes, then confirm supported operations. The graph preserves the README’s distinct product areas and the backend capability-discovery layer. Several UI-to-command and command-to-domain links are shown as unverified because their wiring was not excerpted; source-index references support the cited backend relationships.

Main entry points: [`src/lib/app/AppShell.svelte`](https://github.com/leon4z/modus/blob/main/src/lib/app/AppShell.svelte) (App shell), [`src-tauri/src/adapters.rs`](https://github.com/leon4z/modus/blob/main/src-tauri/src/adapters.rs) (Tool adapters), [`src-tauri/src/domains/rules/management.rs`](https://github.com/leon4z/modus/blob/main/src-tauri/src/domains/rules/management.rs) (Rule management), [`src-tauri/src/domains/mcp/listing.rs`](https://github.com/leon4z/modus/blob/main/src-tauri/src/domains/mcp/listing.rs) (MCP listing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop interface"]
  node_shell["App shell<br/>[AppShell.svelte]"]
end

subgraph group_features["Management features"]
  node_dashboard_ui["Dashboard<br/>[Dashboard.svelte]"]
  node_rules_ui["Rules workspace<br/>[RulesModule.svelte]"]
  node_skills_ui["Skills workspace"]
  node_mcp_ui["MCP workspace<br/>[McpPanel.svelte]"]
  node_config_ui["Config editor<br/>[ConfigPanel.svelte]"]
  node_settings_ui["Settings"]
end

subgraph group_backend["Local management backend"]
  node_dashboard_domain["Dashboard queries<br/>[dashboard.rs]"]
  node_rules_domain["Rule management<br/>[management.rs]"]
  node_skills_domain["Skill operations<br/>[operations.rs]"]
  node_mcp_domain["MCP listing<br/>[listing.rs]"]
  node_settings_domain["Settings preferences<br/>[preferences.rs]"]
  node_app_config[("App configuration<br/>[config.rs]")]
  node_runtime_paths["Runtime paths<br/>[env.rs]"]
end

subgraph group_tool_model["Tool capability model"]
  node_adapters["Tool adapters<br/>[adapters.rs]"]
  node_registry[("Tool registry<br/>[registry.rs]")]
  node_capabilities["Capability projections"]
  node_effective_caps["Effective capabilities"]
  node_skill_shapes["Skill discovery<br/>[skills.rs]"]
end

node_user(("User"))

node_user -->|"uses"| node_shell
node_shell -.->|"offers"| node_dashboard_ui
node_shell -.->|"offers"| node_rules_ui
node_shell -.->|"offers"| node_skills_ui
node_shell -.->|"offers"| node_mcp_ui
node_shell -.->|"offers"| node_config_ui
node_shell -.->|"offers"| node_settings_ui
node_rules_ui -.->|"manages rules"| node_rules_domain
node_skills_ui -.->|"manages Skills"| node_skills_domain
node_mcp_ui -.->|"edits MCP"| node_mcp_domain
node_config_ui -.->|"reviews config"| node_adapters
node_dashboard_ui -.->|"summarizes tools"| node_dashboard_domain
node_settings_ui -.->|"sets preferences"| node_settings_domain
node_rules_domain -->|"uses tool adapters"| node_adapters
node_mcp_domain -->|"lists tool sources"| node_adapters
node_adapters -->|"resolves tools"| node_registry
node_adapters -->|"projects support"| node_capabilities
node_mcp_domain -->|"resolves access"| node_effective_caps
node_effective_caps -->|"applies overrides"| node_app_config
node_adapters -->|"selects adapters"| node_runtime_paths
node_adapters -->|"reads Skills"| node_skill_shapes
node_skills_domain -.->|"uses persisted state"| node_app_config
node_rules_domain -.->|"uses persisted state"| node_app_config

click node_shell "https://github.com/leon4z/modus/blob/main/src/lib/app/AppShell.svelte"
click node_dashboard_ui "https://github.com/leon4z/modus/blob/main/src/lib/features/dashboard/components/Dashboard.svelte"
click node_rules_ui "https://github.com/leon4z/modus/blob/main/src/lib/features/rules/components/RulesModule.svelte"
click node_skills_ui "https://github.com/leon4z/modus/blob/main/src/lib/features/skills/components/SkillsModule.svelte"
click node_mcp_ui "https://github.com/leon4z/modus/blob/main/src/lib/features/mcp/components/McpPanel.svelte"
click node_config_ui "https://github.com/leon4z/modus/blob/main/src/lib/features/config/components/ConfigPanel.svelte"
click node_settings_ui "https://github.com/leon4z/modus/blob/main/src/lib/features/settings/components/SettingsModule.svelte"
click node_dashboard_domain "https://github.com/leon4z/modus/blob/main/src-tauri/src/domains/tools/dashboard.rs"
click node_rules_domain "https://github.com/leon4z/modus/blob/main/src-tauri/src/domains/rules/management.rs"
click node_skills_domain "https://github.com/leon4z/modus/blob/main/src-tauri/src/domains/skills/operations.rs"
click node_mcp_domain "https://github.com/leon4z/modus/blob/main/src-tauri/src/domains/mcp/listing.rs"
click node_settings_domain "https://github.com/leon4z/modus/blob/main/src-tauri/src/domains/settings/preferences.rs"
click node_app_config "https://github.com/leon4z/modus/blob/main/src-tauri/src/platform/config.rs"
click node_runtime_paths "https://github.com/leon4z/modus/blob/main/src-tauri/src/platform/env.rs"
click node_adapters "https://github.com/leon4z/modus/blob/main/src-tauri/src/adapters.rs"
click node_registry "https://github.com/leon4z/modus/blob/main/src-tauri/src/platform/tool_catalog/registry.rs"
click node_capabilities "https://github.com/leon4z/modus/blob/main/src-tauri/src/platform/tool_capabilities/capability_projections.rs"
click node_effective_caps "https://github.com/leon4z/modus/blob/main/src-tauri/src/platform/tool_capabilities/effective_capabilities.rs"
click node_skill_shapes "https://github.com/leon4z/modus/blob/main/src-tauri/src/platform/tool_capabilities/skills.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_shell,node_user toneBlue
class node_dashboard_ui,node_rules_ui,node_skills_ui,node_mcp_ui,node_config_ui,node_settings_ui toneAmber
class node_dashboard_domain,node_rules_domain,node_skills_domain,node_mcp_domain,node_settings_domain,node_app_config,node_runtime_paths toneMint
class node_adapters,node_registry,node_capabilities,node_effective_caps,node_skill_shapes toneRose
```

## Components

### Desktop interface

- [App shell](https://github.com/leon4z/modus/blob/main/src/lib/app/AppShell.svelte): `src/lib/app/AppShell.svelte`

### Management features

- [Dashboard](https://github.com/leon4z/modus/blob/main/src/lib/features/dashboard/components/Dashboard.svelte): `src/lib/features/dashboard/components/Dashboard.svelte`
- [Rules workspace](https://github.com/leon4z/modus/blob/main/src/lib/features/rules/components/RulesModule.svelte): `src/lib/features/rules/components/RulesModule.svelte`
- [Skills workspace](https://github.com/leon4z/modus/blob/main/src/lib/features/skills/components/SkillsModule.svelte): `src/lib/features/skills/components/SkillsModule.svelte`
- [MCP workspace](https://github.com/leon4z/modus/blob/main/src/lib/features/mcp/components/McpPanel.svelte): `src/lib/features/mcp/components/McpPanel.svelte`
- [Config editor](https://github.com/leon4z/modus/blob/main/src/lib/features/config/components/ConfigPanel.svelte): `src/lib/features/config/components/ConfigPanel.svelte`
- [Settings](https://github.com/leon4z/modus/blob/main/src/lib/features/settings/components/SettingsModule.svelte): `src/lib/features/settings/components/SettingsModule.svelte`

### Local management backend

- [Dashboard queries](https://github.com/leon4z/modus/blob/main/src-tauri/src/domains/tools/dashboard.rs): `src-tauri/src/domains/tools/dashboard.rs`
- [Rule management](https://github.com/leon4z/modus/blob/main/src-tauri/src/domains/rules/management.rs): `src-tauri/src/domains/rules/management.rs`
- [Skill operations](https://github.com/leon4z/modus/blob/main/src-tauri/src/domains/skills/operations.rs): `src-tauri/src/domains/skills/operations.rs`
- [MCP listing](https://github.com/leon4z/modus/blob/main/src-tauri/src/domains/mcp/listing.rs): `src-tauri/src/domains/mcp/listing.rs`
- [Settings preferences](https://github.com/leon4z/modus/blob/main/src-tauri/src/domains/settings/preferences.rs): `src-tauri/src/domains/settings/preferences.rs`
- [App configuration](https://github.com/leon4z/modus/blob/main/src-tauri/src/platform/config.rs): `src-tauri/src/platform/config.rs`
- [Runtime paths](https://github.com/leon4z/modus/blob/main/src-tauri/src/platform/env.rs): `src-tauri/src/platform/env.rs`

### Tool capability model

- [Tool adapters](https://github.com/leon4z/modus/blob/main/src-tauri/src/adapters.rs): `src-tauri/src/adapters.rs`
- [Tool registry](https://github.com/leon4z/modus/blob/main/src-tauri/src/platform/tool_catalog/registry.rs): `src-tauri/src/platform/tool_catalog/registry.rs`
- [Capability projections](https://github.com/leon4z/modus/blob/main/src-tauri/src/platform/tool_capabilities/capability_projections.rs): `src-tauri/src/platform/tool_capabilities/capability_projections.rs`
- [Effective capabilities](https://github.com/leon4z/modus/blob/main/src-tauri/src/platform/tool_capabilities/effective_capabilities.rs): `src-tauri/src/platform/tool_capabilities/effective_capabilities.rs`
- [Skill discovery](https://github.com/leon4z/modus/blob/main/src-tauri/src/platform/tool_capabilities/skills.rs): `src-tauri/src/platform/tool_capabilities/skills.rs`

### Other components

- **User**

## Connections

- User → App shell: uses (evidence: `README.md`)
- App shell → Dashboard: offers
- App shell → Rules workspace: offers
- App shell → Skills workspace: offers
- App shell → MCP workspace: offers
- App shell → Config editor: offers
- App shell → Settings: offers
- Rules workspace → Rule management: manages rules
- Skills workspace → Skill operations: manages Skills
- MCP workspace → MCP listing: edits MCP
- Config editor → Tool adapters: reviews config
- Dashboard → Dashboard queries: summarizes tools
- Settings → Settings preferences: sets preferences
- Rule management → Tool adapters: uses tool adapters (evidence: `src-tauri/src/domains/rules/management.rs`)
- MCP listing → Tool adapters: lists tool sources (evidence: `src-tauri/src/domains/mcp/listing.rs`)
- Tool adapters → Tool registry: resolves tools (evidence: `src-tauri/src/adapters.rs`)
- Tool adapters → Capability projections: projects support (evidence: `src-tauri/src/adapters.rs`)
- MCP listing → Effective capabilities: resolves access (evidence: `src-tauri/src/domains/mcp/listing.rs`)
- Effective capabilities → App configuration: applies overrides (evidence: `src-tauri/src/platform/tool_capabilities/effective_capabilities.rs`)
- Tool adapters → Runtime paths: selects adapters (evidence: `src-tauri/src/adapters.rs`)
- Tool adapters → Skill discovery: reads Skills (evidence: `src-tauri/src/adapters.rs`)
- Skill operations → App configuration: uses persisted state
- Rule management → App configuration: uses persisted state
