- Claude calls a tool, not a shell. The plugin's mod registers
mcp__mokkan__mokkan(behind tool search) and the mokkan skill tells Claude to call it with the command and its arguments. The text reaches the CLI as argv, so quotes,$, backticks and$(…)in a reminder are kept as typed. The skill has no!line and noallowed-toolsrule any more. The tool refusesbuy,logout,login,register,feedback,ui,accept,delete-accountandnotify setup|remove|pollitself, whatever the model was told;/mokkan <command>still runs them when you type it. /mokkancompletes in the prompt box. After/mokkanit offers the commands; afteredit,ack,doneorundoneit offers the reminders that match what you typed (by text or id) and writes the id. It reads the list the pane already holds and starts no process.- Claude can't run
acceptordelete-accountthrough Bash either. The mod refuses a Bash command line that runsmokkan acceptormokkan delete-account(also by path or throughnpx @vicmpen/mokkan-cli), with the same message as the tool. - Background syncs are quiet. The pane's 15-second poll no longer flashes
syncing…on the bottom line; a sync you start, opening the pane, or an action still shows it. - Needs Claude Code 2.1.299 or later. The pane draws its bold text with
Text'sweightinstead of the deprecatedbold, which older Claude Code refuses (the pane isn't drawn). CI now tests the plugin on Claude Code 2.1.312, andtools/claude-code-typesis that version's snapshot.
- Notifications outside Claude Code.
mokkan notify setup, run in a terminal, shows scheduled reminders that have fired and are not acknowledged at your shell prompt and as desktop notifications. It looks at the system and asks before each step: a prompt hook for zsh, bash (3.2 too) or fish, and a background agent that checks every 60 seconds (launchd on macOS, a systemd user timer on Linux desktops, XDG autostart elsewhere; only the prompt hook on a machine without a desktop). It needs a stable install (npm i -g @vicmpen/mokkan-cli), not npx or the plugin's copy. - Read-only. Showing a reminder marks nothing delivered and sends no heartbeat, so its email still goes out until you
mokkan ackit. Plain pushes are never shown. Every open shell prints the reminders once, and again when the set changes. - Over SSH, opt-in. The prompt hook can also send a terminal escape (OSC 9, 777 or 99) so the terminal on your own computer shows a notification. It is off until you turn it on in setup or with
mokkan notify on osc; tmux needsallow-passthrough on. - Settings and switches.
~/.config/mokkan/config.jsonholdsshell,desktop,oscandinterval;mokkan notify on|off [shell|desktop|osc]flips them andMOKKAN_NOTIFY=0turns everything off.mokkan notify status,testanddoctorshow what is set up, send a test notification and print details for a bug report;mokkan notify removetakes it all out;mokkan shell init zsh|bash|fishprints the hook for dotfiles you manage yourself. mokkan logout, an expired session andmokkan delete-accountalso delete the reminder text kept for notifications.CONTRIBUTING.mdexplains how to add a shell, a desktop notifier or a background agent.- The pane raises a native notification too. When the open pane finds a timed reminder due, it still shows the 15-second toast, and on Claude Code 2.1.295 or later it also sends a notification through your Claude Code notification setting (
preferredNotifChannel: iTerm2, kitty, Ghostty or the terminal bell), so you see it with the terminal behind another window. With no channel set up for your terminal, or on an older Claude Code, you get only the toast. - The pane polls more gently. It syncs 15 seconds after the last sync lands, so a slow server never gets two polls at once, and after a failure it waits longer each time, up to 60 seconds; a good sync resets it. It writes the last list to the plugin's store only when the list changed (and every 10 minutes), not every 15 seconds. After Esc, typing in the prompt makes no calls for the pane. Its help (
h) says how to get notifications outside Claude Code, and so does the plugin's install section in the README. - CI checks the mod. It type-checks the pane and runs its tests with
claude plugin test, on a pinned Claude Code version. - No server change.
- Privacy policy. Every account accepts the policy at mokkan.dev/privacy.
mokkan registershows its summary before it sends the code and goes on only ony; without a terminal,register --startand--completeneed--accept-privacy <version>(the pane passes the version it showed). When a new version is published, a command run in a terminal shows the summary and asksy accept · n quit · d delete my account, then runs once more; without a terminal it prints how to accept and exits 4, a new exit code (fromsynctoo).mokkan watchstops with exit 4, the hooks log it at most hourly, andmokkan uishows the summary in place of the list (yaccept,nquit,ddelete). Needs a server withGET /privacyandPOST /privacy/accept. mokkan privacy [--json]prints the policy's version, link and summary, without a login.mokkan acceptasks on demand; without a terminal it needs--yes, and--version <v>accepts only that version.mokkan delete-accountdeletes the account and everything on it, in a terminal only. It says what goes (reminders, unspent credits; payment records are kept without your name), asks for the password and for the worddelete, then removescredentials.jsonandhook.logfrom~/.config/mokkan/. It works whether or not the current policy is accepted. Needs serverDELETE /me.- The
/mokkanskill,/mokkan-cliand the Codex skill never runacceptordelete-account; they send the user to a terminal.mokkan helpnames the policy anddelete-account.
- The pane syncs in one process.
mokkan sync [--source X] [--deliver]fetches the list, the history and the balance, sends a heartbeat and (with--deliver) delivers the due timed reminders over one connection. The pane makes this one call per refresh, where it used to start four or five processes. - The pane opens on the last list it saw. Each good sync is kept in the plugin's store, shared by every session, so the pane shows that list right away while it syncs. If the session starts offline, the pane keeps that list and its synced time instead of opening empty. Logging out clears it.
- No background work without the pane. The 15-second poll runs only while the pane is open. Keys typed in the prompt make no calls to the pane unless it has recently held the keyboard.
- The pane no longer opens by itself in fullscreen sessions.
/mokkanopens it. - An emptied edit is refused, not dropped. In the pane and
mokkan ui, saving an edit with no text now keeps the field open and says the text can’t be empty. Before, it closed the field silently. Cancelling still closes it.mokkan editalready refused it.
- Feedback.
fin the pane opens a feedback field (shift+enter for a new line) andmokkan feedback <text>sends it from a terminal or/mokkan feedback …. It is free, kept by the server and emailed to the developer (FEEDBACK_EMAIL), 10 an hour, up to 2000 characters. Needs a server withPOST /feedback. - Todos and reminders are capped at 200 characters. The server refuses longer text on push and edit (400, was 2000), counted in code points after trimming, and the CLI, the pane and
mokkan uirefuse it before sending. Existing longer items stay as they are until edited.
- The selected row shows all of its text. In the pane and
mokkan ui, the selected row wraps its whole text under the text column, above its history line; the other rows stay cut to one line. Inmokkan uithe list scrolls to keep the expanded row in view, and text taller than the list ends in….
/mokkantoggles the pane./mokkan-paneis gone./mokkanon its own opens the pane, or closes it when it is open;/mokkan push milk(any command) runs it and prints the output straight away, with no model turn. The menu lists it under the skill's full name,/mokkan:mokkan: the engine keeps the bare name for the skill, and the mod answers it. The user-level command frominstall.shis now/mokkan-cli(claude-command/mokkan-cli.md), so it no longer hides the plugin's/mokkan;install.shremoves its old~/.claude/commands/mokkan.mdlink./mokkan:mokkanstays as the skill Claude runs.- No more session hooks. The plugin's SessionStart and Stop hooks are gone: the pane polls every 15 seconds, toasts what comes due and tells the server a session is active, so nothing is put into the conversation any more.
- TODOs, Reminders and Archived. The pane and
mokkan uisplit the stack into a TODOs tab (no due time) and a Reminders tab (a due time), each with its own count and row numbers, and Done is renamed Archived (darchives, and reopens there). The view opens on Reminders while one is due.t,randwleave you on your tab and say where the item went. Inmokkan ui, only the due rows on the tab you are looking at count as shown.
- Stray keys stay out of the prompt. While the pane has the keyboard, a key it doesn't use does nothing; it used to leave the pane and land in Claude's prompt. ctrl/cmd combinations, pastes and typing after
Escreach the prompt as before.
- The pane and
mokkan uishare one layout. One stack and a done view replace the todo / reminders / done tabs (and Active / All / Done inmokkan ui). Todos (□) and reminders (◷ ● ○ ·) look different; reminder times always say their direction (in 40m,Wed 17:00,overdue 40m,2h ago); the selected row shows its history. Keys match across both:adone,kacknowledge,sswitch view (inmokkan ui,aused to acknowledge andk/jmoved the selection;Know acknowledges all). Pop and dequeue name the reminder they will remove. - The pane is more honest about its state. Errors show in every mode, including inside a field, and the typed text is kept. A running command blocks repeat presses (no more double pops). Every row can be reached. Going offline keeps the last list, marked as stale. The pane is drawn like
mokkan ui: the same header,Stack │ Doneviews, selected row marked by▸and bold, and key footer.
- A pane in Claude Code.
/mokkan-paneopens a live view of the stack inside Claude Code (docked beside the transcript in the fullscreen layout): tabs for todo, reminders and done, a pointer moved with the arrows or digits, Enter to mark done or reopen, one key per command, login and registration with a masked password. It is a mod: a hooks module the plugin ships next to its shell hooks. - The status line is gone.
mokkan statuslineno longer renders or configures anything. It stays for this release so that an earlier setup keeps working silently and can be undone:mokkan statusline --removetakes the 0.2.0 status line out of Claude Code'ssettings.jsonand~/.tmux.conf(backups first) and deletes the CLI copy in~/.local/share/mokkan/. The command disappears in the next release.
mokkan done <id…>andmokkan undone <id…>. Finish a reminder anywhere on the list (likepop, by id) and reopen a finished one at its old position; a reopened reminder with a due time comes back acknowledged and is never emailed again. Baremokkan donestill lists the history. Needs serverPOST /reminders/:id/done.
First public release.
- Distribution. Three ways to install:
- The Claude Code plugin, from this repository's marketplace (
/plugin marketplace add vicmpen/mokkan, then/plugin install mokkan@mokkan). The plugin ships its own single-file CLI. - The npm package
@vicmpen/mokkan-cli(installs themokkancommand). - The Codex skill in
codex/.
- The Claude Code plugin, from this repository's marketplace (
mokkan statuslinesets up the status line. It configures Claude Code'sstatusLineand a marked tmux block (Codex shows mokkan inside tmux), keeping backups. It leaves a tmux config with its ownstatus-rightor TPM alone unless--forceis given, and from Claude Code it sets up only Claude Code's status line unless--tmuxis given.--dry-runpreviews the changes and--removeundoes them. Rendering moved tomokkan statusline --render. Old configs are migrated.- Plugin.
/mokkan:mokkanis now a skill that runs the bundled CLI. The hooks prefer the bundle. The status line uses a stable copy of the CLI outside the plugin cache. - Credits. The CLI supports prepaid credits (
balance,buy, exit code 3 when credits run out) andmokkan edit. mokkan ui. A full-screen terminal view of the stack with keyboard actions (push, schedule, edit, acknowledge, pop, dequeue, buy) and a login screen. Reminders shown there count as delivered, like the hooks andmokkan watch.- MIT license.
Internal version: the CLI, the Claude Code hooks and /mokkan command, and the Codex skill.