packages / mgiles-perk
extension Modes & workflows

@mgiles/perk

perk Pi extension (session interior) for the plan-oriented workflow.

No reviews yet

Install

$ pi install npm:@mgiles/perk

Installs from npm into ~/.pi/agent/. Add -l for project-local (.pi/). Manage with pi list / pi update / pi remove.

What this package can reach

Detected automatically from the source at version 2.1.0. This describes access, not safety — you decide whether it's appropriate for what the package claims to do.

  • 🤖
    Behavior — Changes how the agent thinks Modifies the system prompt, injects messages, or rewrites conversation context.
  • Commands — Runs shell commands Spawns processes on your machine.
  • 🔑
    Credentials — Handles your API keys Reads or passes provider credentials. Highest-trust capability there is.
  • 📁
    Files — Reads files outside your project Touches paths beyond the working directory, such as your home folder.
  • Intercepts tools — Can block or rewrite tool calls Subscribes to tool_call/tool_result/input. Can change a command after you approved the one displayed.
  • 🌐
    Network — Talks to the internet Makes outbound network requests. Check the destinations are ones you expect.
  • Subagents — Spawns agents or sessions Runs additional agents. Ask whether it caps iterations and spend.
  • 🔀
    Tool control — Can switch pi's tools on and off Calls setActiveTools, so it can disable built-ins — including safety-relevant ones.
  • 🔧
    New tools — Adds model-callable tools Gives the agent new abilities. Additive and visible, unlike an override.
  • UI — Draws its own interface Renders widgets, footers, dialogs or full-screen views.

What it actually did when run

observed

Loaded 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.

Tools registered plan_reviewplan_saveplan_draftobjective_draftask_user_questionsubmitreadylandlearnresolve_review_threadspost_pr_reviewsubmit_pr_reviewrun_ciobjective_saveobjective_nodereconcile_objectiveadd_objective_node

Events subscribed agent_settledbefore_agent_startcontextplannotator:review-resultsession_before_forksession_before_switchsession_compactsession_shutdownsession_startsession_treetool_callturn_endturn_start

APIs called appendEntryevents.onexecexec.stderr.trimgetActiveToolsgetCommandsgetCommands.somegetSystemPromptgetSystemPrompt.replacegetSystemPrompt.replace.replacegetSystemPrompt.replace.replace.trimgetSystemPromptOptionsgetThinkingLevelmodelRegistry.getApiKeyAndHeadersmodelRegistry.hasConfiguredAuthregisterCommandregisterEntryRendererregisterFlagregisterShortcutregisterToolsessionManager.getBranchsessionManager.getEntriessessionManager.getLeafIdsetActiveToolsui.customui.custom.catchui.notifyui.setStatusui.setWorkingMessage

14 calls the source scan did not predict

events.on · exec.stderr.trim · getCommands.some · getSystemPrompt.replace · getSystemPrompt.replace.replace · getSystemPrompt.replace.replace.trim · getSystemPromptOptions · modelRegistry.hasConfiguredAuth · on("plannotator:review-result") · registerEntryRenderer · ui.custom.catch · ui.notify · ui.setStatus · ui.setWorkingMessage

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 2.1.0 on 2026-08-02. Registration-time behaviour under default settings; other configurations may differ.

Review before you install. pi packages run with your full system permissions. Check the source, pin versions, and prefer authors you trust.

Reviews

0 published

Sign 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