pi-quests

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.

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

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