# codeeditapp/codeedit architecture

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

- Interactive diagram: https://gitdiagram.com/codeeditapp/codeedit
- Repository: https://github.com/codeeditapp/codeedit

## Overview

CodeEdit is a native macOS code editor. The principal workflow is opening a project, navigating its files, and editing documents; the repository also has distinct search, language-server, source-control, task-running, and extension capabilities. Sampled source supports the workspace/file-document and Git-manager relationships, while README statements establish several capabilities without exposing their internal wiring. Dashed, uncited edges indicate workflow links that could not be verified from the excerpts.

Main entry points: [`CodeEdit/Features/CEWorkspace/Models/CEWorkspaceFileManager.swift`](https://github.com/codeeditapp/codeedit/blob/main/CodeEdit/Features/CEWorkspace/Models/CEWorkspaceFileManager.swift) (Workspace Files), [`CodeEdit/Features/Documents/WorkspaceDocument/WorkspaceDocument.swift`](https://github.com/codeeditapp/codeedit/blob/main/CodeEdit/Features/Documents/WorkspaceDocument/WorkspaceDocument.swift) (Workspace Document), [`CodeEdit/Features/SourceControl/SourceControlManager+GitClient.swift`](https://github.com/codeeditapp/codeedit/blob/main/CodeEdit/Features/SourceControl/SourceControlManager%2BGitClient.swift) (Source Control), [`CodeEdit/Features/Tasks/TaskManager.swift`](https://github.com/codeeditapp/codeedit/blob/main/CodeEdit/Features/Tasks/TaskManager.swift) (Task Runner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workspace["Workspace and Documents"]
  node_workspace_doc["Workspace Document"]
  node_file_manager["Workspace Files"]
  node_workspace_file["File Items"]
  node_file_document["Code Documents"]
end

subgraph group_editing["Editing and Language"]
  node_editor["Editor and Tabs<br/>[Editor.swift]"]
  node_search["Project Search"]
  node_lsp["Language Server"]
  node_semantic_tokens[("Semantic Tokens")]
end

subgraph group_project["Project Tools"]
  node_navigator["Project Navigator"]
  node_source_control["Source Control"]
  node_git_client["Git Client<br/>[GitClient.swift]"]
  node_tasks["Task Runner<br/>[TaskManager.swift]"]
  node_task_settings["Workspace Tasks<br/>[CETask.swift]"]
  node_extensions["Extensions"]
end

subgraph group_platform["App and Preferences"]
  node_app["CodeEdit App<br/>[CodeEditApp.swift]"]
  node_settings[("Preferences<br/>[Settings.swift]")]
  node_shell["Shell Client<br/>[ShellClient.swift]"]
  node_activity["Task Activity"]
  node_toolbar["Window Toolbar"]
end

node_developer(("Developer"))

node_developer -.->|"uses"| node_app
node_app -.->|"opens projects"| node_workspace_doc
node_workspace_doc -.->|"manages files"| node_file_manager
node_file_manager -->|"loads files"| node_workspace_file
node_workspace_file -->|"loads document"| node_file_document
node_file_document -.->|"shown in editor"| node_editor
node_workspace_doc -.->|"supports find"| node_search
node_editor -.->|"language features"| node_lsp
node_lsp -.->|"updates tokens"| node_semantic_tokens
node_file_manager -->|"refreshes status"| node_source_control
node_source_control -->|"calls Git"| node_git_client
node_task_settings -->|"configures tasks"| node_tasks
node_tasks -.->|"runs commands"| node_shell
node_toolbar -->|"hosts activity"| node_activity
node_developer -.->|"navigates files"| node_navigator
node_developer -.->|"finds and replaces"| node_search
node_developer -.->|"uses Git tools"| node_source_control
node_developer -.->|"runs tasks"| node_tasks
node_developer -.->|"uses extensions"| node_extensions
node_settings -.->|"configures ignores"| node_file_manager

click node_app "https://github.com/codeeditapp/codeedit/blob/main/CodeEdit/CodeEditApp.swift"
click node_workspace_doc "https://github.com/codeeditapp/codeedit/blob/main/CodeEdit/Features/Documents/WorkspaceDocument/WorkspaceDocument.swift"
click node_file_manager "https://github.com/codeeditapp/codeedit/blob/main/CodeEdit/Features/CEWorkspace/Models/CEWorkspaceFileManager.swift"
click node_workspace_file "https://github.com/codeeditapp/codeedit/blob/main/CodeEdit/Features/CEWorkspace/Models/CEWorkspaceFile.swift"
click node_file_document "https://github.com/codeeditapp/codeedit/blob/main/CodeEdit/Features/Documents/CodeFileDocument/CodeFileDocument.swift"
click node_editor "https://github.com/codeeditapp/codeedit/blob/main/CodeEdit/Features/Editor/Models/Editor/Editor.swift"
click node_search "https://github.com/codeeditapp/codeedit/blob/main/CodeEdit/Features/Documents/Indexer/SearchIndexer.swift"
click node_lsp "https://github.com/codeeditapp/codeedit/blob/main/CodeEdit/Features/LSP/LanguageServer/LanguageServer.swift"
click node_semantic_tokens "https://github.com/codeeditapp/codeedit/blob/main/CodeEdit/Features/LSP/Features/SemanticTokens/SemanticTokenStorage/SemanticTokenStorage.swift"
click node_navigator "https://github.com/codeeditapp/codeedit/blob/main/CodeEdit/Features/NavigatorArea/ProjectNavigator/ProjectNavigatorView.swift"
click node_source_control "https://github.com/codeeditapp/codeedit/blob/main/CodeEdit/Features/SourceControl/SourceControlManager%2BGitClient.swift"
click node_git_client "https://github.com/codeeditapp/codeedit/blob/main/CodeEdit/Features/SourceControl/Client/GitClient.swift"
click node_tasks "https://github.com/codeeditapp/codeedit/blob/main/CodeEdit/Features/Tasks/TaskManager.swift"
click node_task_settings "https://github.com/codeeditapp/codeedit/blob/main/CodeEdit/Features/CEWorkspaceSettings/Models/CETask.swift"
click node_extensions "https://github.com/codeeditapp/codeedit/blob/main/CodeEdit/Features/Extensions/ExtensionsManager.swift"
click node_settings "https://github.com/codeeditapp/codeedit/blob/main/CodeEdit/Features/Settings/Models/Settings.swift"
click node_shell "https://github.com/codeeditapp/codeedit/blob/main/CodeEdit/Utils/ShellClient/Models/ShellClient.swift"
click node_activity "https://github.com/codeeditapp/codeedit/blob/main/CodeEdit/Features/ActivityViewer/Notifications/TaskNotificationHandler.swift"
click node_toolbar "https://github.com/codeeditapp/codeedit/blob/main/CodeEdit/Features/Documents/Controllers/CodeEditWindowController%2BToolbar.swift"

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_workspace_doc,node_file_manager,node_workspace_file,node_file_document toneBlue
class node_editor,node_search,node_lsp,node_semantic_tokens toneAmber
class node_navigator,node_source_control,node_git_client,node_tasks,node_task_settings,node_extensions toneMint
class node_app,node_settings,node_shell,node_activity,node_toolbar toneRose
class node_developer toneIndigo
```

## Components

### Workspace and Documents

- [Workspace Document](https://github.com/codeeditapp/codeedit/blob/main/CodeEdit/Features/Documents/WorkspaceDocument/WorkspaceDocument.swift): `CodeEdit/Features/Documents/WorkspaceDocument/WorkspaceDocument.swift`
- [Workspace Files](https://github.com/codeeditapp/codeedit/blob/main/CodeEdit/Features/CEWorkspace/Models/CEWorkspaceFileManager.swift): `CodeEdit/Features/CEWorkspace/Models/CEWorkspaceFileManager.swift`
- [File Items](https://github.com/codeeditapp/codeedit/blob/main/CodeEdit/Features/CEWorkspace/Models/CEWorkspaceFile.swift): `CodeEdit/Features/CEWorkspace/Models/CEWorkspaceFile.swift`
- [Code Documents](https://github.com/codeeditapp/codeedit/blob/main/CodeEdit/Features/Documents/CodeFileDocument/CodeFileDocument.swift): `CodeEdit/Features/Documents/CodeFileDocument/CodeFileDocument.swift`

### Editing and Language

- [Editor and Tabs](https://github.com/codeeditapp/codeedit/blob/main/CodeEdit/Features/Editor/Models/Editor/Editor.swift): `CodeEdit/Features/Editor/Models/Editor/Editor.swift`
- [Project Search](https://github.com/codeeditapp/codeedit/blob/main/CodeEdit/Features/Documents/Indexer/SearchIndexer.swift): `CodeEdit/Features/Documents/Indexer/SearchIndexer.swift`
- [Language Server](https://github.com/codeeditapp/codeedit/blob/main/CodeEdit/Features/LSP/LanguageServer/LanguageServer.swift): `CodeEdit/Features/LSP/LanguageServer/LanguageServer.swift`
- [Semantic Tokens](https://github.com/codeeditapp/codeedit/blob/main/CodeEdit/Features/LSP/Features/SemanticTokens/SemanticTokenStorage/SemanticTokenStorage.swift): `CodeEdit/Features/LSP/Features/SemanticTokens/SemanticTokenStorage/SemanticTokenStorage.swift`

### Project Tools

- [Project Navigator](https://github.com/codeeditapp/codeedit/blob/main/CodeEdit/Features/NavigatorArea/ProjectNavigator/ProjectNavigatorView.swift): `CodeEdit/Features/NavigatorArea/ProjectNavigator/ProjectNavigatorView.swift`
- [Source Control](https://github.com/codeeditapp/codeedit/blob/main/CodeEdit/Features/SourceControl/SourceControlManager%2BGitClient.swift): `CodeEdit/Features/SourceControl/SourceControlManager+GitClient.swift`
- [Git Client](https://github.com/codeeditapp/codeedit/blob/main/CodeEdit/Features/SourceControl/Client/GitClient.swift): `CodeEdit/Features/SourceControl/Client/GitClient.swift`
- [Task Runner](https://github.com/codeeditapp/codeedit/blob/main/CodeEdit/Features/Tasks/TaskManager.swift): `CodeEdit/Features/Tasks/TaskManager.swift`
- [Workspace Tasks](https://github.com/codeeditapp/codeedit/blob/main/CodeEdit/Features/CEWorkspaceSettings/Models/CETask.swift): `CodeEdit/Features/CEWorkspaceSettings/Models/CETask.swift`
- [Extensions](https://github.com/codeeditapp/codeedit/blob/main/CodeEdit/Features/Extensions/ExtensionsManager.swift): `CodeEdit/Features/Extensions/ExtensionsManager.swift`

### App and Preferences

- [CodeEdit App](https://github.com/codeeditapp/codeedit/blob/main/CodeEdit/CodeEditApp.swift): `CodeEdit/CodeEditApp.swift`
- [Preferences](https://github.com/codeeditapp/codeedit/blob/main/CodeEdit/Features/Settings/Models/Settings.swift): `CodeEdit/Features/Settings/Models/Settings.swift`
- [Shell Client](https://github.com/codeeditapp/codeedit/blob/main/CodeEdit/Utils/ShellClient/Models/ShellClient.swift): `CodeEdit/Utils/ShellClient/Models/ShellClient.swift`
- [Task Activity](https://github.com/codeeditapp/codeedit/blob/main/CodeEdit/Features/ActivityViewer/Notifications/TaskNotificationHandler.swift): `CodeEdit/Features/ActivityViewer/Notifications/TaskNotificationHandler.swift`
- [Window Toolbar](https://github.com/codeeditapp/codeedit/blob/main/CodeEdit/Features/Documents/Controllers/CodeEditWindowController%2BToolbar.swift): `CodeEdit/Features/Documents/Controllers/CodeEditWindowController+Toolbar.swift`

### Other components

- **Developer**

## Connections

- Developer → CodeEdit App: uses (evidence: `README.md`)
- CodeEdit App → Workspace Document: opens projects
- Workspace Document → Workspace Files: manages files
- Workspace Files → File Items: loads files (evidence: `CodeEdit/Features/CEWorkspace/Models/CEWorkspaceFileManager.swift`)
- File Items → Code Documents: loads document (evidence: `CodeEdit/Features/CEWorkspace/Models/CEWorkspaceFile.swift`)
- Code Documents → Editor and Tabs: shown in editor
- Workspace Document → Project Search: supports find
- Editor and Tabs → Language Server: language features (evidence: `README.md`)
- Language Server → Semantic Tokens: updates tokens
- Workspace Files → Source Control: refreshes status (evidence: `CodeEdit/Features/CEWorkspace/Models/CEWorkspaceFileManager.swift`)
- Source Control → Git Client: calls Git (evidence: `CodeEdit/Features/SourceControl/SourceControlManager+GitClient.swift`)
- Workspace Tasks → Task Runner: configures tasks (evidence: `CodeEdit/Features/Tasks/TaskManager.swift`)
- Task Runner → Shell Client: runs commands
- Window Toolbar → Task Activity: hosts activity (evidence: `CodeEdit/Features/Documents/Controllers/CodeEditWindowController+Toolbar.swift`)
- Developer → Project Navigator: navigates files (evidence: `README.md`)
- Developer → Project Search: finds and replaces (evidence: `README.md`)
- Developer → Source Control: uses Git tools (evidence: `README.md`)
- Developer → Task Runner: runs tasks (evidence: `README.md`)
- Developer → Extensions: uses extensions (evidence: `README.md`)
- Preferences → Workspace Files: configures ignores
