{ "markdown": "

\n \n \n \"Dose\"\n \n

\n\n

Dose

\n\n

\n Pop a pill. Gain a power. Switch anytime.\n

\n\n

\n \"7\n \"MIT\n

\n\n---\n\nSeven colored pills. Each one changes how your AI agent approaches code.\n\nPop a red pill for raw performance. Pop blue for clean architecture. Green for\nbulletproof security. Yellow to ship fast. Purple for everything at once.\nGray (ponytail) for lazy senior dev wisdom. 🧠 Karpathy for thoughtful,\nsurgical, goal-driven execution.\n\nPop multiple pills at once — their rules combine. The effect is instant.\n\n## The pills\n\n| | Pill | Color | Focus | Your agent becomes... |\n|---|------|-------|-------|----------------------|\n| 🔴 | **Titan** | Red | Performance | An optimizer. Caches hot paths, parallelizes work, profiles before acting. |\n| 🔵 | **Sage** | Blue | Architecture | A designer. Patterns, clean code, maintainability, domain-driven thinking. |\n| 🟢 | **Warden** | Green | Security | A guardian. Validates every input, handles every error, never silent-fails. |\n| 🟡 | **Phantom** | Yellow | Minimal | A shipper. Deletes before adding. One line over fifty. **Default pill.** |\n| 🟣 | **Void** | Purple | Full spectrum | A strategist. Chooses the right pill for each part of the task automatically. |\n| 🦥 | **Ponytail** | Gray | Lazy senior dev | Deletes before writing. One line > fifty. The original senior dev. |\n| 🧠 | **Karpathy** | Purple | Think first | Systematic. Simplicity. Surgical changes. Goal-driven execution. |\n\n## How it works\n\nEach pill defines its own **ladder** — the sequence of rungs your agent stops\nat before writing code:\n\n```text\n1. Does this need to exist? (YAGNI)\n2. Does the standard library do it?\n3. Does a native platform feature cover it?\n4. (Pill-specific rung — varies by color)\n5. Write the minimum code that works for this pill.\n```\n\n### Titan ladder (red)\n\n```\n1. YAGNI 2. Stdlib 3. Native\n4. One line that performs? One line.\n5. Optimize: cache → SIMD → parallel → data-oriented\n6. Minimum performing code.\n```\n\n### Sage ladder (blue)\n\n```\n1. YAGNI 2. Stdlib 3. Native\n4. Well-known pattern fits? Apply it.\n5. One clean abstraction? One abstraction.\n6. Minimum maintainable code.\n```\n\n### Warden ladder (green)\n\n```\n1. YAGNI 2. Stdlib 3. Native\n4. Validate every input at trust boundaries.\n5. Handle every error path. No silent failures.\n6. Minimum secure code.\n```\n\n### Phantom ladder (yellow)\n\n```\n1. YAGNI extremist — skip it. 2. Stdlib, don't wrap.\n3. Native, don't configure. 4. One line? One line.\n5. Minimum code that ships.\n```\n\n### Void ladder (purple)\n\n```\nIntelligently selects the right pill per task:\n- Hot path → Titan\n- Architecture → Sage\n- Auth/payments → Warden\n- Boilerplate/CRUD → Phantom\n```\n\n## Multi-pill\n\nPop **multiple pills at once** — their ladders and rules combine:\n\n```\npop red → add Titan\npop blue → add Sage (now Titan + Sage active)\npop off red → remove Titan (only Sage remains)\nnormal mode → deactivate all pills\n/dose off titan → remove Titan via command\n/dose → show active pills\n```\n\n## Usage\n\n### Pop a pill\n\nIn any conversation with your AI agent:\n\n| You say | Effect |\n|---------|--------|\n| `pop red` or `/dose titan` | Add Titan pill |\n| `pop blue` or `/dose sage` | Add Sage pill |\n| `pop green` or `/dose warden` | Add Warden pill |\n| `pop yellow` or `/dose phantom` | Add Phantom pill |\n| `pop purple` or `/dose void` | Add Void pill |\n| `pop ponytail` or `/dose ponytail` | Add Ponytail pill |\n| `pop karpathy` or `/dose karpathy` | Add Karpathy pill |\n| `pop off red` or `/dose off titan` | Remove a specific pill |\n| `normal mode` or `/dose off` | Deactivate all pills |\n\n### Commands\n\n| Command | What it does |\n|---------|--------------|\n| `/dose [pill]` | Add a pill to active set |\n| `/dose off [pill]` | Remove a specific pill from active set |\n| `/dose off` | Deactivate all pills |\n| `/dose-status` | Show which pills are active |\n| `/dose-review` | Review the current diff for unnecessary complexity |\n| `/dose-audit` | Audit the whole repo for bloat |\n| `/dose-debt` | Harvest `dose:` shortcuts into a debt ledger |\n| `/dose-help` | Quick-reference card |\n| `/dose-create` | Create a custom pill — tell the AI what you want |\n| `/dose-manage` | Edit, delete, disable, enable custom pills |\n\n### Built-in custom pills\n\nDose ships with these custom pills pre-installed:\n\n| 🦥 | **Ponytail** | Lazy senior dev. The original philosophy Dose was forked from. |\n| 🧠 | **Karpathy** | Andrej Karpathy's 4 principles: Think before coding, simplicity, surgical changes, goal-driven. |\n| 🔵 | **Cobalt** | Resilience. Recovery. Graceful degradation. |\n\n### Create your own\n\nWant a pill that Dose doesn't have? Just say:\n\n> \"create a pill called **onyx** that focuses on **deep focus** — no distractions, single-task, block out everything else\"\n\nThe `/dose-create` skill will:\n1. Ask for the pill's color, emoji, ladder, and rules\n2. Generate the skill file, register it in `pills.json`, and update `AGENTS.md`\n3. Make it immediately available via `/dose `\n\nYou can also create pills from the command line:\n\n```bash\nnode scripts/generate-pill.js --name onyx --emoji ⚫ --color black --focus \"Deep focus. Single task. Zero distraction.\"\n```\n\n### Managing custom pills\n\nFull CRUD from the command line:\n\n```bash\n# List all custom pills\nnode scripts/manage-pill.js list\n\n# Edit a pill's emoji, color, or focus\nnode scripts/manage-pill.js edit --name cobalt --emoji 🟦 --focus \"New focus\"\n\n# Disable a pill (keeps files, hides from valid modes)\nnode scripts/manage-pill.js disable --name storm\n\n# Re-enable a disabled pill\nnode scripts/manage-pill.js enable --name storm\n\n# Delete a pill permanently\nnode scripts/manage-pill.js delete --name storm --yes\n```\n\nOr just tell the AI: `/dose-manage` and describe what you want.\n\n### Deactivate\n\nSay \"normal mode\" or `/dose off`.\n\n### Configure default pill\n\n```bash\nexport PRISM_DEFAULT_MODE=sage\n```\n\nOr in `~/.config/dose/config.json` (`%APPDATA%\\dose\\config.json` on Windows):\n\n```json\n{ \"defaultMode\": \"titan\" }\n```\n\nDefault is `phantom`.\n\n## Install\n\n### Claude Code\n\n```\n/plugin marketplace add /dose\n/plugin install dose@dose\n```\n\n### Codex\n\n```bash\ncodex plugin marketplace add /dose\ncodex\n```\n\nOpen `/plugins`, select Dose, install. Then open `/hooks`, review and trust\nits lifecycle hooks.\n\n### Pi agent harness\n\n```\npi install git:github.com//dose\n```\n\n### OpenCode\n\nAdd to `opencode.json`:\n\n```json\n{ \"plugin\": [\"./.opencode/plugins/dose.mjs\"] }\n```\n\n### Cursor / Windsurf / Cline\n\nCopy the matching rules file from this repo:\n- `.cursor/rules/dose.mdc` → your `.cursor/rules/`\n- `.windsurf/rules/dose.md` → your `.windsurf/rules/`\n- `.clinerules/dose.md` → your `.clinerules/`\n\n### GitHub Copilot\n\nCopy `AGENTS.md` and `.github/copilot-instructions.md` to your project root.\n\n### Other agents\n\n| Agent | File |\n|-------|------|\n| Kiro | `.kiro/steering/dose.md` |\n| Gemini CLI | `gemini-extension.json` |\n| OpenClaw | `.openclaw/skills/dose/` |\n\n## Development\n\n```bash\nnpm install\nnode scripts/check-rule-copies.js\nnpm test\n```\n\nWhen changing skill files, run `node scripts/build-openclaw-skills.js` to sync\nOpenClaw copies.\n\n## Why \"Dose\"?\n\nA dose splits white light into five colors. Each color is a different power.\nEach pill is a different way of writing code. Same light, different\nwavelengths. Same developer, different modes.\n\n---\n\n*Forked from [Ponytail](https://github.com/DietrichGebert/ponytail). The lazy\nsenior dev who inspired this took early retirement. His pills live on.*\n", "bytes": 8142, "sha": "c72dbf0f28d4e0545f5f3e69b602a87e18e68e67d82ab0ef2fab723a8bf6ad02", "repo_slug": "jonusnattapong/pills", "fonte": "repo", "truncated": false, "api": "https://agentalog.com/api/listings/plg_jonusnattapong_pills_a46c2e70/readme" }