πgrok-pi/Documentation

Feature Matrix

Field-level map for v0.0.8. Full SSOT: FEATURE_MATRIX.md. Status: Native · Adapted · Native+Adapted · Boundary · Experimental.

Deep dives: Extensions · Commands · Configuration

Terminal & display

FeatureStatusNotes
Terminal init/restoreNativeGrok init_terminal / restore_terminal
Welcome / logoNative+AdaptedWelcome default; π block art; --continue skips Welcome
Update check/installAdaptedGitHub Releases + official npm metadata + JSP proxy fallback; grok-pi update
Theme / timestamps / mouseNative+AdaptedPi theme JSON → Grok Theme; pi:transparent*
Voice dictationNative+Adapted/voice · Ctrl+Space/F8 · xAI STT
Markdown / tool cards / diffsNative+AdaptedACP chunks → native Pager surfaces
Todo / plan listNative+AdaptedBuilt-in todo (F2 pi_todo, default on) → ACP Plan → TodoPane
Plan modeNative+Adapted/plan-mode · Ctrl+Shift+T (Windows: Ctrl+Alt+T) · tool gate · exit_plan_mode
Goal modeAdaptedF2 pi_goal default off; /goal + agent_settled follow-up

Agent & streaming

FeatureStatusNotes
Prompt / steer / follow-upAdaptedACP prompt; sendNow→steer; default mid-turn→followUp
Abort + queue clearAdaptedclear_queue then abort; queue mirror via x.ai/queue/changed
Bash + Send to BackgroundNative+Adaptedpi-grok-bash; x.ai/terminal/background; task kill
Sub-agentsNative+Adaptedpi-grok-subagents → SubagentBlock / Tasks Pane
Rhai workflowsNative+AdaptedF2 pi_workflows; /workflow /workflows /create-workflow
CompactionNative+Adapted/compact → Pi compact; native progress blocks
Session recapAdapted/recap · auto away ≥3 min · optional Mermaid F2
Context bar + /contextNative+AdaptedLive breakdown modal; not written to history

Model, session & commands

FeatureStatusNotes
Model catalogAdaptedget_available_models → native picker
Resume / session pickerAdaptedPi JSONL catalog; Ctrl+F full-text search
Session treeAdaptednavigateTree; non-destructive (≠ Grok Rewind)
Fork / cloneAdapted/fork /clone · rebind + session/load
Jump / reviewNative+Adapted/jump turns; /review-session · /review-message
ReloadAdapted/reload blocks streaming+compacting; theme rediscover
HTML export / shareAdapted/export-html · /pi-share (default-on)
Pi resource managerNative+AdaptedRust /pi-config two-pane; not install/remove

Reliability & isolation

FeatureStatusNotes
Product home isolationAdapted~/.grok-pi + <repo>/.grok-pi; migrate-home
Extension self-healAdaptedBootstrap bisect on crashing --extension; -ne escape
Resource admission policyAdaptedAllow/block lists + heuristics at spawn
Remote TUIExperimentalPI_GROK_REMOTE_TUI=1; ctx.mode facade tui; no Pi fork

Boundaries (deliberate)

FeatureStatusNotes
Grok cloud history / usageBoundaryPi owns local sessions
Adapter TUI / second rendererBoundaryadapter stays headless
Pi source RPC patchesBoundaryprefer official extension API
rpiv-ask pure JSONLBoundaryneeds Remote TUI custom host
Grok destructive RewindBoundaryuse SessionTree navigation instead