About
Pebbles is an agent-first task tracking tool designed to optimize the workflow of AI coding agents. It helps agents manage and organize their work by allowing them to create, read, update, and query tasks, bugs, features, and epics as they operate on a codebase. Optimized for programmatic use with JSON input/output, Pebbles supports dependency management, tracks progress through a defined lifecycle, and stores all tasks as individual markdown files in a dedicated directory. It integrates seamlessly with platforms like Opencode via a plugin, but can be adapted for any coding agent capable of executing shell commands.
