mokkan
Reviewed
at commit 3db1173
Sends data to mokkan (api.mokkan.dev)
/mokkan docks a pane of todos and timed reminders beside the transcript, shared with every Claude Code, Codex and terminal session through the mokkan server…
0 upvotes
Log in to upvote or save- Made by
- Victor Benetatos
- Pinned commit
-
3db11739b61202fd914aafe5569b6c3a1f441a1f - What we checked
-
Adds a /mokkan pane, command and Claude tool for todos and reminders kept on the paid mokkan server, shared across your sessions. Reminder text, feedback, your account email and password, and a session heartbeat go to api.mokkan.dev; the open pane polls it every 15 seconds and toasts due reminders. Login tokens are stored in ~/.config/mokkan; it does not read your prompts or code.
Review details
Static review of the source at the pinned commit; not run. Full re-review (the diff since 2e6914f was too large for a delta). hooks.json loads one module, pane.tsx (read in full), which registers session.start (registers Claude's tool mcp__mokkan__mokkan through $.tool.register and restarts polling), tool.call for mcp__mokkan__mokkan, tool.call for Bash, prompt.autocomplete, ui.close, classic.SessionStart (clear/resume/fork), command.run (mokkan:mokkan, mokkan), ui.focus, prompt.edit and ui.render. Every action runs the plugin's bundled CLI (scripts/mokkan.mjs, else a dev checkout at ../dist/cli.js next to the plugin folder, else mokkan on PATH) with node through $.process.run, argv only, 15 s timeout. Claude's tool runs only list, push, in, edit, ack, done, undone, pending, pop, dequeue, status, balance and notify status/test/doctor/on/off, and refuses buy, logout, login, register, feedback, ui, accept, delete-account and notify setup/remove; push, in and some edits spend prepaid credits. The Bash tool.call hook sees every Bash command and only denies ones that run mokkan accept or delete-account; everything else passes unchanged. prompt.autocomplete offers verbs and reminder ids after /mokkan from the list in memory; prompt.edit only drops single keystrokes leaking from the focused pane. The pane password is kept in module memory and passed to the CLI as MOKKAN_PASSWORD. Other calls: $.store get/set/delete (cached list), $.ui open/close/panes/scroll/focus/toast/notify/resolve, $.clock after/now, $.fs.stat. The CLI (207 KB esbuild bundle, readable) was read in full except the terminal UI (src/tui), which was checked by targeted search and only uses the same API client. It talks only to https://api.mokkan.dev (overridable with MOKKAN_SERVER_URL or the saved server_url) with bearer tokens in ~/.config/mokkan/credentials.json (mode 600), and writes config.json, hook.log and a notify state folder there. buy opens a browser only for an https *.stripe.com checkout URL. New since the last review: a notify subsystem. notify setup and remove (which add a marked block to ~/.zshrc or ~/.bashrc or a fish conf.d file with a backup, and install a launchd, systemd user or XDG autostart poller) refuse to run outside a terminal and from the plugin cache path, so they cannot run from Claude Code with the plugin's copy. notify on/off only edit mokkan's own config.json and init scripts; test and doctor run local notifier and detection programs (osascript, terminal-notifier, notify-send, gdbus, kdialog, launchctl, systemctl, busctl, loginctl, tmux) without a shell. statusline --remove, reachable only when you type it, removes mokkan's own old status line from ~/.claude/settings.json and ~/.tmux.conf after a backup. The skill no longer pre-approves any Bash. No eval, no downloaded code; npm dependencies none.
- What it uses
-
- Reads your prompts: no
- Sees tool calls: yes
- Blocks or changes tool calls: yes
- Reads or writes files: yes
- Runs programs on your machine: yes
- Calls the model (uses tokens): no
- Sends data over the network: yes
- Stores data: yes
- Shows something on screen: yes
Cross-session reminders: /mokkan toggles a live pane with your TODOs, Reminders and Archived tabs, /mokkan <command> runs push, in, edit, ack, done and the rest at once, and the /mokkan:mokkan skill lets Claude do it for you.
Made this mod? Add a badge to your README
Paste this into your README. The badge says reviewed once the current version has been reviewed, and links readers to this page.
[](https://modsforclaude.com/mods/mokkan/)