Persona

Notizen, Aufgaben und ein KI-Chat, der deine Dateien kennt. Alles befindet sich in einem Ordner mit schlichtem Markdown auf deinem Rechner.

$ persona

Das startet einen lokalen Server und öffnet deinen Arbeitsbereich im Browser. Keine Konten, keine Cloud, keine Datenbank. Wenn dieses Projekt morgen verschwände, hättest du weiterhin jede Notiz und jede Aufgabe als .md-Dateien, die du mit jedem Programm öffnen kannst.

Warum noch eine Notizen-App?

Weil ich ständig zwischen schöner Software und dem Besitz meiner Daten wählen musste:

Ich habe Obsidian zwei Jahre lang täglich genutzt. Irgendwo bei Plugin Nummer dreißig wurde mir klar, dass ich mein Notiz-Setup mehr pflegte, als dass ich darin schrieb. Persona ist mein Versuch der Version, in der alles Wichtige einfach von Haus aus funktioniert und dich das Datenformat nie als Geisel hält.

Related MCP server: MindOS

Was du bekommst

• Markdown-Notizen — Dateien auf der Festplatte in einer Ordnerstruktur, die du selbst bestimmst. Bearbeite sie in jeder App; Persona beobachtet das Dateisystem und bleibt auf dem Laufenden

• Aufgaben — schreibe fix login bug #backend !! friday und Persona sortiert Priorität, Projekt-Tag und Fälligkeitsdatum in die Frontmatter ein. Kanban-Ansicht inklusive

• KI-Chat — verbindet sich automatisch mit Ollama, wenn es läuft (kostenlos und privat), oder nutzt jede OpenAI-kompatible API. Er kann Notizen erstellen und Aufgaben verwalten, nicht nur Fragen beantworten

• Semantische Suche — Embeddings werden lokal berechnet und innerhalb des Arbeitsbereichs gespeichert

• Spracheingabe — lokale Spracherkennung (Speech-to-Text) über parakeet.cpp auf Apple Silicon

• MCP-Server — Claude Code, Cursor und andere Agenten können direkt auf deinen Arbeitsbereich lesend und schreibend zugreifen

Screenshots

Schnellstart (macOS)

Du brauchst Node.js 20+ (brew install node) und git.

git clone https://github.com/jayamitkatariya/personacli.git
cd personacli
npm install --allow-scripts=persona
npm install -g . --allow-scripts=persona
persona

Beim ersten Start wirst du durch die Auswahl eines Arbeitsbereich-Ordners geführt und kannst optional ein KI-Modell verbinden. Danach reicht einfach persona.

Soll die KI kostenlos und privat laufen?

brew install ollama && ollama pull llama3.2
persona   # detects ollama automatically, no config

persona doctor   # health check: node, workspace, server, AI config
persona path     # print workspace path

Aktualisierung:

cd personacli && git pull
npm install --allow-scripts=persona
npm install -g . --allow-scripts=persona

Deinstallation:

npm uninstall -g persona
pkill -f "dist/server/index"
rm -rf ~/.persona

Die Fehlerbehebung findest du weiter unten in dieser README ausführlich.

Der Stack

Durchgängig TypeScript. React-UI, serviert von einem Hono-Server, Vite für Builds. Lokale Embeddings für die Suche, parakeet.cpp für Sprache, Ollama oder ein beliebiger OpenAI-kompatibler Endpunkt für den Chat. Absichtlich langweilige Technik.

Mitwirken

Issues und PRs sind willkommen, besonders Fehlerberichte aus realer Nutzung. Wenn sich etwas falsch anfühlt, ist es das wahrscheinlich auch; sag Bescheid.

Lizenz

MIT

Wenn dir Persona etwas Nerven spart, hilft ein Stern anderen Leuten, es zu finden.

Optionale Extras

Für die Spracheingabe weise Persona auf dein parakeet-Binary und dein Modell hin:

export PERSONA_STT_BIN=/path/to/parakeet-cli
export PERSONA_STT_MODEL=/path/to/model.gguf
persona

Fehlerbehebung

Erster Start

