@howaboua/pi-vent

Pi extension for logging repeated workflow friction to VENT.md.

Packages

Package details

extension

Install @howaboua/pi-vent from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:@howaboua/pi-vent

Package: @howaboua/pi-vent
Version: 0.2.10
Published: Jul 14, 2026
Downloads: 948/mo · 389/wk
Author: howaboua
License: MIT
Types: extension
Size: 8.1 KB
Dependencies: 0 dependencies · 3 peers

Pi manifest JSON

{
  "extensions": [
    "./extensions/vent.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

@howaboua/pi-vent

Adds an agent-callable vent tool for recording repeated or systemic workflow friction in the current workspace's VENT.md.

Use it for recurring tool failures, repeated manual workarounds, noisy output that forces the same retries, or instructions that repeatedly cause backtracking. Ordinary lint errors, one-off mistakes, and routine debugging do not belong there.

Entries are batched near the end of an agent turn to avoid constant tool chatter.

Install

pi install npm:@howaboua/pi-vent

Project-only install:

pi install -l npm:@howaboua/pi-vent

Tool

vent({
  thought: string,
  trigger?: string
})

thought describes the failure, repeated workaround, and useful preventative fix.
trigger is an optional short label such as tool_error, bad_docs, or confusing_task.

The extension creates VENT.md when needed and appends each note under a local timestamp:

## 26-04-29 10:42 — tool_error

Symptom: a hook failed twice for the same generated artifact. Repeated workaround: deleted the artifact and reran the same command sequence. Suggested fix: add cleanup to the hook or document the generated-file lifecycle.