_____ _             _
    / ____| |           | |
   | |    | | __ _ _ __ | | __
   | |    | |/ _` | '_ \| |/ /
   | |____| | (_| | | | |   <
    \_____|_|\__,_|_| |_|_|\_\

    The little robot in your terminal.

Clank

A Claude Code plugin for reminders, timers, notes, time tracking, and more — powered by macOS native notifications and sounds.

Named after the small but mighty robot from Ratchet & Clank who handles all the technical stuff while you do the heavy lifting.

Installation

From the marketplace (recommended)

Add the marketplace and install:

/plugin marketplace add machielvdw/clank
/plugin install clank@clank

Or use the interactive plugin browser:

/plugin

Then navigate to Discover to find and install Clank.

Choose an install scope

Scope	Who gets it	Command
User (default)	You, across all projects	/plugin install clank@clank
Project	Everyone on this repo	claude plugin install clank@clank --scope project
Local	Just you, just this project	claude plugin install clank@clank --scope local

From source (development)

Clone the repo and load it directly:

git clone https://github.com/machielvdw/clank.git
claude --plugin-dir ./clank

Skills

Skill	Command	Description
Remind	/clank:remind 15m check build	Set timed reminders with native notifications, sound, and text-to-speech
Pomodoro	/clank:pomodoro 25 5	Work/break focus cycles with dialog prompts
Note	/clank:note API rate limits at 100/min	Save quick persistent notes and snippets
Bookmark	/clank:bookmark debugging auth bug	Save session context (branch, files, description) to resume later
Track	/clank:track start auth feature	Start/stop time tracking per task
Standup	/clank:standup	Auto-generate standup summaries from git history and session data
Stats	/clank:stats	View session duration, tasks tracked, notes taken

Quick Commands

Command	Description
/clank:reminders	List all active reminders
/clank:notes	List all saved notes
/clank:bookmarks	List all session bookmarks

Hooks

• Session Start — checks for overdue or pending reminders and notifies you
• Session Stop — logs session duration to stats

Requirements

• macOS (uses osascript, afplay, and say for notifications, sounds, and text-to-speech)
• Claude Code CLI

Planned Features

• Break reminders — automatic nudges to stretch and rest your eyes after extended coding sessions
• Focus mode — toggle macOS Do Not Disturb and set a focus timer with start/end chimes
• Clipboard snippets — save and recall named code snippets to/from the system clipboard
• Quick open — open your current PR, repo page, or reveal files in Finder with a single command
• iMessage relay — send yourself (or a teammate) a message when a long task completes
• Calendar integration — create Apple Calendar events for deadlines and meetings directly from the CLI
• Apple Reminders sync — optionally push reminders to the native Reminders app so they sync to your phone
• Custom notification sounds — use your own sound files for different reminder types
• Weekly digest — auto-generated summary of your week's coding activity, time tracked, and git stats
• Multi-project support — scoped notes, bookmarks, and time tracking per project directory
• Linux support — notify-send and paplay fallbacks for Linux users