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