@crayonlu/qi-harness

Production omnibus Pi extension: plan/build, goal, subagents, MCP, ask/todo/btw, cleanup, slash categories, bash-bg, rewind, LSP, split diff.

Packages

Package details

extension

Install @crayonlu/qi-harness from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@crayonlu/qi-harness
Package
@crayonlu/qi-harness
Version
1.0.7
Published
Jul 25, 2026
Downloads
983/mo · 983/wk
Author
crayoooon
License
MIT
Types
extension
Size
58.5 KB
Dependencies
12 dependencies · 3 peers
Pi manifest JSON
{
  "extensions": [
    "./src/index.ts",
    "./node_modules/pi-mcp-adapter/index.ts",
    "./node_modules/@narumitw/pi-lsp/src/index.ts",
    "./node_modules/@narumitw/pi-plan-mode/src/index.ts",
    "./node_modules/@narumitw/pi-goal/src/index.ts",
    "./node_modules/@narumitw/pi-retry/src/index.ts",
    "./node_modules/@juicesharp/rpiv-ask-user-question/index.ts",
    "./node_modules/@juicesharp/rpiv-todo/index.ts",
    "./node_modules/@juicesharp/rpiv-btw/index.ts",
    "./node_modules/pi-subagents/index.ts",
    "./node_modules/@crayonlu/qi-cleanup/extensions/cleanup.ts",
    "./node_modules/@crayonlu/qi-bash-bg/src/index.ts",
    "./node_modules/@crayonlu/qi-rewind/src/index.ts"
  ]
}

Security note

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

README

@crayonlu/qi-harness

Production omnibus extension for Pi: one pi install, Claude Code–grade daily harness on the official Pi host.

pi install npm:@crayonlu/qi-harness
# restart Pi or /reload
/harness-setup
/harness-doctor

Security: Pi packages run with full system access. Review source before installing.

What you get

Area Capability
Modes /plan + /build (→ /plan implement), /goal, plan↔goal mutex (tool block + auto-pause)
Agents pi-subagents — blocking / background / parallel, model inherit
Tools MCP, ask-user, todo, /btw, LSP, bash-bg (process + /ps), /rewind, /cleanup, retry
UX Slash secondary menu: / → category → (prefix group) → command; +/- diff

Queue (Pi native — not reinvented)

  • Enter while busy → steer
  • Alt+Enter → follow-up
  • Esc → abort + restore queued messages
  • Alt+Up → pull queued text back to the editor

Not supported (by design): double/empty Enter flush (#11); Claude-style Esc “undo just-submitted prompt” (#12).

Commands

Command Role
/harness-setup Install narrative + freezes + doctor
/harness-doctor Conflicts, Pi version, expected commands (--force demotes hard fails)
/harness-mode Plan/goal mutex snapshot
/harness-diff <old> <new> Split (width>120) or stacked +/- diff
/build Runs /plan implement — exit plan and implement
/ps /ps:logs /ps:kill /ps:clear Background process UI
/cleanup Janitor for ~/.pi cruft (≠ /compact)
/goal /plan /btw /todos /rewind /mcp … From bundled Pin / owned packages

Monorepo packages

Package Role
@crayonlu/qi-harness Unique public install entry (bundles Pins + owned)
@crayonlu/qi-cleanup /cleanup
@crayonlu/qi-bash-bg Background process tool
@crayonlu/qi-rewind Checkpoints + /rewind

Develop

cd qi-harness
npm install --ignore-scripts
npm test
npm run typecheck
pi -e ./packages/qi-harness   # load from workspace (resolves workspace deps)

Docs

License

MIT