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-dynamic-workflows — Claude-Code-style dynamic workflow orchestration for Pi.
- @raoxxxwq/pi-tasks — A pi extension that brings Claude Code-style task tracking and coordination to pi.
- @ifi/oh-pi-skills — On-demand skill packs for pi: web-search, debug-helper, git-workflow, and more.
- pi-plan-modus — Read-only plan mode with RepoPrompt-aware write blocking; restricts tools, bash commands, …