How leon4z/modus works
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: AppShell.svelte App shell · adapters.rs Tool adapters · management.rs Rule management · listing.rs MCP listing
Components 20
Desktop interface
- App shell
src/lib/app/AppShell.svelte
Management features
- Dashboard
src/lib/features/dashboard/components/Dashboard.svelte - Rules workspace
src/lib/features/rules/components/RulesModule.svelte - Skills workspace
src/lib/features/skills/components/SkillsModule.svelte - MCP workspace
src/lib/features/mcp/components/McpPanel.svelte - Config editor
src/lib/features/config/components/ConfigPanel.svelte - Settings
src/lib/features/settings/components/SettingsModule.svelte
Local management backend
- Dashboard queries
src-tauri/src/domains/tools/dashboard.rs - Rule management
src-tauri/src/domains/rules/management.rs - Skill operations
src-tauri/src/domains/skills/operations.rs - MCP listing
src-tauri/src/domains/mcp/listing.rs - Settings preferences
src-tauri/src/domains/settings/preferences.rs - App configuration
src-tauri/src/platform/config.rs - Runtime paths
src-tauri/src/platform/env.rs
Tool capability model
- Tool adapters
src-tauri/src/adapters.rs - Tool registry
src-tauri/src/platform/tool_catalog/registry.rs - Capability projections
src-tauri/src/platform/tool_capabilities/capability_projections.rs - Effective capabilities
src-tauri/src/platform/tool_capabilities/effective_capabilities.rs - Skill discovery
src-tauri/src/platform/tool_capabilities/skills.rs
Other components
- User
Connections 23
- User → App shell: uses
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
src-tauri/src/domains/rules/management.rs - MCP listing → Tool adapters: lists tool sources
src-tauri/src/domains/mcp/listing.rs - Tool adapters → Tool registry: resolves tools
src-tauri/src/adapters.rs - Tool adapters → Capability projections: projects support
src-tauri/src/adapters.rs - MCP listing → Effective capabilities: resolves access
src-tauri/src/domains/mcp/listing.rs - Effective capabilities → App configuration: applies overrides
src-tauri/src/platform/tool_capabilities/effective_capabilities.rs - Tool adapters → Runtime paths: selects adapters
src-tauri/src/adapters.rs - Tool adapters → Skill discovery: reads Skills
src-tauri/src/adapters.rs - Skill operations → App configuration: uses persisted state
- Rule management → App configuration: uses persisted state