Codep is a JavaScript tool that automatically starts English spelling practice in a tmux pane when an AI agent (Claude Code / Kiro CLI / Codex / GAL) begins tasks, and returns focus when idle. It includes word lists, multiple modes, and a tab peek feature.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
Codep ⌨️ is a JavaScript-based utility that, during AI agent task execution, automatically launches English spelling practice in a tmux split and refocuses when tasks complete. It supports several AI agents (Claude Code / Kiro CLI / Codex / GAL) and provides features such as per-letter feedback, audible pronunciation, and a word library with chapters and multiple difficulty modes.
How it works
The workflow centers on AI state hooks:
- When AI starts work, the system activates the practice UI in a separate pane and switches focus.
- When AI becomes idle again, focus returns to the AI pane (once).
Index logic runs a periodic check (every 500ms) of a state file to determine busy vs idle, triggering UI activation or focus reassignment.
Getting started
Install command:
curl -fsSL https://raw.githubusercontent.com/zemul/codep/main/install.sh | bash
It clones the repository, configures AI Agent Hooks, and adds a codep alias. After installation, open a new terminal or run source ~/.zshrc, then:
codep # 启动
Manual installation:
git clone https://github.com/zemul/codep.git ~/codep
~/codep/codep.sh # 首次运行自动配置 hooks
Using it:
codep # 启动（自动检测 kiro-cli / claude / codex / gal）
codep --model sonnet # 带 AI agent 参数
Specifying agent:
codep -a kiro # 强制用 Kiro CLI
codep -a claude-code # 强制用 Claude Code
codep -a codex # 强制用 Codex
codep -a gal # 强制用 GAL
Recent releases
Latest release: v1.0.0 (2026-07-16) – Initial release
Traction
Stars: 20
依赖
- Node.js 16+
- tmux
- AI agent (Claude Code / Codex / Kiro / GAL)
Windows users should use WSL.