Wenn du persona zum ersten Mal ausführst, führt dich ein kurzer Einrichtungsassistent durch drei Schritte im Browser:

1. Arbeitsbereich — hier speichert Persona deine Notizen (standardmäßig ~/Persona). Notes/, Projects/ und .persona/tasks/ werden für dich angelegt.

2. KI — optional. Eine laufende Ollama-Instanz wird erkannt und ohne Konfiguration verbunden; andernfalls füge einen beliebigen OpenAI-kompatiblen API-Schlüssel hinzu. Du kannst diesen Schritt jederzeit überspringen und später unter Einstellungen → KI (⌘,) einrichten.

3. Fertig — eine Notiz Notes/Welcome.md wird als geführter Rundgang durch den Arbeitsbereich erstellt: die drei Ansichten, Tastenkombinationen und Terminal-Befehle. Du kannst sie jederzeit über die Befehlspalette (⌘K → "Welcome-Notiz öffnen") wieder öffnen.

Es wird nie etwas überschrieben: Wenn der Arbeitsbereich-Ordner bereits Dateien enthält, erscheinen sie unverändert in der Seitenleiste, und die Welcome-Notiz wird nur einmal erstellt.

Befehle

Was wo liegt

~/Persona/                  ← your workspace (choose it on first run)
├── Notes/                  ← plain Markdown, organised however you like
├── Projects/
│   └── my-project/
│       └── PRD.md
├── Imported/               ← notes brought in from other apps
│   ├── obsidian/
│   ├── bear/
│   ├── roam/
│   ├── notion/
│   └── plain/
└── .persona/
    ├── tasks/              ← tasks are Markdown files with frontmatter
    ├── agents/             ← background agent runs (JSON)
    ├── pins.json           ← your pinboard (pinned notes & tasks)
    └── embeddings/         ← local semantic-search index (notes, not secrets)

Aufgaben sind nur Dateien:

---
type: task
status: todo
priority: high
due: 2026-08-12
project: Personal
---
Finish Persona PRD

Bearbeite sie in einem beliebigen Editor oder im Finder — Persona beobachtet das Dateisystem und synchronisiert automatisch.

Arbeitsbereiche

• Schreiben — Dateibaum + Markdown-Editor (CodeMirror). Autosave, Speicherstatus, Live-Vorschau (Bearbeiten / Split / Vorschau), Umbenennen, Verschieben, Duplizieren, Löschen, Drag & Drop. Öffne mehrere Notizen gleichzeitig in Tabs (⌘W zum Schließen, ⌘⇧[ / ⌘⇧] zum Wechseln); jeder Tab behält seine eigene Scrollposition und seinen Undo-Verlauf. KI-generierte Tags: Drücke ⌘S (oder den ✨-Button), und Persona schlägt Tags für deine Notiz vor, die automatisch als YAML-Frontmatter hinzugefügt werden.

• Aufgaben — schnelle persönliche Aufgabenliste. Gib Buy domain tomorrow #personal ! in das Schnell-Eingabefeld ein; Datumsangaben, Projekte und Priorität werden für dich geparst. Wiederkehrende Aufgaben funktionieren ebenfalls: Water plants every week erstellt sich selbst mit dem nächsten Fälligkeitsdatum neu, wenn du es abschließt. Klicke auf Triage (oder führe persona triage aus), und die KI überprüft deine offenen Aufgaben — markiert falsche Prioritäten, fehlende Fälligkeitsdaten, nicht getaggte Projekte, veraltete Aufgaben und Duplikate — und wendet jeden Vorschlag mit einem Klick an. Sie ändert keine Aufgabe, ohne dass du zustimmst.

• Pinnwand — Pinn wichtige Notizen oder Aufgaben an (⋯-Menü im Dateibaum oder in der Aufgabenzeile), und sie bleiben in jedem Tab oben in der Seitenleiste angeheftet. Klicke auf einen Pin, um direkt dorthin zu springen; fahre mit der Maus darüber, um die Anheftung aufzuheben. Pins liegen in .persona/pins.json und überstehen Neustarts.

