CodeBox - Lokaler PySide6-Desktop-Codeeditor

English | Deutsch

CodeBox ist eine lokale Desktop-IDE für Windows-, Linux- und macOS-Entwickler, die einen leichtgewichtigen PySide6-Codeeditor mit Multi-Tab-Arbeitsbereich, Projektbaum, integriertem Terminal, Git-Porcelain-Statusanzeigen, Syntax-Highlighting, Language-Server-Protocol-Diagnosen (LSP) und einer erweiterbaren deklarativen JSON/Python-Plugin-Architektur suchen.

Note

Für KI-Agenten und die automatisierte Erfassung steht unter llms.txt eine maschinenlesbare Übersicht mit Systemkontext, Architektur-Shortcuts und Modulreferenzen bereit.

Schnellnavigation

Schnelleinstieg
Systemarchitektur
End-to-End Workflow-Lebenszyklus
Kernfähigkeiten & Laufzeitinvarianten
Visuelle Vorschau
Funktionen
Installation & Schnelleinstieg
Language-Server-Protocol (LSP) Einrichtung
Deklaratives Plugin-System
Lokaler Windows-Build
Projektstruktur
Geschwister-Ökosystem
Suche & Abgrenzung
Sicherheit & Datenschutz
Lizenz & Haftung

Schnelleinstieg

Bedarf	Einstieg
Editor aus dem Quellcode starten	`pip install -r requirements.txt` und `python main.py`
Bestimmte Datei direkt öffnen	`python main.py --open pfad/zur/datei.py`
Plugins & Sprachen verwalten	`Ctrl+Shift+P` oder Menü Bearbeiten -> Plugins & Sprachen...
Tastenkürzel-Übersicht aufrufen	`F1` oder Menü Hilfe -> Tastenkürzel-Übersicht
Standalone Windows-EXE bauen	`build_exe.bat`
Diagnostics oder Completion nutzen	Lokalen Language Server wie `python-lsp-server[all]` installieren
Entwicklungsplan einsehen	DEVELOPMENT_PLAN.md
Sicherheitsrichtlinie lesen	SECURITY.md

Systemarchitektur

flowchart TD
    subgraph UI ["Desktop UI-Schicht (PySide6)"]
        MW["Hauptfenster MainWindow (ui/main_window.py)"]
        TB["ToolBar & Aktions-Dispatcher"]
        ST["StatusBar & Position/Encoding/Sprache"]
        MW --> TB
        MW --> ST
    end

    subgraph Core ["Editor-Kern & Tab-Verwaltung"]
        Tabs["TabWidget (core/tabs.py)"]
        Ed["CodeEditor & UniversalHighlighter (core/highlighter.py)"]
        MM["Minimap-Widget (core/minimap.py)"]
        BM["BracketMatcher (core/bracket_matcher.py)"]
        Tabs --> Ed
        Ed --> MM
        Ed --> BM
    end

    subgraph Workspace ["Arbeitsbereich & Projektbaum"]
        PT["Projektbaum & FilterProxy (features/project_tree.py)"]
        Git["Git Porcelain Status-Resolver (features/git_status.py)"]
        PT --> Git
    end

    subgraph Diagnostics ["Language Server & Diagnose-Engine"]
        LSPMgr["LSPManager & Client-Thread (features/lsp_manager.py)"]
        Linter["Hintergrund-Linter (Ruff/flake8/ESLint) (features/linter.py)"]
        Prob["ProblemsPanel (ui/problems_panel.py)"]
        LSPMgr --> Prob
        Linter --> Prob
    end

    subgraph Runtime ["Ausführung & Erweiterbarkeit"]
        Term["Integriertes Terminal QProcess (features/terminal.py)"]
        Out["OutputPanel Prozess-Runner (core/output.py)"]
        PluginMgr["PluginManager (features/plugin_manager.py)"]
        Decl["Deklarative Provider (languages/declarative.py)"]
        Theme["ThemeManager (features/theme_manager.py)"]
        PluginMgr --> Decl
    end

    MW --> Tabs
    MW --> PT
    MW --> Diagnostics
    MW --> Term
    MW --> Out
    MW --> PluginMgr
    MW --> Theme

End-to-End Workflow-Lebenszyklus

