@gfgghgftgffg/rpiv-todo-lean

A lighter wrapper for @juicesharp/rpiv-todo: tasks and dependencies remain, with about 77% less tool text on the first call.

Packages

Package details

extension

Install @gfgghgftgffg/rpiv-todo-lean from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@gfgghgftgffg/rpiv-todo-lean
Package
@gfgghgftgffg/rpiv-todo-lean
Version
0.1.14
Published
Nov 10, 2026
Downloads
2,064/mo · 90/wk
Author
gfgghgftgffg
License
MIT
Types
extension
Size
44.4 KB
Dependencies
2 dependencies · 4 peers
Pi manifest JSON
{
  "extensions": [
    "./index.ts"
  ]
}

Security note

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

README

@gfgghgftgffg/rpiv-todo-lean

简体中文

Advantage

A lighter wrapper for @juicesharp/rpiv-todo. Tasks, dependencies, batch creation and /todos remain, with about 77% less tool text sent on the first call.

Features

  • The model sees one todo tool: create, update, list, get, delete, clear.
  • If action is omitted, a subject means create, and an id plus a mutable field means update. Anything else is reported by upstream.
  • Fields, validation, persistence and per-session isolation stay on the upstream engine. /todos stays available.

Source

The facade comes from kunkun9527/rpiv-todo-lean. The engine is juicesharp/rpiv-todo. This package follows upstream releases and does not copy the engine. Both are MIT; the original LICENSE is kept. It lives in amox-pi-extensions-lean.

Usage

Create one task. A subject alone is enough:

{ "subject": "Inspect the cache" }

Create several:

{ "action": "create", "tasks": [{ "subject": "Inspect" }, { "subject": "Test" }] }

Mark one finished. An id plus a field is an update:

{ "id": "1", "status": "completed" }

List, read, delete, or empty the list:

{ "action": "list" }
{ "action": "get", "id": "1" }
{ "action": "delete", "id": "1" }
{ "action": "clear" }

New tasks start as pending. For several steps, keep one task in_progress and set it to completed when that step is done. list hides deleted tasks. clear empties the list and starts ids over. A dependency is blockedBy. Other fields are in the upstream documentation.

Installation

This is a public npm package. Install without a version pin:

pi install npm:@gfgghgftgffg/rpiv-todo-lean
pi update --extensions

For a Git fallback, run from the repository checkout:

node scripts/install-extension.mjs rpiv-todo-lean

Update a local Git installation by pulling the checkout and rerunning its installer; pi update does not update local contents. Keep one installation source. To migrate, back up settings, remove only the exact old source shown by pi list, then install the npm source. Do not load another rpiv-todo wrapper alongside it.

Context footprint (character proxy)

Package Registered character proxy
@gfgghgftgffg/rpiv-todo-lean 277
@juicesharp/rpiv-todo 1222

Fixed ceil(characters / 4), not provider billing tokens.

Development

See the development and maintenance guide and MAINTENANCE.md for adaptation details.