A DDEV add-on that integrates the Decodie learning companion into your local development environment.
- DDEV v1.22+
ddev add-on get owenbush/decodie-ddev
ddev restart
ddev decodieThis installs everything you need:
- The Decodie UI (via npm)
- The Decodie commands for Claude Code (into
~/.claude/commands/decodie/)
The UI will be available at https://decodie.SITENAME.ddev.site (where SITENAME is your DDEV project name).
To start generating learning entries, run /decodie:observe in Claude Code at the start of your session. You can also run /decodie:analyze src/ to generate entries from existing code, or /decodie:ask "question" to query your entries.
ddev decodie # Open in your browser
ddev decodie status # Show entry statistics
ddev decodie cleanup # Open the archival review page
ddev decodie help # Show available commandsThe Q&A feature requires authentication with Claude. Edit .ddev/decodie/.env and set one of the following:
- On your host machine (not inside DDEV), run:
claude setup-token - Copy the token and add it to
.ddev/decodie/.env:CLAUDE_CODE_OAUTH_TOKEN=sk-ant-oat01-... ddev restart
- Get a key from console.anthropic.com
- Add it to
.ddev/decodie/.env:CLAUDE_API_KEY=sk-ant-... ddev restart
The add-on installs @owenbush/decodie-ui from npm and runs it as a daemon inside the DDEV web container. Traefik handles subdomain routing. No separate container is needed.
To update to the latest version of the UI:
ddev exec "cd /var/www/html/.ddev/decodie && npm update @owenbush/decodie-ui"
ddev restart- owenbush/decodie -- Main Decodie site
- owenbush/decodie-ui -- The learning companion UI
- owenbush/decodie-skill -- Claude Code commands for generating and analyzing learning entries
- owenbush/decodie-vscode -- VSCode extension with sidebar entry browser and right-click analysis. Install from Marketplace.
- owenbush/decodie-github-action -- GitHub Action for automatic PR analysis. View on Marketplace.
- owenbush/decodie-github-bot -- Interactive bot for on-demand analysis and explanations in PR comments.
- owenbush/decodie-core -- Shared data layer (types, parser, reference resolver)
