pi-quests

A quest-log for your pi. Keep your agent on track, one quest at a time.

Package details

← Back
extension

Install pi-quests from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-quests
Package
pi-quests
Version
0.7.0
Published
Apr 26, 2026
Downloads
1,462/mo · 221/wk
Author
kalindudc
License
MIT
Types
extension
Size
108 KB
Dependencies
0 dependencies · 4 peers
Pi manifest JSON
{
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

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

README

pi-quests

version 0.7.0 MIT license pi extension

A quest-log for your pi. Keep your agent on track, one quest at a time.

Why pi-quests?

Long agent sessions drift. Goals get lost in tool calls, side quests multiply, and the original task is forgotten under a pile of yak hair.

Quests log in action

pi-quests gives your agent a persistent quest log — a living TODO list for the current session. Each quest is a checkpoint the agent can create, complete, and optionally roll back to if things go sideways.

  • Stay focused — the quest log keeps the original goal visible no matter how deep the rabbit hole goes
  • Checkpoint progress — mark milestones as quests and capture lightweight session snapshots (WIP)
  • Rollback safety — revert to a previous quest snapshot when exploration goes off track (WIP)
  • Session-scoped — quests live with the session, vanish when you start fresh

Install

pi install npm:pi-quests

Quick start

/quests help

Available /quests subcommands:
  add <description>  - Add a new quest
  list               - List all quests
  toggle <id>        - Toggle quest completion
  delete <id>        - Delete a quest
  update <id> <desc> - Update a quest description
  revert             - Revert the last quest change
  clear              - Clear all quests
  version            - Show version
  changelog          - Show changelog
  h, help            - Show this help message

Quests toggle Quests view

Configuration

pi-quests reads configuration from pi's settings files. Global settings live at ~/.pi/agent/settings.json and project overrides go in .pi/settings.json.

{
  "pi-quests": {
    "ids": { "length": 2 },
    "display": {
      "pageSize": 10,
      "progressBarMaxWidth": 24
    }
  }
}

See docs/configuration.md for the full options reference.

Documentation

Doc Description
Pattern "How do I...?" recipes for common workflows
Quests What are quests?
Reference Complete tool and command schemas, types
Configuration Settings, overrides, and examples
Architecture Module map, data flow diagrams, design decisions
Changelog Version history

License

MIT — see LICENSE.md