Skip to content

README.de.md

Latest commit

 

History

History
169 lines (123 loc) · 6.41 KB

README.de.md

File metadata and controls

169 lines (123 loc) · 6.41 KB
Raw
Pixcode logo

Pixcode

Self-hosted Kontrollraum für AI-Coding-Agents.

Claude Code, Cursor CLI, Codex, Gemini CLI, Qwen Code und OpenCode in einer Weboberfläche: Chat, Shell, Dateien, Git, Orchestrierung, API-Keys, Plugins, Benachrichtigungen, Telegram und Desktop-/Server-Betrieb.

Buy me a coffee

English · Türkçe · Русский · 日本語 · 한국어 · 简体中文

Was ist Pixcode?

Pixcode macht deinen Laptop, Desktop-Rechner oder Linux-Server zu einem browserbasierten Arbeitsbereich für Coding-Agents. Statt Terminalfenster, CLI-Ausgaben, Dateimanager, Git-Ansicht und Provider-Einstellungen getrennt zu öffnen, bündelt Pixcode alles in einer lokalen Web-App.

Typische Setups:

  • Lokal: Pixcode auf dem eigenen Rechner starten und die bekannten CLIs mit einer komfortableren UI nutzen.
  • Server/VDS: Pixcode als Linux-Daemon betreiben und von Browser, Tablet oder Smartphone zugreifen.
  • Desktop: Windows-, macOS- und Linux-Installer aus den GitHub-Releases verwenden.

Pixcode ist keine gehostete Cloud-IDE. Projekte, Credentials, Sessions, lokale Dateien, Git-Status und MCP-Konfiguration bleiben auf deiner eigenen Maschine, solange du sie nicht bewusst mit externen Diensten verbindest.

Screenshots

Workspace Mobile Chat
Pixcode desktop workspace Pixcode mobile chat
CLI-Auswahl Tools und MCP
Pixcode CLI selection Pixcode tools modal

Funktionen

Ein UI für mehrere CLIs

  • Claude Code, Cursor CLI, Codex, Gemini CLI, Qwen Code und OpenCode.
  • Provider-Auth, API-Key-Credentials, OAuth-Paste, Install-Status, Modelllisten und CLI-Versionen unter Settings.
  • Provider-native CLIs bleiben erhalten; Pixcode ergänzt Session-Management, WebSocket-Streaming, Benachrichtigungen, Dateikontext und Projektsteuerung.
  • Der UI-Zustand zeigt, ob ein CLI denkt, Tools ausführt, auf Freigabe wartet oder Ausgabe streamt.

Chat, Dateien, Shell und Git

  • Projektbezogene Sessions mit Verlauf.
  • Prompt-Eingabe fest am unteren Rand des Chat-/Projektbereichs.
  • Eingebaute Shell, die auf Desktop als halbes Panel oder Vollpanel geöffnet werden kann.
  • Datei-Browser mit Bearbeiten, Upload, Umbenennen, Löschen und Detailansicht.
  • Source-Control-Ansicht für Status, Diffs, Branches, Commits und geänderte Dateien.
  • Split-Panels mit Icon-Controls, Schließen-Button und responsive Layout für Mobile.

Command Center für Änderungen

Pixcode beobachtet lokale Working-Tree-Änderungen. Der Command-Center-Modus in Quick Settings listet geänderte Dateien sofort auf, markiert neue Änderungen sichtbar und kann direkt zur betroffenen Datei springen. So bleibt nachvollziehbar, was ein Agent im Projekt geändert hat.

Multi-Agent-Orchestrierung

Die Orchestrierung koordiniert mehrere CLI-Agents für ein gemeinsames Ziel.

  • Agent Team: Aufgaben nach Rollen wie Frontend, Backend, Review oder Docs aufteilen.
  • Multi-model Review: dieselbe Änderung mit mehreren Providern oder Modellen prüfen.
  • Sequential Handoff: Arbeitsschritte nacheinander übergeben.
  • Decision Debate: Lösungswege vergleichen, bevor implementiert wird.

Kontrollen:

  • Agents pro Lauf aktivieren oder deaktivieren,
  • Provider mehrfach verwenden,
  • Rolle, Stage, Label und Instruktion pro Agent setzen,
  • Modell pro Agent auswählen, auch für OpenCode,
  • Fallback-CLI für fehlerhafte Schritte definieren,
  • Workflow-DAG vorab anzeigen,
  • Run-Events streamen und aktive Runs abbrechen,
  • Orchestrierungsbereiche per Drag ändern.

API, Telegram und Benachrichtigungen

Pixcode nutzt REST und WebSocket auch intern. Externe Automatisierung kann Pixcode über API-Keys steuern. Neue Keys beginnen mit px_; alte ck_ Keys bleiben kompatibel.

curl http://localhost:3001/api/projects \
  -H "Authorization: Bearer px_your_key_here"

Weitere Möglichkeiten:

  • POST /api/agent für nicht-interaktive Agent-Läufe.
  • /api/orchestration/workflows/* für Preview, Start, Streaming und Cancel von Workflows.
  • Browser-Push und Telegram-Benachrichtigungen für abgeschlossene, fehlgeschlagene oder wartende Tasks.
  • Telegram-Pairing über kurzlebige Codes und optionaler Prompt-Bridge.

OpenAPI: public/openapi.yaml

Themes, Plugins und MCP

  • Dark/Light Mode.
  • Accent-Paletten wie Emerald und VS-Code-ähnliche Farben.
  • Eigene Accent-Farben getrennt für Dark und Light.
  • Tokenbasiertes Styling für Buttons, Fokus, Navigation und aktive Zustände.
  • MCP-Serververwaltung für unterstützte Provider.
  • Plugin-System mit Frontend-Tabs und optionalen Backend-Services.

Installation

Node.js 22 oder neuer wird benötigt.

npx @pixelbyte-software/pixcode

Oder global:

npm install -g @pixelbyte-software/pixcode
pixcode

Öffnen:

http://localhost:3001

Desktop-Builds gibt es in den GitHub-Releases: Windows .exe, macOS .dmg, Linux AppImage/Pakete.

Linux-Daemon

pixcode daemon install --mode auto --port 3001
pixcode daemon status --mode auto
pixcode daemon logs --mode auto
pixcode daemon restart --mode auto

Foreground:

pixcode --no-daemon

Entwicklung

npm install
npm run typecheck
npm run lint
npm run build

Hinweise:

  • npm run dev verwendet unter Linux den Daemon-Manager.
  • Für Frontend-Entwicklung separat npm run client verwenden; normaler Betrieb läuft über Port 3001.
  • npm run server startet gebaute Dateien aus dist-server/.

Links