Skip to content
Pillbox

Usage

Pillbox works through two layers: the agent skill, which runs automatically in every session, and SDD commands, which let you drive structured development workflows from the chat.

Prerequisites

Section titled “Prerequisites”

How the agent uses Pillbox

Section titled “How the agent uses Pillbox”

Once the MCP server is connected and the Pillbox skill is installed, the agent handles memory automatically:

  • At the start of a session it reads recent context via bottle_context and prescription_context.
  • While working, it saves pills for decisions, discoveries, and any non-obvious choices.
  • At the end of a session it saves a summary capsule.

You do not need to prompt the agent to save anything — the skill defines the workflow.

SDD commands

Section titled “SDD commands”

The SDD skill and its commands let you drive full development cycles from chat. Each command triggers a multi-phase workflow coordinated by the sdd skill and its sub-agents.

CommandWhat it does
/sdd:new <change name>Starts a new SDD cycle: exploration, one round of questions, decision and task plan
/sdd:continue [name]Runs or resumes the implementation batch by batch, then verifies and closes
/sdd:status [name]Shows the current phase and open prescriptions
/sdd:explore <topic>Runs an exploration pass without starting a full cycle
/sdd:fix <bug description>Focused fix for a bounded bug — the small tier of the cycle
/sdd:initPrepares the project for SDD — creates the bottle if missing and saves the project config

Review what your agent saved

Section titled “Review what your agent saved”

Start the web UI to browse pills, capsules, and prescriptions:

Terminal window
pillbox serve start

Then open http://pillbox.local:4242 in your browser.

Use it to spot entries that are redundant, wrong, or poorly written and correct them. The agent handles all writes during normal work.

Next steps

Section titled “Next steps”