• Chat — eine KI, die deinen Arbeitsbereich sehen und darin handeln kann. Hänge Kontext mit @file.md, @folder oder @tasks an und stelle Fragen zu deiner tatsächlichen Arbeit. Die KI kann außerdem Notizen und Ordner erstellen, bearbeiten, verschieben und löschen sowie Aufgaben in deinem Namen erstellen, abschließen, aktualisieren und löschen — du siehst für jede Aktion, die sie ausführt, einen kleinen Status-Chip.

• Agents — KI-Läufe im Hintergrund für mehrstufige Arbeiten. Gib Persona eine Aufgabe wie „organisiere meine Inbox-Notizen“, und es arbeitet sie live mit Werkzeugen ab, ohne einen Chat offen zu halten. Läufe werden unter .persona/agents/ gespeichert und können abgebrochen, wiederholt oder gelöscht werden.

• Semantische Suche — deine Notizen werden lokal eingebettet und nach Bedeutung durchsucht, sodass „das, was ich über Camping geschrieben habe“ die Notiz findet, die den Wald, das Zelt und den Regen erwähnt — selbst wenn das Wort „Camping“ nie vorkommt. Sie treibt die Befehlspalette (⌘P), persona search und den Chat an: Wenn du keinen Kontext anhängst, zieht der Assistent automatisch die für deine Frage relevantesten Notizen heran und zitiert sie.

• Module — Fokus, Journal, Heutiges und Agents können unter Einstellungen → Module ein-/ausgeschaltet werden; aktivierte Module erscheinen in der Seitenleiste, deaktivierte bleiben über ⌘K erreichbar.

• Import — Importiere Exporte aus Obsidian, Bear, Roam, Notion oder einfachen Ordnern unter Einstellungen → Import. Alles landet unter Imported/<source>/ und überschreibt nie vorhandene Notizen.

Tastatur

KI

Jeder OpenAI-kompatible Anbieter funktioniert — OpenAI, OpenRouter, Ollama, lokale Modelle, benutzerdefinierte Endpunkte. Konfiguriere Anbieter, Basis-URL, Modell und API-Schlüssel unter Einstellungen → KI. Der Schlüssel wird im macOS-Schlüsselbund gespeichert (fällt auf eine Konfigurationsdatei mit 0600-Berechtigungen zurück) und wird nur an den von dir gewählten Anbieter gesendet.

