ultimate-pi
Governed AI coding harness for pi.dev — bootstrap, plan, execute, review, and steer with deterministic policy gates
Install
pi install npm:ultimate-pi
Installs from npm into ~/.pi/agent/.
Add -l for project-local (.pi/). Manage with pi list / pi update / pi remove.
What it actually did when run
observedLoaded in a sandbox with no network, a read-only filesystem and a recording stand-in for pi's API. This is what it called — not what the source suggests it might.
Replaces pi's built-in tools: read, edit.
Every use of those tools goes through this
package instead of pi.
Tools registered readeditharness_plan_debate_eligibilityharness_debate_openharness_messenger_postharness_messenger_read_roundharness_debate_submit_roundharness_debate_consensusharness_debate_apply_laneharness_debate_round_statusharness_debate_focus_coverageharness_debate_advance_threadharness_plan_scope_checklsp_diagnosticslsp_navigationapprove_plancreate_planharness_plan_next_actionharness_plan_routeweb_searchweb_fetchweb_find_similarweb_contentsvcc_recall
Events subscribed agent_endagent_startbefore_agent_startbefore_provider_requestcontextharness-cross-session-resumeharness-progress:updatedharness-project-enabled:changedharness-run-context:updatedharness-runs-clearedharness-waiting-for-userinputmodel_selectpi-lens/analysis-completepi-lens/findingspi-lens/turn-findingsplan-approval:mountedresources_discoversession_before_compactsession_compactsession_shutdownsession_startsubagents:agents-widget-mountedtool_calltool_execution_endtool_execution_starttool_resultturn_start
APIs called appendEntrycompactevents.emitevents.onregisterCommandregisterFlagregisterMessageRendererregisterToolsendMessagesessionManager.getBranchsessionManager.getEntriessessionManager.getEntries.length.toJSONsessionManager.getEntries.mapsessionManager.getEntries.map.filtersessionManager.getSessionFilesessionManager.getSessionIdsessionManager.getSessionId.trimui.notifyui.setHeaderui.setStatus
48 calls the source scan did not predict
appendEntry · compact · events.emit · events.on · on("agent_end") · on("agent_start") · on("before_agent_start") · on("before_provider_request") · on("context") · on("harness-cross-session-resume") · on("harness-progress:updated") · on("harness-project-enabled:changed") · on("harness-run-context:updated") · on("harness-runs-cleared") · on("harness-waiting-for-user") · on("input") · on("model_select") · on("pi-lens/analysis-complete") · on("pi-lens/findings") · on("pi-lens/turn-findings") · on("plan-approval:mounted") · on("resources_discover") · on("session_before_compact") · on("session_compact") · on("session_shutdown") · on("session_start") · on("subagents:agents-widget-mounted") · on("tool_call") · on("tool_execution_end") · on("tool_execution_start") · on("tool_result") · on("turn_start") · registerCommand · registerFlag · registerMessageRenderer · registerTool · sendMessage · sessionManager.getBranch · sessionManager.getEntries · sessionManager.getEntries.length.toJSON · sessionManager.getEntries.map · sessionManager.getEntries.map.filter · sessionManager.getSessionFile · sessionManager.getSessionId · sessionManager.getSessionId.trim · ui.notify · ui.setHeader · ui.setStatus
Reached through a value the scan could not follow — passed as an argument, stored on another object, or returned by a helper.
Run against version 0.26.0 on 2026-08-02.
Registration-time behaviour under default settings; other configurations may differ.
Reviews
0 publishedSign in with GitHub to write a review, reply, or vote.
No reviews yet — be the first.
More in Modes & workflows
- pi-executor — Pi extension to run executor
- pi-gsd — Get Shit Done - Unofficial port of the renowned AI-native project-planning spec-driven too…
- @gonrocca/zero-pi-todo — zero-pi-todo — TODOs persistentes para pi, con tool, slash command y overlay aboveEditor.
- @siddr/pi-review — Interactive review mode extension for pi