sequenceDiagram
    autonumber
    actor Dev as Entwickler
    participant UI as Hauptfenster (MainWindow)
    participant Ed as CodeEditor (Tabs)
    participant Linter as Hintergrund-Linter
    participant LSP as LSP-Client-Thread
    participant Prob as ProblemsPanel
    participant Term as Terminal / Runner

    Dev->>UI: CodeBox starten & Datei öffnen
    UI->>Ed: Puffer laden & UniversalHighlighter anhängen
    Ed-->>Dev: Syntax-Highlighting & Zeilennummern anzeigen

    Dev->>Ed: Code bearbeiten & Speichern (Ctrl+S)
    Ed->>Linter: Asynchronen Linter-Trigger auslösen
    Ed->>LSP: textDocument/didSave signalisieren

    par Hintergrund-Diagnosen
        Linter->>Linter: Ruff / flake8 / ESLint im Subprozess ausführen
        Linter-->>Prob: Linter-Befunde übermitteln
    and Language-Server-Analyse
        LSP->>LSP: Language Server abfragen (pylsp / clangd / rust-analyzer)
        LSP-->>Prob: LSP-Diagnosemarker aktualisieren
    end

    Prob-->>UI: Befunde bündeln & Markierungen setzen
    UI-->>Dev: Darstellung im Problems-Panel & Statusleiste

    opt Code im Terminal / Runner ausführen
        Dev->>UI: Ausführen starten (F5)
        UI->>Term: QProcess instanziieren (cmd/powershell/bash)
        Term-->>Dev: Konsolenausgabe & Exit-Codes streamen
    end

Kernfähigkeiten & Laufzeitinvarianten

Fähigkeit / Prinzip	Technische Umsetzung	Garantie / Invariante
Local-First & Zero-Egress	Editor-Kern, Highlighting, Plugins und Terminal arbeiten 100% offline.	Null Telemetrie, keinerlei externe Netzwerkaufrufe während des regulären Betriebs.
Keine Admin-Rechte (User Mode)	Läuft vollständig im unprivilegierten Benutzerkontext.	Keine UAC- oder Root-/Sudo-Eskalation erforderlich.
Mehrsprachiges Highlighting	Universelle Regex-Engine (`UniversalHighlighter`) mit Wortgrenzen-Escaping.	Python, JavaScript, TypeScript, C++, Rust, Go, Java und eigene Plugins.
Erweiterbares Plugin-System	Deklaratives JSON-Format (`plugins/*.json`) und dynamische Python-Klassen.	Hot-Reloading und automatische Erkennung ohne Ändern des Kernquellcodes.
LSP-Diagnosen & Vervollständigung	Threadsicherer Qt-Client mit Standard-Language-Servern über stdin/stdout.	Blockierungsfreie GUI; unterstützt pylsp, typescript-language-server, rust-analyzer, clangd, gopls.
Hintergrund-Linting	Asynchrone Ausführung lokaler Linter (Ruff, flake8, ESLint) beim Speichern.	Dynamische Bündelung von Warnungen und Fehlern im Problems-Panel.
Schutz vor Speicherverlust	Abgesicherte Dateisystemoperationen mit Puffererhaltung.	Tabs bleiben geöffnet und Daten geschützt, falls ein Schreibfehler auftritt.
Integriertes Terminal	Eingebetteter `QProcess`-Terminalbereich für `cmd`, `PowerShell` und `bash`.	Dynamische Kodierungsanpassung (cp1252 / utf-8) und Verzeichnissynchronisation.

Visuelle Vorschau

Abbildung 1: CodeBox-Arbeitsbereich mit Projektbaum, Multi-Tab-Editor, Syntax-Highlighting, integriertem Terminal und Diagnose-Panel.

Funktionen

