@nikiforovall/pi-scratchpad

pi package for scratchpad — skills to drive the `scratch` CLI plus /scratch ui|export|stop commands for the read-only viewer.

Packages

Package details

extensionskill

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

npm repohome report
$ pi install npm:@nikiforovall/pi-scratchpad
Package
@nikiforovall/pi-scratchpad
Version
0.1.3
Published
Jun 12, 2026
Downloads
not available
Author
nikiforovall
License
MIT
Types
extension, skill
Size
35.2 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./extensions/scratch.ts"
  ],
  "skills": [
    "./skills/scratch",
    "./skills/planning-with-scratchpad"
  ]
}

Security note

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

README

@nikiforovall/pi-scratchpad

A pi package for scratchpad — organize agent knowledge into scratchpads (a folder + scratchpad.json manifest) with a read-only visual viewer.

It ships:

  • Skills — scratch (the CLI loop: new → write → add → ls → show) and planning-with-scratchpad (planning conventions on top). These teach the pi agent when and how to drive the CLI.
  • Commands — the bits a plain shell call can't do well:
    • /scratch ui [pad] [--browser] — open the viewer. The viewer is long-running, so it's launched detached. No pad → interactive picker; type a pad → tab-completion.
    • /scratch export [pad] [-o <file>] — write the standalone HTML and report the path. Same pad selection as ui.
    • /scratch stop — close viewers opened this session.

Requirements

The scratch CLI must be on your PATH (it runs on Bun):

bun add -g @nikiforovall/scratchpad

The commands and skills surface this hint if the CLI is missing.

Install

pi install npm:@nikiforovall/pi-scratchpad

Or, for local development, add the package directory to ~/.pi/agent/settings.json:

{ "packages": ["~\\dev\\scratchpad\\pi"] }