Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion site/src/content/docs/de/docs/features/sessions.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -20,9 +20,10 @@ Das Dashboard ist der einzige Ort, um alle laufenden Agents im Blick zu haben un
- **Multi-CLI:** Der Picker bietet Claude Code, Codex (`--sandbox`-Varianten), Antigravity (`agy`) und opencode, jede CLI mit eigenem Login.
- **Umbenennen / adoptieren / anpinnen / stummschalten:** Umbenennen behält den Hook-State; *adoptieren* registriert eine fremde Session unter ihrem Originalnamen; *anpinnen* sortiert sie nach oben; *stummschalten* unterdrückt ihre Benachrichtigungen.
- **Auto-Restore:** Nach einem Neustart startet der Hub die zuletzt laufenden `cc-`-Sessions in ihrem ursprünglichen Verzeichnis neu und setzt die CLI-Konversation fort (`claude --continue`, `codex resume --last`, `agy --continue`). Opt-out durch bewusstes Stoppen der Session.
- **Copy/Paste auf dem Handy:** In der installierten iOS-PWA hat die Terminal-Touch-Bar eigene Paste- und Copy-Tasten, da Hardware-Cmd+C/V fehlt. Paste liest die Zwischenablage und fügt sie per Bracketed-Paste ein. Zum Kopieren Text per Long-Press plus Ziehen markieren, dann Copy antippen.

![Das Penates Session-Dashboard](../../../../../assets/screenshots/sessions.png)

## Grenzen

Auto-Restore gilt nur nach einem Neustart und stellt die CLI-Konversation wieder her, keinen unterbrochenen Task und keinen im RAM gespeicherten tmux-Scrollback. Fremde (nicht über den Hub gestartete) Sessions zeigen Aktivität `unknown`, bis ein Hook feuert. Die `@`-Mention-Helfer (Image-Paste, Voice) sind Claude-Code-spezifisch.
Auto-Restore gilt nur nach einem Neustart und stellt die CLI-Konversation wieder her, keinen unterbrochenen Task und keinen im RAM gespeicherten tmux-Scrollback. Fremde (nicht über den Hub gestartete) Sessions zeigen Aktivität `unknown`, bis ein Hook feuert. Die `@`-Mention-Helfer (Image-Paste, Voice) sind Claude-Code-spezifisch. Touch-Bar-Copy braucht tmux zum Empfangen des Drags, daher funktioniert die Markierung nur an einem Shell-Prompt — Vollbild-CLIs (Claude Code, Codex) fangen die Maus selbst ab.
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ Die Settings-Ansicht ist der zentrale Ort, um das Aussehen und Verhalten von Pen
**Einstellungen** umfassen acht Bereiche:

- **Erscheinungsbild:** Theme (Catppuccin Latte, Frappé, Macchiato, Mocha) und UI-Sprache (Englisch oder Deutsch).
- **Terminal:** Schriftgröße, Scrollback-Zeilen, Mouse-Mode (`TMUX_MOUSE`) und Copy-on-Select.
- **Terminal:** Schriftgröße, Scrollback-Zeilen, Mouse-Mode (`TMUX_MOUSE`), Copy-on-Select und (nur macOS) ob ⌥ (Option) als Meta wirkt — standardmäßig aus, damit Layout-Zeichen europäischer Tastaturen (`@ | { } [ ] ~`) normal getippt werden; an reaktiviert Option-basierte Readline-Wort-Navigation (⌥B/⌥F).
- **Notifications:** Steuerung des Web-Push-Abonnements.
- **Behavior:** Startansicht und weitere UX-Einstellungen.
- **Session-Wiederherstellung:** Zwei Schalter steuern das automatische Wiederherstellen nach einem Neustart. Der erste aktiviert oder deaktiviert das Feature; der zweite legt fest, ob `--continue` an die CLI übergeben wird, um die letzte Konversation fortzusetzen. Beide Schalter gelten ab dem nächsten Hub-Start.
Expand Down
3 changes: 2 additions & 1 deletion site/src/content/docs/docs/features/sessions.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -20,9 +20,10 @@ The dashboard is the single place to see and steer every running agent: live act
- **Multi-CLI:** the picker offers Claude Code, Codex (`--sandbox` variants), Antigravity (`agy`), and opencode, each with its own login.
- **Rename / adopt / pin / mute:** rename keeps the hook state attached; *adopt* registers a foreign session under its original name; *pin* sorts it to the top; *mute* silences its notifications.
- **Auto-restore:** after a reboot the hub re-spawns the last running `cc-` sessions in their original directory, continuing the CLI conversation (`claude --continue`, `codex resume --last`, `agy --continue`). Opt out per session by stopping it deliberately.
- **Mobile copy/paste:** on the installed iOS PWA, the terminal touch-bar has dedicated Paste and Copy keys since hardware Cmd+C/V isn't available. Paste reads the clipboard and inserts it via bracketed-paste. To copy, long-press and drag over text to select it, then tap Copy.

![The Penates session dashboard](../../../../assets/screenshots/sessions.png)

## Limits

Auto-restore is reboot-only and brings back the CLI conversation, not an interrupted task or the in-RAM tmux scrollback. Foreign (non-hub) sessions show activity `unknown` until a hook fires. The `@`-mention helpers (image paste, voice) are Claude-Code-specific.
Auto-restore is reboot-only and brings back the CLI conversation, not an interrupted task or the in-RAM tmux scrollback. Foreign (non-hub) sessions show activity `unknown` until a hook fires. The `@`-mention helpers (image paste, voice) are Claude-Code-specific. Touch-bar copy needs tmux to receive the drag, so selection only works at a shell prompt — full-screen CLIs (Claude Code, Codex) capture the mouse themselves.
2 changes: 1 addition & 1 deletion site/src/content/docs/docs/features/settings-updates.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ The Settings view is the central place to configure how Penates looks and behave
**Settings** covers eight sections:

- **Appearance:** theme (Catppuccin Latte, Frappé, Macchiato, Mocha) and UI language (English or German).
- **Terminal:** font size, scrollback lines, mouse mode (`TMUX_MOUSE`), and copy-on-select.
- **Terminal:** font size, scrollback lines, mouse mode (`TMUX_MOUSE`), copy-on-select, and (macOS only) whether ⌥ (Option) acts as Meta — off by default so EU keyboard layout characters (`@ | { } [ ] ~`) type normally; on re-enables Option-based readline word navigation (⌥B/⌥F).
- **Notifications:** web push subscription control.
- **Behavior:** start view and other UX preferences.
- **Session restore:** two toggles control auto-restore after a reboot. The first enables or disables the feature; the second controls whether `--continue` is passed to the CLI (to resume the last conversation). Both take effect on the next hub boot.
Expand Down