Präzises Syntax-Highlighting: Vorkonfigurierte Highlightings für Python, JavaScript, TypeScript, C++, Rust, Go und Java mit satzzeichensicherem Wortgrenzen-Matching.
Deklarative Plugin-Architektur: Neue Sprachen in wenigen Minuten per JSON-Schema definieren (plugins/, ~/.codebox/plugins/).
Interaktive Verwaltungsdialoge: Vollständige GUI-Dialoge zur Verwaltung von Sprach-Plugins (Ctrl+Shift+P) und Tastaturkürzeln (F1).
Integriertes Terminal: Native Terminalemulation mit Befehlshistorie, Streaming und automatischer Pfadsynchronisation.
Projekt-Dateibaum: Baumansicht mit Proxy-Suchfilter, Kontextaktionen und Git-Porcelain-Statusmarkern.
Multi-Tab-Arbeitsbereich: Drag-and-Drop-Reiter, Schutz vor Speicherverlust und absolute Pfad-Tooltips.
Minimap-Vorschau & Navigation: Synchronisierte Code-Minimap, Klammer-Autovervollständigung und Gehe-zu-Zeile (Ctrl+G).
Duales Designsystem: Nahtloser Wechsel zwischen Dark- und Light-Theme über features/theme_manager.py.
LSP-Diagnosen & Code-Completion: Asynchrone Hintergrundabfragen für Echtzeitdiagnosen und Vervollständigungen.
Automatisierte Linter: Ruff-, flake8- und ESLint-Integration direkt beim Speichern mit Übernahme ins Problems-Panel.

Installation & Schnelleinstieg

# Repository klonen
git clone https://github.com/dev-bricks/CodeBox.git
cd CodeBox

# Abhängigkeiten installieren
pip install -r requirements.txt

# CodeBox starten
python main.py

Unter Windows kann CodeBox auch einfach per Doppelklick auf start.bat gestartet werden.

Systemvoraussetzungen

Python: 3.10, 3.11, 3.12 oder 3.13
GUI-Framework: PySide6 >= 6.5.0
Betriebssysteme: Windows 10/11, POSIX Linux (Ubuntu, Debian, Fedora), macOS

Language-Server-Protocol (LSP) Einrichtung

CodeBox bindet direkt an installierte System-Language-Server an:

Sprache	Empfohlener Language Server	Installationsbefehl
Python	`python-lsp-server` (pylsp)	`pip install "python-lsp-server[all]"`
TypeScript / JS	`typescript-language-server`	`npm install -g typescript-language-server typescript`
Rust	`rust-analyzer`	`rustup component add rust-analyzer`
Go	`gopls`	`go install golang.org/x/tools/gopls@latest`
C / C++	`clangd`	LLVM / Clang Paket installieren

CodeBox bevorzugt Server auf dem System-PATH und nutzt in virtuellen Umgebungen automatisch python -m pylsp als Fallback.

Deklaratives Plugin-System

Eigene Sprachdefinitionen werden durch Ablegen einer JSON-Datei in plugins/ oder ~/.codebox/plugins/ registriert:

{
  "name": "CustomLang",
  "version": "1.0.0",
  "extensions": [".custom", ".cst"],
  "keywords": ["function", "end", "if", "then", "else", "return"],
  "comment_style": ["#"],
  "auto_close_pairs": {
    "(": ")",
    "[": "]",
    "{": "}"
  }
}

Die Plugins können zur Laufzeit im Plugin-Manager (Ctrl+Shift+P) neu geladen werden.

Lokaler Windows-Build

Eigenständige, installationsfreie Windows-Executable kompilieren:

build_exe.bat

Das Script nutzt PyInstaller mit CodeBox.spec, um Icons, Themes und deklarative Plugins in dist\CodeBox.exe zu bündeln.

Projektstruktur

CodeBox/
├── main.py                  # Anwendungseinstiegspunkt & CLI-Parameter
├── version.py               # Zentrale Versionskonstanten & Fenstertitel-Formatierung
├── pyproject.toml           # PEP 621 Metadaten & Pytest-Konfiguration
├── requirements.txt         # Laufzeitabhängigkeiten (PySide6)
├── core/                    # Editor-Tabs, Highlighter, Minimap, Output-Panel
├── features/                # Terminal, Projektbaum, LSP-Manager, Linter, Themes, Plugins
├── languages/               # Sprachdefinitionen, Provider und deklarativer Parser
├── ui/                      # MainWindow-Layout, Einstellungs-, Shortcuts- und Plugin-Dialoge
├── plugins/                 # Gebündelte deklarative Sprach-Plugins (JSON)
├── themes/                  # QSS-Stylesheets (dark.qss, light.qss)
├── assets/                  # Hochauflösende Vektorbanner und Icons
├── tests/                   # Automatisierte Testsuite (115+ Tests)
└── README/screenshots/      # Grafiken für den Projektauftritt

