felipe-nr/english-tutor-claudinho
v0.2.0MIT
Corrects the English in every message you send to your coding agent, tracks recurring mistakes and reviews them with you. Tuned for Brazilian Portuguese speakers.
Changelog
All notable changes to this plugin are documented here. The format follows Keep a Changelog, and versions follow Semantic Versioning.
[0.2.0] - 2026-09-14
Added
- Storage privacy guard (
src/core/privacy.ts): before any correction is written, it rejects fragments that carry secrets, code, logs, file paths, URLs or whole-prompt-shaped text, at the boundary where hook and MCP input is still untrusted. - zod validation of every stored value: the fragments, the reason, the occurrence id and the client metadata, with the recorded
mistake_keyrequired to match its fragments. - A 350 token-equivalent budget for the session-start context, measured in UTF-8 bytes, fitting the briefing without splitting multi-byte characters.
Fixed
- Codex hook and MCP wiring: the legacy launcher roots a relative
cwdat the installed plugin directory instead of relying on unsupported placeholder expansion, so the MCP server initializes, and the hooks emit the event-specific JSON envelope Codex expects instead of plain text beginning with[.
[0.1.0] - 2026-09-13
Added
- Minimal Agent Plugins 1.0.0 manifest.
tutorCLI skeleton withhelpandversion.english-tutorAgent Skill with the correction protocol, the pt-BR mistake profile and the practice-log format.- MCP server (
mcp.json,tutor mcp) exposing therecord_corrections,get_briefing,get_report,set_preferencesandpurge_historytools, theenglish-tutor-on,english-reviewandenglish-reportprompts, and theenglish-tutor://protocol,english-tutor://profile/pt-BRandenglish-tutor://reportresources. - Portable core: append-only correction store with file locking and dedup, statistics, session briefing, Markdown report and preferences.
tutor report,tutor config,tutor purgeandtutor doctorcommands.- Trigger adapters for Claude Code and Codex (
tutor hook <client> <event>): session-start protocol injection, once-per-turn reminder, and end-of-turn capture of the corrections from the assistant's final message. - Kill switch (
ENGLISH_TUTOR_DISABLE=1), pause (paused_until) and per-project disable that silence every hook. A hook never breaks a session: internal errors exit 0 with empty output and are logged locally. - Claude Code hooks declared inline in the marketplace; the Codex legacy package with hooks generated into
adapters/codex/.