What is this?
'learn' is a personal AI learning system built by the author for the 'pi' agent tool - it packages a teaching philosophy, a visualization skill, quiz/question extensions, and research subagents into a '.pi' configuration that turns pi into a tutor.
'learn' is a personal AI learning system built by the author for the 'pi' agent tool - it packages a teaching philosophy, a visualization skill, quiz/question extensions, and research subagents into a '.pi' configuration that turns pi into a tutor.Is this a standalone app or a configuration I add to pi?It's not an app - it's a '.pi directory' containing skills, extensions, and agent definitions meant to be dropped into an existing pi-based project.
It's not an app - it's a '.pi directory' containing skills, extensions, and agent definitions meant to be dropped into an existing pi-based project.How do I add it to my learning project?Copy this repo into your project's root as the .pi directory (or copy just the pieces you want into your existing pi config), then open pi in that directory.
Copy this repo into your project's root as the .pi directory (or copy just the pieces you want into your existing pi config), then open pi in that directory.What do I need besides pi itself?You need a subagent implementation so pi can spawn the researcher and visual-maker agents - the author recommends 'pi-interactive-subagents' (tmux-only) since everything works out of the box with it, plus the bundled ask-user-question extension for popups.
You need a subagent implementation so pi can spawn the researcher and visual-maker agents - the author recommends 'pi-interactive-subagents' (tmux-only) since everything works out of the box with it, plus the bundled ask-user-question extension for popups.Will it work with any subagent setup, or just the recommended one?Other implementations work too, but expect to adapt the agent definitions - e.g. agents/researcher.md lists 'safebash' in its tools, which is specific to pi-interactive-subagents, and popups only serialize correctly across the same ask-user-question implementation.
Other implementations work too, but expect to adapt the agent definitions - e.g. agents/researcher.md lists 'safebash' in its tools, which is specific to pi-interactive-subagents, and popups only serialize correctly across the same ask-user-question implementation.Who is this teaching style built for?It's a personal system written for the author's own way of learning - you're expected to edit the teach skill to match how you learn.
It's a personal system written for the author's own way of learning - you're expected to edit the teach skill to match how you learn.What do the quiz and md-log extensions add?Quiz turns a lesson into graded questions with instant checkmark/cross feedback, the correct answer, and an explanation; md-log links a markdown file to the session so you can keep running notes.
Quiz turns a lesson into graded questions with instant checkmark/cross feedback, the correct answer, and an explanation; md-log links a markdown file to the session so you can keep running notes.What happens if I skip the subagent setup entirely?The main session still teaches you directly, but you lose the researcher subagent's truth verification and the generated diagrams/SVGs.
The main session still teaches you directly, but you lose the researcher subagent's truth verification and the generated diagrams/SVGs.What do the researcher, svg-maker, and mermaid-maker agents do?They are the subagents the system delegates to: researcher verifies facts, while svg-maker and mermaid-maker generate the diagrams used by the visualize skill.
They are the subagents the system delegates to: researcher verifies facts, while svg-maker and mermaid-maker generate the diagrams used by the visualize skill.Is the visualize skill always adding pictures?No, it only adds a diagram when an idea is genuinely clearer as a picture, aiming for a correct and minimal visual rather than decoration.
No, it only adds a diagram when an idea is genuinely clearer as a picture, aiming for a correct and minimal visual rather than decoration.What are similar projects?pi-pocket, baoyu-skills, foreman, dg-ai-notes, pi-optchat, pi-harness, claude-howto, mistral-vibe
pi-pocket, baoyu-skills, foreman, dg-ai-notes, pi-optchat, pi-harness, claude-howto, mistral-vibeWhich topics is it in?quiz, pi-agent, personal-ai, diagram, pi-coding-agent, tmux, subagents, svg, skills, customization, agents, coding-agent
quiz, pi-agent, personal-ai, diagram, pi-coding-agent, tmux, subagents, svg, skills, customization, agents, coding-agent