Decodie - Your AI Learning Companion

How it works

You code

Write code with Claude Code as usual

Decodie observes

Documents decisions, patterns, and concepts

You learn

Follow lessons, track progress, and ask questions

See it in action

Lessons view showing topic-based lesson cards with progress indicators

Lessons view — topic-based lessons with progress tracking

Lesson detail showing ordered entries with sidebar outline

Lesson detail — ordered entries with sidebar outline

Entry detail with code snippet, explanation, and lesson navigation

Entry detail — code snippets, explanations, and lesson navigation

Entries list with filtering by level, topic, and type

Entries view — filter by level, topic, type, and lifecycle

Interactive Q&A panel with conversation context

Interactive Q&A — ask follow-up questions about any entry

Features

Automatic documentation

Learning entries are generated as the AI writes code. No extra steps needed.

Structured lessons

Entries are automatically grouped into topic-based lessons, sorted by difficulty. Create custom lessons with your own ordering and notes.

Progress tracking

Mark entries as learned and track your progress through each lesson with visual progress indicators.

Interactive Q&A

Highlight any text in an entry and ask follow-up questions. Conversations persist across sessions.

Content-based code references

References use function signatures, not line numbers, so they survive refactoring.

Smart filtering

Filter by experience level, topic, decision type, and lifecycle stage. Switch between lesson and entry views.

External doc links

Automatic links to php.net, MDN, Python docs, Drupal API, and framework docs.

Sequential navigation

Step through lessons entry by entry with next/previous controls. A sidebar outline shows your position and lets you jump to any entry.

DDEV integration

Serve the UI as a DDEV service at decodie.yoursite.ddev.site.

Repositories

decodie-skill

Claude Code skill that generates .decodie/ entries during coding sessions.

decodie-ui

Node.js presentation layer with lessons, progress tracking, browsing, filtering, and Q&A.

decodie-ddev

DDEV add-on that serves the UI at decodie.SITENAME.ddev.site.

Quick Start

# 1. Install the skill
mkdir -p ~/.claude/skills/decodie
git clone https://github.com/owenbush/decodie-skill.git /tmp/decodie-skill
cp /tmp/decodie-skill/SKILL.md ~/.claude/skills/decodie/
cp -r /tmp/decodie-skill/scripts/ ~/.claude/skills/decodie/scripts/

# 2. Code with Claude Code — entries appear in .decodie/

# 3. Browse your entries
git clone https://github.com/owenbush/decodie-ui.git
cd decodie-ui && npm install
npx tsx src/cli.ts serve --dir /path/to/your/project

# 4. Open http://localhost:8081