Pi Terminal IDE (@suaiva/pi-terminal-ide)

3-Pane Sovereign AI Terminal IDE for Pi, Oh My Pi, and Claude Code — combining coding agent control, silent Neovim human editing, and with-managed Playwriter ARIA browser testing.

┌─────────────────────────────────────────────────────────────────────────────┐
│                            Pi Terminal IDE Layout                           │
├──────────────────────────────┬──────────────────────────────────────────────┤
│ [Pane: agent] (宽: 50%)      │ [Pane: nvim] (宽: 50%, 高: 60%)              │
│ - Pi / OMP / Claude Code     │ - 人类主权区（绝对静默，防刷屏/防夺焦点）    │
│ - 核心规划、编码、测试       │ - 依赖磁盘 autoread 与 gitsigns 呈现 Diff    │
│ - 接收人类视觉标注图片       ├──────────────────────────────────────────────┤
│ - 执行 Playwriter 验证       │ [Pane: qa-runtime] (高: 40%)                 │
│                              │ - 本地 Dev Server (Vite / Next.js)           │
│                              │ - 基于 with 管理器的 Playwriter 会话池       │
└──────────────────────────────┴──────────────────────────────────────────────┘

Features

• Sovereign editing (Zero-focus-stealing): Agent writes files to disk silently; Neovim detects changes via autoread and gitsigns. Agent NEVER issues intrusive remote commands (:e, :checktime, forced splits) that disrupt human mode or cursor.
• Multiplexer-agnostic: Native support for both Herdr (with Kitty Graphics passthrough) and Luvus (lightweight pure-ANSI terminal).
• With-bound browser testing: Playwriter headless browser verification runs inside Python context managers guaranteeing instant, deterministic session cleanup on exit or error.
• Semantic bus topology: Panes are strictly addressed by semantic labels (agent, nvim, qa-runtime) rather than transient PTY IDs.
• Snapshot-first ARIA inspection: Automated UI validation defaults to ARIA accessibility trees (~50-100 tokens), avoiding multimodal visual clutter and token waste.

Installation

# Install package into Pi
pi install git:github.com/suainam/pi-terminal-ide
# Or from local clone:
pi install ./pi-terminal-ide

Quick Start

1. Launch 3-Pane IDE

Inside Herdr or Luvus:

# In Herdr session:
~/.pi/agent/skills/herdr-nvim-qa-workspace/scripts/herdr-ide.sh .

# In Luvus session:
~/.pi/agent/skills/luvus-nvim-qa-workspace/scripts/luvus-ide.sh .

2. Neovim Integration

Source the helper in your init.lua:

-- For Herdr:
dofile(vim.fn.expand("~/.pi/agent/skills/herdr-nvim-qa-workspace/scripts/herdr.lua"))
-- For Luvus:
dofile(vim.fn.expand("~/.pi/agent/skills/luvus-nvim-qa-workspace/scripts/luvus.lua"))

• <leader>aa (visual mode): Dispatches code selection and prompt directly to the adjacent agent pane.
• :HerdrQA / :LuvusQA: Runs Playwriter ARIA headless verification on http://localhost:5173.

3. Automated QA Watcher

In the qa-runtime pane, run the test watcher:

QA_TEST_CMD="npm test" ./scripts/qa-watch.sh

Automatically captures regression failures with loop protection and alerts the agent to fix code.

License

MIT © suainam