lucianfialho

Periquito — Development skill for Claude Code

Development community

A macOS notch parrot that helps you learn English while coding with Claude Code.

How to install Periquito

This entry records only its repository, not the path inside it, so there is no exact command to give. Open lucianfialho/periquito and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Periquito does

A macOS notch parrot that helps you learn English while coding with Claude Code.

Alternatives in Development

Learn Coding Agent — Research on Coding Agents 12.2k ★
Notchi — notch app for claude code & codex 1k ★
Herdrm — Native macOS console for herdr — all your coding agents and their live terminals, across devices 635 ★

README

Periquito

A macOS notch companion that helps you learn English while you code with Claude Code.

A Tamagotchi-style parrot that lives in your MacBook notch, analyzes your English in real-time, and teaches you through spaced repetition — without breaking your flow.

https://github.com/lucianfialho/periquito/releases/download/v1.1.0/export-kk.mp4

What it does

Analyzes your English in every Claude Code prompt via AI
Corrections in real-time — shows what was wrong and why, right in the notch panel
Spaced repetition quiz — periodically asks you to review your own past mistakes
Progress tracking — accuracy %, streak, level system (Egg → Chick → Macaw → Phoenix)
Parrot reacts emotionally — happy when you write well, sad when you keep making the same mistakes
Compact mode — collapse to a stats bar showing accuracy + thumbs up/down counts

Requirements

macOS 15.0+ (Sequoia)
MacBook with notch
Claude Code installed

Install

Clone the repo and open periquito-app/periquito.xcodeproj in Xcode
Build and run (⌘R)
On first launch, open Settings and click Install Hooks to register the Claude Code hook
Start using Claude Code in English — Periquito will analyze each prompt automatically

How it works

Claude Code prompt → UserPromptSubmit hook → Unix socket → EmotionAnalyzer (claude -p)
       ↓
  JSON: { type, tip, category }
       ↓
  history.jsonl + SpacedRepetitionManager + SwiftUI notch panel

When you type a prompt in Claude Code, a shell hook intercepts it and sends it to a background worker. The worker calls `claude -p` to analyze the English, logs the result to `~/.english-learning/history.jsonl`, and the app displays a correction (or praise) in the notch panel.

The spaced repetition system (Leitner boxes 1–5) tracks your mistakes and resurfaces them for review when you're idle — pulling distractors from your own correction history so quizzes are relevant to y