orbit

[!IMPORTANT] Orbit befindet sich noch in einem frühen Entwicklungsstadium. Die aktuelle Version verfügt über keine eigene Authentifizierung. Setze sie daher nicht direkt im öffentlichen Internet ein, sondern nur hinter einem Authentifizierungsproxy wie Cloudflare Access oder in einem lokalen Netzwerk.

Das Problem, das Orbit lösen will

Bestehende Wissensmanagement-Tools verlangen oft, dass Nutzer zuerst Ordner, Datenbanken, Eigenschaften und Automatisierungsregeln entwerfen. Orbit funktioniert genau umgekehrt.

1. Notizen, Links, Aufgaben und Termine werden ohne Format in die Inbox aufgenommen.

2. Die Originale bleiben als menschenlesbare Markdown- und YAML-Dateien erhalten.

3. In Today siehst du die heutigen Aufgaben und Termine zusammen.

4. Externe Agenten greifen über MCP auf dieselben Dateien zu.

5. Die KI-Organisation ist eine optionale Funktion; vorgeschlagene Änderungen werden erst nach Genehmigung durch den Nutzer angewendet.

Related MCP server: Knowledge Base MCP Server

Was bereits funktioniert

• Markdown-/YAML-Vault lesen

• Notizen, Aufgaben, Termine und Links als Inbox-Dateien erfassen

• Heutige Aufgaben berechnen und als erledigt markieren

• Markdown-Notizen auflisten, durchsuchen, bearbeiten, GFM-Vorschau, Tags, Archivierung

• Letzte Inbox-Einträge und anstehende Termine anzeigen

• shadcn/ui auf Neutral-Basis und dunkelgrauer Dark Mode

• MCP orbit_capture, orbit_today, orbit_search

• Datenort über ORBIT_DATA_DIR trennen

• Mobiler Today-Bildschirm

Noch nicht vorhanden: Login, automatische KI-Klassifizierung, Änderungsgenehmigungsbildschirm, Vault-weite Suche, CalDAV-Synchronisierung, automatische Git-Backups, SSE-Dateiüberwachung. Umfang und Reihenfolge sind in der Roadmap festgehalten.

Schnellstart

Voraussetzungen: Node.js 22 oder höher, pnpm 10 oder höher

git clone https://github.com/kmelon55/orbit.git
cd orbit
pnpm install
cp .env.example .env
pnpm dev

Der Standard-Vault ist ./data im Projekt. Um persönliche Daten vom App-Code zu trennen, gib in .env einen absoluten Pfad an.

ORBIT_DATA_DIR=/data/orbit

Dateistruktur

/data/orbit/
├── inbox/
├── projects/
├── areas/
├── resources/
├── events/
└── archive/

Aufgaben sind nicht in einer separaten Datenbank oder einem tasks/-Ordner eingesperrt. Markdown-Dateien in Inbox, Project und Area haben type: task, und Orbit sammelt sie in Today.

---
id: 6c654756-053f-459a-9d73-c8a7c1ff020d
title: 첫 공개 릴리스 준비
type: task
space: project
project: Orbit
status: open
tags:
  - launch
created: 2026-08-23T09:00:00+09:00
updated: 2026-08-23T09:00:00+09:00
---

README와 기본 파일 계약을 검토한다.

Den vollständigen Dateivertrag findest du im Architekturdokument.

MCP-Verbindung

Der Orbit-MCP-Server läuft über stdio.

ORBIT_DATA_DIR=/absolute/path/to/orbit-data pnpm mcp

Beispiel für die MCP-Client-Konfiguration:

{
  "mcpServers": {
    "orbit": {
      "command": "pnpm",
      "args": ["--dir", "/absolute/path/to/orbit", "mcp"],
      "env": {
        "ORBIT_DATA_DIR": "/absolute/path/to/orbit-data"
      }
    }
  }
}

Agenten, die stdio-MCP-Server unterstützen – einschließlich Hermes – können auf dieselbe Weise verbunden werden. Die konkreten Konfigurationsschlüssel findest du in der Dokumentation deines Clients.

Docker / Dokploy

docker build -t orbit .
docker run --rm -p 3000:3000 \
  -e ORBIT_DATA_DIR=/data/orbit \
  -v orbit-data:/data/orbit \
  orbit

Verwende in Dokploy das Dockerfile dieses Repositories und binde /data/orbit als persistentes Volume ein. Konfiguriere vor der öffentlichen Freigabe unbedingt einen Authentifizierungsproxy.

Entwicklung

pnpm test       # Biome + TypeScript
pnpm build      # production build
pnpm mcp        # stdio MCP server

Wie du beitragen kannst, erfährst du in CONTRIBUTING.md.

Prinzipien

• Dateien sind die Source of Truth, nicht das Exportformat des Produkts.

• SQLite wird nur für regenerierbare Daten wie Suchindex, Synchronisierungsstatus und Cache verwendet.

• KI-Anbieter sind BYOK, und der grundlegende Erfassungs- und Ausführungsfluss muss auch ohne KI funktionieren.

• Destruktive Änderungen durch Agenten durchlaufen standardmäßig die Schritte Vorschlag → Prüfung → Anwendung.

Lizenz

MIT