pixit

My pi coding agent package: extensions, skills, and themes I use across projects.

Install with:

pi install npm:@sentomk/pixit

Extensions

• vim.ts - Vim-style prompt editor with normal/insert modes, motions, operators, undo/redo, and per-mode custom key mappings. Toggle with /vim; see configuration below.
• questionnaire.ts - Unified questionnaire tool. Single questions show an option list, multiple questions get tab navigation, multiple: true enables checkbox multi-select with accumulating custom entries, and empty options render a free-text editor. Includes /answer (shortcut ctrl+.): extracts unanswered questions from the last assistant message via LLM, lets you answer them in the same TUI, then sends the compiled answers back to trigger a new turn.
• custom-footer.ts - Two-line status footer (tokens/cost/context + git branch/model/thinking level), O(1) cached rendering, toggled with /footer.
• xedit.ts - Enhanced editing tool (xedit). Classic exact-replace plus multi batch edits and Codex-style patch. Ambiguous multi-match edits are rejected with match line numbers unless replaceAll: true; unambiguous whitespace-tolerant fuzzy matching kicks in when exact match fails; every batch runs on a virtual filesystem first and rolls back all writes if any step fails.
• btw.ts - /btw side-chat popover with optional summary injection back into the main chat.
• review.ts - Code review command (working tree, PR-style diff, commits, custom instructions).
• todos.ts - File-backed todo manager with TUI.
• checkpoint.ts - Automatic per-turn git snapshots into a private ref chain (never touches your index or branch). /undo reverts the working tree to before the last agent turn (repeat to walk further back), /checkpoints lists recent snapshots.
• second-opinion.ts - /so [question] sends the recent conversation to a different model than the active one and prints its independent critique. Model choice is remembered for the session.
• session-grep.ts - /sg <query> full-text search across past sessions of this project; selecting a result prints the original message back into chat.
• clipboard.ts - /copy-code copies the last fenced code block from the assistant's reply to the system clipboard (clip.exe / pbcopy / wl-copy / xclip / xsel).

Vim prompt editing

Vim mode is enabled when this package loads and starts in INSERT mode. Press Esc for NORMAL, then i to resume typing. The editor's top border shows the mode and pending keys. This edits the chat prompt; it does not launch an external Vim process or edit project files directly.

Counts work with motions and operators, e.g. 3w, 2dd, d2w, 2d3w, 3gg, 2x, and d2ge. dge includes both the destination and the character under the cursor, matching Vim's inclusive backward motion. j/k stay within the current prompt rather than browsing history. The yank register is internal to this editor, separate from the system clipboard. This is a focused Vim subset: visual mode, macros, registers, search commands, . repeat, Ex commands, and .vimrc are not implemented.

Enter still sends the prompt, Shift+Enter inserts a newline, and pi's app shortcuts remain available unless explicitly mapped. An open completion menu takes priority; Escape first dismisses it. Otherwise Escape leaves INSERT mode, cancels a pending NORMAL command, or passes through to pi's interrupt action when already in idle NORMAL mode. Bracketed paste inserts literal text in either mode, without executing Vim commands or mappings. Undo history is cleared after submission or externally replacing the draft.

Custom key mappings

Create ~/.pi/agent/vim.json for global settings (or vim.json inside PI_CODING_AGENT_DIR if customized). A project's .pi/vim.json overrides global settings; mappings merge by mode and key. No config file is required.

{
  "enabled": true,
  "startMode": "insert",
  "timeout": 400,
  "leader": " ",
  "mappings": {
    "insert": {
      "jj": "<Esc>",
      "jk": "<Esc>"
    },
    "normal": {
      "H": "0",
      "L": "$",
      "<leader>y": "yy",
      "<C-s>": "<Enter>"
    }
  }
}

Mappings expand into Vim keys without recursively applying other mappings. Use "" to swallow a key, or null to remove an inherited mapping and restore its default behavior. Supported notation: <Esc>, <Enter>/<CR>, <Tab>, <BS>, <Del>, <Space>, <lt>, <Left>/<Right>/<Up>/<Down>, <Home>/<End>, <C-a> through <C-z>, and <leader>. Escape itself is reserved for leaving a mode or cancelling. leader is one printable character; timeout is 50–5000 milliseconds. Unmatched or timed-out INSERT prefixes are replayed literally, so typing a lone j is not lost. Ambiguous mappings wait for the timeout or another key; the longest complete match wins.

Use /vim on, /vim off, /vim reload, or /vim status; /vim alone toggles. reload re-reads both config files, including enabled. Invalid files produce a warning and are skipped, keeping defaults and settings from other valid files. Toggling preserves the current draft. Vim uses pi's custom-editor slot; when disabled, it restores the previous editor if it still owns that slot. It does not combine editing behavior with another custom editor.

Themes

• tokyo-night.json - Tokyo Night-inspired theme.
• one-dark-pro.json - One Dark Pro-inspired theme.

Select with /theme or set "theme" in settings.json.

Run tests:

node --experimental-strip-types tests/test-xedit.mjs
node --experimental-strip-types tests/test-checkpoint.mjs
node --experimental-strip-types tests/test-select-list.mjs
node --experimental-strip-types --test tests/test-vim.mjs

Development

Local testing without publishing:

pi install /absolute/path/to/pixit

Or try it for one run only:

pi -e /absolute/path/to/pixit

Publish a new version (publishes to the public npm registry, as @sentomk/pixit — see publishConfig in package.json):

npm login --registry https://registry.npmjs.org/   # once per machine
npm version patch   # or minor / major
npm publish

Note: commit the version bump before publishing so the gitHead recorded in the package metadata points at the released tree.