agent/pi - pi - Penguin

Merge branch 'feat/ctrl-n-external-editor' - configurable keybindings (#405 )

Mario Zechner · 2026-01-03 22:51:12 +01:00

f2b89d5ec5

feat: add type-safe KeyId for matchesKey function

- Add KeyId union type covering all valid key combinations
- Add Key helper object for autocomplete (Key.ctrl('c'), Key.escape, etc.)
- Update matchesKey signature to use KeyId instead of string
- Catches typos like 'esacpe' at compile time

Helmut Januschka · 2026-01-03 16:03:35 +01:00

38b7f21e01

fix: slash command autocomplete triggers for . - _ prefixes

fixes #422

Mario Zechner · 2026-01-03 15:44:36 +01:00

69a8ecd5b3

fix: selectCancel should include both escape and ctrl+c

Helmut Januschka · 2026-01-03 08:23:56 +01:00

2bd7b79a9b

feat: use keybindings in all selectors and lists

Update all selector/list components to use EditorKeybindingsManager:
- model-selector, session-selector, oauth-selector, user-message-selector
- hook-selector, hook-input, hook-editor, tree-selector
- select-list, settings-list, cancellable-loader

This allows users to configure selectUp, selectDown, selectConfirm,
selectCancel actions in keybindings.json

Helmut Januschka · 2026-01-03 08:23:56 +01:00

7574fed2f2

feat: configurable keybindings for all editor and app actions

All keybindings configurable via ~/.pi/agent/keybindings.json

Editor actions:
- cursorUp, cursorDown, cursorLeft, cursorRight
- cursorWordLeft, cursorWordRight, cursorLineStart, cursorLineEnd
- deleteCharBackward, deleteCharForward, deleteWordBackward
- deleteToLineStart, deleteToLineEnd
- newLine, submit, tab
- selectUp, selectDown, selectConfirm, selectCancel

App actions:
- interrupt, clear, exit, suspend
- cycleThinkingLevel, cycleModelForward, cycleModelBackward
- selectModel, expandTools, toggleThinking, externalEditor

Also adds support for numpad Enter key (Kitty protocol codepoint 57414
and SS3 M sequence)

Example emacs-style keybindings.json:
{
  "cursorUp": ["up", "ctrl+p"],
  "cursorDown": ["down", "ctrl+n"],
  "cursorLeft": ["left", "ctrl+b"],
  "cursorRight": ["right", "ctrl+f"],
  "deleteCharForward": ["delete", "ctrl+d"],
  "cycleModelForward": "ctrl+o"
}

Helmut Januschka · 2026-01-03 08:23:56 +01:00

8f2682578b

Merge PR #382 : word wrapping in Editor component

Mario Zechner · 2026-01-03 00:48:28 +01:00

2b054cdb7c

tui: wrap settings descriptions instead of truncating

Mario Zechner · 2026-01-03 00:45:28 +01:00

e1b0b37ba4

Merge pull request #411 from nathyong/feature/shift-backspace

tui: fix shift+space/backspace/delete on kitty-protocol terminals

Mario Zechner · 2026-01-03 00:28:58 +01:00

3506ac81f2

Add terminal title support to TUI framework (#407 )

Add setTitle() method to Terminal interface for setting window title.
Uses standard OSC escape sequence \x1b]0;...\x07 for broad terminal
compatibility (macOS Terminal, iTerm2, Kitty, WezTerm, Ghostty, etc.).

Changes:
- Add setTitle(title: string) to Terminal interface
- Implement in ProcessTerminal using OSC sequence
- Implement no-op in VirtualTerminal for testing
- Use in interactive mode to set title as "pi - <dirname>"

Kao Félix · 2026-01-02 22:00:34 +01:00

5c3c8e6f7e

tui: fix shift+space/backspace/delete on kitty-protocol terminals

Kitty and other smart terminals send a specific CSI u control code for
these shifted special keys, which are interpreted as a no-op by the
editor component. These should send the underlying key instead, matching
the behaviour of other TUI programs (e.g. readline, vim insert mode).

On less smart terminals, these key combinations are the same as the
non-shifted versions, and so already work with the existing code.

nathyong · 2026-01-03 06:58:56 +11:00

c9b08d7643

fix(tui): Strip OSC 8 hyperlink sequences in visibleWidth (#396 )

cursive · 2026-01-02 10:32:36 +01:00

d97a96493c

tui: only check for emojis in visibleWidth when necessary

The initial render of a session, and any re-draws caused by terminal
resizing are noticeably slow, especially on conversations with 20+
turns and many tool calls.

From profiling with `bun --cpu-prof` (available since bun 1.3.2), the
majority of the rendering (90%) is spent on detection of emojis in the
string-width library, running the expensive `/\p{RGI_Emoji}$/v`
regular expression on every individual grapheme cluster in the entire
scrollback. I believe it essentially expands to a fixed search against
every possible emoji sequence, hence the amount of CPU time spent in it.

This change replaces the `stringWidth` from string-width with a
`graphemeWidth` function that performs a similar check, but avoids
running the `/\p{RGI_Emoji}$/v` regex for emoji detection unless it
contains codepoints that could be emojis.

The `visibleWidth` function also has two more optimisations:
- Short-circuits string length detection for strings that are entirely
  printable ASCII characters
- Adds a cache for non-ASCII segments to avoid recomputing string length
  when resizing

nathyong · 2026-01-02 01:56:11 +01:00

6e4270a286

Fix crash on Unicode format characters in visibleWidth

Strip all Unicode format characters (category Cf) before passing to
string-width. These are invisible control characters that crash
string-width but have no visible width anyway.

Closes #390

Mario Zechner · 2026-01-01 22:33:09 +01:00

1d9fa13d58

Fix characters (#372 )

* Fix cat command

* Fix text rendering crash from undefined code points in bash output

* Revert unintentional model parameter changes from fix cat command commit

Mr. Rc · 2026-01-01 02:16:29 +01:00

bbf23bd5f1

Add setEditorText/getEditorText to hook UI context, improve custom() API

- Add setEditorText() and getEditorText() to HookUIContext for prompt generator pattern
- custom() now accepts async factories for fire-and-forget work
- Add CancellableLoader component to tui package
- Add BorderedLoader component for hooks with cancel UI
- Export HookAPI, HookContext, HookFactory from main package
- Update all examples to import from packages instead of relative paths
- Update hooks.md and custom-tools.md documentation

fixes #350

Mario Zechner · 2026-01-01 00:04:56 +01:00

6f7c10e323

feat(tui): implement word wrapping in Editor component

Previously, the Editor component used character-level (grapheme-level)
wrapping, which broke words mid-character at line boundaries. This
created an ugly visual experience when typing or pasting long text.

Now the Editor uses word-aware wrapping:
- Wraps at word boundaries when possible
- Falls back to character-level wrapping for tokens wider than the
  available width (e.g., long URLs)
- Strips leading whitespace at line starts
- Preserves multiple spaces within lines

Added wordWrapLine() helper function that tokenizes text into words
and whitespace runs, then builds chunks that fit within the specified
width while respecting word boundaries.

Also updated buildVisualLineMap() to use the same word wrapping logic
for consistent cursor navigation.

Added tests for:
- Word boundary wrapping
- Leading whitespace stripping
- Long token (URL) character-level fallback
- Multiple space preservation
- Edge cases (empty string, exact fit)

Nick Seelert · 2025-12-30 23:05:35 -05:00

dde5f25170

Export wrapTextWithAnsi utility and add handleInput docs

- Export wrapTextWithAnsi from tui package
- Add 'Handling Input' section to README with key detection example
- Document wrapTextWithAnsi in utilities section

Mario Zechner · 2025-12-30 23:28:38 +01:00

71cbae6371

Tree selector improvements: active line highlight and tool filter

- Add inverse background highlight for selected/active line
- Add 'no-tools' filter mode to hide tool results
- Add isShiftCtrlO to cycle filters backwards
- Filter order: default → no-tools → user-only → labeled-only → all

Mario Zechner · 2025-12-30 22:42:25 +01:00

e4df5d14b5

fix(tui): render HTML tags as plain text in Markdown component

Handles both block-level and inline HTML tags that were previously
silently dropped.

fixes #359

Mario Zechner · 2025-12-30 22:42:24 +01:00

9427211f99

Add global debug key (Shift+Ctrl+D), iterative tree sorting to avoid stack overflow

Mario Zechner · 2025-12-30 22:42:22 +01:00

544814875e

Merge pull request #315 from mitsuhiko/model-switcher

Reverse model switching and binding for dialog

Mario Zechner · 2025-12-25 18:33:42 +01:00

4edfff41a7

Reverse model switching and binding for dialog

Armin Ronacher · 2025-12-25 18:07:36 +01:00

b576a527c7

Add /settings command with unified settings menu (#312 )

* Add /settings command with unified settings menu

- Add SettingsList component to tui package with support for:
  - Inline value cycling (Enter/Space toggles)
  - Submenus for complex selections
  - Selection preservation when returning from submenu

- Add /settings slash command consolidating:
  - Auto-compact (toggle)
  - Show images (toggle)
  - Queue mode (cycle)
  - Hide thinking (toggle)
  - Collapse changelog (toggle)
  - Thinking level (submenu)
  - Theme (submenu with preview)

- Update AGENTS.md to clarify no inline imports rule

Fixes #310

* Add /settings to README slash commands table

* Remove old settings slash commands, consolidate into /settings

- Remove /thinking, /queue, /theme, /autocompact, /show-images commands
- Remove unused selector methods and imports
- Update README references to use /settings

Mario Zechner · 2025-12-25 15:39:42 +01:00

b4f7a957c4

Fix Ctrl+W to use standard readline word deletion behavior (#306 )

- Skip trailing whitespace before deleting word (readline behavior)
- Make word navigation grapheme-aware using Intl.Segmenter
- Add Ctrl+Left/Right and Alt+Left/Right word navigation to Input
- Accept full Unicode input while rejecting control characters (C0/C1/DEL)
- Extract shared utilities to utils.ts (getSegmenter, isWhitespaceChar, isPunctuationChar)
- Fix unsafe cast in Editor.forceFileAutocomplete with runtime type check
- Add comprehensive tests for word deletion and navigation

Ahmed Kamal · 2025-12-25 04:09:47 +01:00

0427445242

Add safety-space before pasting (#307 )

* Add safety space when dropping in paths

* Add safety space when dropping in paths

Armin Ronacher · 2025-12-25 04:05:53 +01:00

65cbc22d7c

Fix Ghostty detection inside tmux for inline images (#299 )

Nico Bailon · 2025-12-24 12:04:41 +01:00

e904b11e7b

TUI: Improve file completion display (fixes #280 )

Mario Zechner · 2025-12-22 16:36:42 +01:00

31f4a588fd

Enable more biome lints and fix things

Mario Zechner · 2025-12-21 22:56:20 +01:00

d5fd685901

feat(coding-agent): add Ctrl+Z to suspend process (#267 )

* feat(tui): add isCtrlZ key detection and resetRenderState method

* feat(coding-agent): add Ctrl+Z handler to suspend process

* docs(coding-agent): add Ctrl+Z to keyboard shortcuts documentation

* feat(tui): add force parameter to requestRender

Aliou Diallo · 2025-12-21 20:19:32 +01:00

8868d623fc

feat(tui): add isCtrlG key detection

Aliou Diallo · 2025-12-21 12:06:57 +01:00

afedf1707a

Fix tab completion for absolute paths

- Fix //tmp issue: distinguish slash commands from file paths by checking if anything precedes the /
- Fix symlinks to directories (like /tmp) not getting trailing slash

Mario Zechner · 2025-12-21 02:41:38 +01:00

918750eb9e

feat(ai): add Google Cloud Code Assist provider

- Add new API type 'google-cloud-code-assist' for Gemini CLI / Antigravity auth
- Extract shared Google utilities to google-shared.ts
- Implement streaming provider for Cloud Code Assist endpoint
- Add 7 models: gemini-3-pro-high/low, gemini-3-flash, claude-sonnet/opus, gpt-oss

Models use OAuth authentication and have sh cost (uses Google account quota).
OAuth flow will be implemented in coding-agent in a follow-up.

Mario Zechner · 2025-12-20 10:20:30 +01:00

36e17933d5

fix(tui): fix input buffering in iTerm2 causing delayed keypresses

The cell size query response parser was incorrectly holding back Kitty
keyboard protocol sequences, thinking they might be incomplete cell size
responses. This caused Ctrl+C/Ctrl+D to require multiple presses in iTerm2.

Fixed by only waiting for more data if the buffer doesn't end with a
terminal escape sequence terminator character.

Mario Zechner · 2025-12-19 22:08:36 +01:00

d2276ab654

fix(tui): use isBackspace and isEnter helpers in Editor

Fixes Backspace and Enter not working with Caps Lock enabled.
The Kitty protocol sends lock key bits in modifiers which broke
the raw byte detection.

Mario Zechner · 2025-12-19 21:08:24 +01:00

84eaad8029

fix(tui): add isHome, isEnd, isDelete helpers for Kitty protocol

Extended the Kitty protocol parser to handle functional keys with
~ terminator (Delete, Insert, PageUp, PageDown) and Home/End keys.
Updated editor.ts and input.ts to use the new helpers.

Mario Zechner · 2025-12-19 21:00:20 +01:00

cbd20b58a6

fix(tui): use isEnter and isBackspace helpers in Input component

Fixes Kitty protocol handling for Enter and Backspace in the Input
component, matching the Editor component fix.

Mario Zechner · 2025-12-19 20:57:03 +01:00

716516d61e

fix(tui): handle emoji deletion and cursor movement correctly

Backspace, Delete, and arrow keys now use Intl.Segmenter to operate
on grapheme clusters instead of individual UTF-16 code units. This
fixes deletion of emojis and other multi-codepoint characters.

fixes #240

Mario Zechner · 2025-12-19 20:39:45 +01:00

b8dd9be3d0

fix(tui): handle Kitty protocol lock key modifiers

Fixes keyboard input in Ghostty on Linux when Num Lock is enabled.
The Kitty protocol includes Caps Lock (64) and Num Lock (128) bits
in modifier values. Now masks out lock bits when matching shortcuts.

Added helper functions: isArrowUp/Down/Left/Right, isEnter, isTab,
isBackspace, isShiftEnter, isAltEnter, isAltLeft/Right, isCtrlLeft/Right

fixes #243

Mario Zechner · 2025-12-19 20:34:20 +01:00

28c3ffb914

Fix Escape key handling for Kitty keyboard protocol

Add isEscape() helper that handles both raw (\x1b) and Kitty protocol
(\x1b[27u) Escape sequences. Update all components that check for
Escape key to use the new helper.

Mario Zechner · 2025-12-19 04:54:02 +01:00

f8b6164ecd

Merge kitty-protocol-support into main

Mario Zechner · 2025-12-19 01:21:47 +01:00

139af12b37

Add /hotkeys command, Ctrl+D exit, markdown table borders

Mario Zechner · 2025-12-19 01:19:21 +01:00

b2f29613e8

Remove isKittyCtrl and isKittyKey from public exports

These generic helpers aren't used externally and would require
exporting MODIFIERS constants to be ergonomic. The specific
isCtrl* helpers cover all practical use cases.

Ahmed Kamal · 2025-12-18 19:51:04 +02:00

d569f0353e

Add Ctrl+D to exit when editor is empty

- Add isCtrlD helper to keys.ts
- CustomEditor intercepts Ctrl+D and only triggers callback when editor is empty
- Single Ctrl+D with empty input exits immediately
- Update CHANGELOG to frame as feature (Kitty protocol support) not fix

Ahmed Kamal · 2025-12-18 19:39:41 +02:00

727a7ab018

Add helper functions for key detection and update usage

- Add isCtrlA/C/E/K/O/P/T/U/W helper functions that check both raw and Kitty formats
- Add isAltBackspace helper function
- Refactor editor.ts, input.ts, select-list.ts to use helper functions
- Refactor custom-editor.ts, session-selector.ts, user-message-selector.ts
- Add CHANGELOG entry for the Shift+Enter fix

Ahmed Kamal · 2025-12-18 19:29:40 +02:00

c3c2bffc68

Add Kitty keyboard protocol support for Shift+Enter and other modifier keys

Enable the Kitty keyboard protocol on terminal start to receive enhanced
key sequences that include modifier information. This fixes Shift+Enter
not working in Ghostty, Kitty, WezTerm, and other modern terminals.

Changes:
- Enable Kitty protocol on start (\x1b[>1u), disable on stop (\x1b[<u)
- Add centralized key definitions in packages/tui/src/keys.ts
- Support both legacy and Kitty sequences for all modifier+key combos:
  - Shift+Enter, Alt+Enter for newlines
  - Shift+Tab for thinking level cycling
  - Ctrl+C, Ctrl+A, Ctrl+E, Ctrl+K, Ctrl+U, Ctrl+W, Ctrl+O, Ctrl+P, Ctrl+T
  - Alt+Backspace for word deletion
- Export Keys constants and helper functions from @mariozechner/pi-tui

Ahmed Kamal · 2025-12-18 19:20:30 +02:00

4a4531f887

Add syntax highlighting to markdown code blocks

Sergii Kozak · 2025-12-17 20:15:44 -08:00

f8e6d62db7

Fix markdown tables overflowing/wrapping in TUI (width-aware rendering) (#206 )

Fix markdown tables overflowing/wrapping in TUI

Ahmed Kamal · 2025-12-17 17:13:27 +01:00

c1113deea9

Fix TUI performance regression: add caching to Box, use Text directly for built-in tools

Mario Zechner · 2025-12-17 16:39:23 +01:00

909989066a

Custom tools with session lifecycle, examples for hooks and tools

- Custom tools: TypeScript modules that extend pi with new tools
  - Custom TUI rendering via renderCall/renderResult
  - User interaction via pi.ui (select, confirm, input, notify)
  - Session lifecycle via onSession callback for state reconstruction
  - Examples: todo.ts, question.ts, hello.ts

- Hook examples: permission-gate, git-checkpoint, protected-paths

- Session lifecycle centralized in AgentSession
  - Works across all modes (interactive, print, RPC)
  - Unified session event for hooks (replaces session_start/session_switch)

- Box component added to pi-tui

- Examples bundled in npm and binary releases

Fixes #190

Mario Zechner · 2025-12-17 16:03:23 +01:00

e7097d911a

334 Commits