Kein Setup mit Ollama. Wenn eine lokale Ollama-Instanz läuft (http://127.0.0.1:11434, oder wohin auch immer $OLLAMA_HOST zeigt), erkennt Persona sie automatisch und verbindet sich ohne API-Schlüssel und ohne Konfiguration. Es wählt ein sinnvolles Chat-Modell aus den installierten. Ein explizit konfigurierter Anbieter hat immer Vorrang vor der automatischen Erkennung, und persona doctor meldet, was erkannt wurde.

Der Chat-Assistent ist schreibfähig: Er kann Notizen erstellen und bearbeiten, Ordner anlegen, Dateien verschieben und umbenennen sowie deine Aufgaben verwalten — sie erstellen, aktualisieren, abschließen und löschen. Er löscht Dateien oder Ordner nur, wenn du ihn ausdrücklich darum bittest. Anbieter ohne Tool-Unterstützung fallen automatisch auf reinen Lese-Chat zurück.

Semantische Suche. Notizen werden in Blöcke zerlegt, lokal eingebettet und unter .persona/embeddings/ gespeichert. Die Einbettungen stammen in der folgenden Prioritätsreihenfolge:

1. Eine explizite Embedding-Basis-URL (optional, Einstellungen → KI) — richte sie auf einen beliebigen Anbieter mit Embedding-Unterstützung (OpenRouter, SiliconFlow, ein lokales Ollama …).

2. Ein laufendes lokales Ollama mit einem Embedding-Modell — z. B. ollama pull all-minilm oder nomic-embed-text — kein API-Schlüssel erforderlich.

3. Andernfalls der Endpunkt deines Chat-Anbieters.

Der Index wird im Hintergrund neu aufgebaut, wenn der Server startet, wenn sich dein API-Schlüssel oder das Embedding-Modell ändert, und inkrementell, wann immer eine Notiz gespeichert wird. Die Stichwortsuche gewinnt weiterhin bei exakten Übereinstimmungen; semantische Ergebnisse erscheinen als „Beste Treffer“, wenn sie einen Mehrwert bieten. Wenn keine Embedding-Quelle verfügbar ist, fällt die Suche stillschweigend auf reine Stichwortsuche zurück.

Spracheingabe (macOS). Das Chat-Feld hat einen Mikrofon-Button für lokale Spracherkennung (Speech-to-Text) über parakeet.cpp. Erforderlich sind ffmpeg (brew install ffmpeg) und ein parakeet-kompatibles GGUF-Modell. Lade ein vorgefertigtes parakeet-cli für macOS von der Releases-Seite herunter und weise Persona beides mit PERSONA_STT_MODEL=/path/to/model.gguf und PERSONA_STT_BIN=/path/to/parakeet-cli zu (auf Apple Silicon läuft das Modell auf Metal).

Erscheinungsbild

Helles, dunkles oder System-Design unter Einstellungen → Erscheinungsbild. Das Design wird in deiner Konfiguration gespeichert und folgt, wenn es auf „System“ gesetzt ist, deinem macOS-Erscheinungsbild.

Entwicklung

npm run dev        # Vite dev server (5173) + API server (4321), hot reload
npm run build      # production build: server + CLI + web app
npm run typecheck

Ad-hoc-Testskripte (benötigen zuvor einen Build):

npm run build
node scripts/tool-test.mjs       # unit-level tests for AI tools, tasks, fs
node scripts/mcp-test.mjs        # E2E: MCP server via stdio (Persona tools over MCP)
node scripts/e2e-chat-test.mjs   # E2E: AI chat performs file & task operations
node scripts/e2e-chat2-test.mjs  # E2E: chat reads notes and cites sources

Die E2E-Skripte erwarten einen Server, der gegen einen Wegwerf-Arbeitsbereich läuft (z. B. HOME=$PWD/.testhome npm run dev:server in einem anderen Terminal, sodass die Server-Konfiguration in .testhome/.persona/ landet).

MCP — Persona von Claude Code, Hermes, Cursor usw. aus verwenden

Persona ist ein MCP-Server. Jeder MCP-Client kann deinen Arbeitsbereich lesen/schreiben:

persona mcp --help
claude mcp add persona -- persona mcp   # Claude Code
# Hermes/Cursor/Windsurf: { "mcpServers": { "persona": { "command": "persona", "args": ["mcp"] } } }

Tools: 15 (list_folder, read_note, create_note, write_note, append_note, create_folder, move_file, rename_file, delete_file, list_tasks, create_task, update_task, delete_task, search, get_workspace_info) + Ressourcen (persona://workspace, persona://file/{path}) + Streamable HTTP unter http://127.0.0.1:4321/mcp.

Vollständige Einrichtung → docs/mcp.md.

Mitwirken

Eröffne ein Issue oder einen PR — Fehlerberichte, Feature-Ideen und Fragen sind alle willkommen. Richtlinien:

• Halte das Local-First-Versprechen: Alles besteht aus einfachen Dateien — keine Konten, keine Cloud, kein Lock-in.

• Der Server darf deine Dateien niemals an jemand anderen senden als an den von dir explizit konfigurierten KI-Anbieter; der Embedding-Index ist lokal.

• Führe vor dem Eröffnen eines PRs npm run typecheck und npm run build aus, und füge einen scripts/-Test hinzu, wenn du das Serververhalten änderst.

• Das Paket ist MIT-lizenziert; mit deinem Beitrag stimmst du denselben Bedingungen zu.

Architektur

persona CLI ── spawns ──▶ local Hono server (127.0.0.1:4321 — first free port)
                              │  REST API + SSE events
                              ├─ filesystem (chokidar watcher)
                              ├─ tasks (Markdown + frontmatter)
                              ├─ AI (OpenAI-compatible, streaming)
                              └─ embeddings (semantic index, local JSON)
                              │
                              ▼
                    React app (prebuilt, served by the server)

Star History