Geschwister-Ökosystem

CodeBox ist Teil des Entwickler-Ökosystems von dev-bricks und ellmos-ai unter dem Dach von open-bricks:

Repository	Schwerpunkt	Ökosystem
dev-bricks/safe-start-for-codex	Startup-Gating für lokale Codex-Automationen	`dev-bricks`
dev-bricks/companion-for-agy	Node.js Orchestrierungs-Wrapper für Antigravity	`dev-bricks`
dev-bricks/automation-master	Task-Orchestrierung und Automations-Supervisor	`dev-bricks`
dev-bricks/automizer-for-claude-desktop	Automationsbrücke für Claude Desktop	`dev-bricks`
ellmos-ai/ellmos-codecommander-mcp	AST-Analyse, Refactoring und Code-Diagnose MCP-Server	`ellmos-ai`
ellmos-ai/ellmos-filecommander-mcp	Dateisystem-Manipulation & Prozess-Supervisor MCP	`ellmos-ai`
doc-bricks/CleanMarkdown	Moderner ablenkungsfreier Markdown-Desktop-Editor	`doc-bricks`
file-bricks/ExplorerPro	Lokaler Multi-Tab Desktop-Dateimanager	`file-bricks`
open-bricks/.github	Dachorganisation und Open-Source-Standards	`open-bricks`

Suche & Abgrenzung

Präzise Suchbegriffe zur eindeutigen Auffindbarkeit:

dev-bricks CodeBox
CodeBox PySide6 Desktop IDE
Lokaler Codeeditor Python Windows
PySide6 Codeeditor mit LSP Diagnosen
Offline Python IDE Language Server Protocol
CodeBox deklaratives Sprach-Plugin-System

Sicherheit & Datenschutz

CodeBox unterliegt verbindlichen Sicherheits- und Datenschutzvorgaben. Vollständige Richtlinie in SECURITY.md:

100% Offline-Betrieb: Kein Tracking, keine Telemetrie oder ungefragte Datenübertragung.
Unprivilegierter Modus: Läuft vollständig mit normalen Benutzerrechten.
Vertrauliche Meldungen: Schwachstellen bitte vertraulich über GitHub Security Advisories oder per E-Mail an security@ellmos.ai und lukas@open-bricks.org melden.

Lizenz & Haftung

Dieses Projekt ist unter der MIT-Lizenz lizenziert.

Haftungsausschluss

Dieses Projekt ist eine unentgeltliche Open-Source-Schenkung im Sinne der §§ 516 ff. BGB. Die Haftung des Urhebers ist gemäß § 521 BGB auf Vorsatz und grobe Fahrlässigkeit beschränkt. Ergänzend gilt der Haftungsausschluss der MIT-Lizenz. Nutzung auf eigenes Risiko. Keine Wartungszusage oder Gewährleistung für einen bestimmten Einsatzzweck.

Navigation Menu

Uh oh!

CodeBox - Lokaler PySide6-Desktop-Codeeditor

Schnellnavigation

Schnelleinstieg

Systemarchitektur

End-to-End Workflow-Lebenszyklus

Kernfähigkeiten & Laufzeitinvarianten

Visuelle Vorschau

Funktionen

Installation & Schnelleinstieg

Systemvoraussetzungen

Language-Server-Protocol (LSP) Einrichtung

Deklaratives Plugin-System

Lokaler Windows-Build

Projektstruktur

Geschwister-Ökosystem

Suche & Abgrenzung

Sicherheit & Datenschutz

Lizenz & Haftung

Haftungsausschluss

Uh oh!

FilesExpand file tree

README_de.md

Latest commit

History

README_de.md

File metadata and controls

CodeBox - Lokaler PySide6-Desktop-Codeeditor

Schnellnavigation

Schnelleinstieg

Systemarchitektur

End-to-End Workflow-Lebenszyklus

Kernfähigkeiten & Laufzeitinvarianten

Visuelle Vorschau

Funktionen

Installation & Schnelleinstieg

Systemvoraussetzungen

Language-Server-Protocol (LSP) Einrichtung

Deklaratives Plugin-System

Lokaler Windows-Build

Projektstruktur

Geschwister-Ökosystem

Suche & Abgrenzung

Sicherheit & Datenschutz

Lizenz & Haftung

Haftungsausschluss