ClaudeTasks.spoon

View and manage Claude Code tasks in a floating Hammerspoon window with live updates. Ideal for operations teams using Hammerspoon for automation. Connects to Claude Code for task management.

[{"step":"Install the ClaudeTasks.spoon module in Hammerspoon. Add the following to your Hammerspoon init.lua: `local tasks = require(\"ClaudeTasks\") tasks.start()`","tip":"Ensure Hammerspoon has permission to access the clipboard and system APIs for task tracking."},{"step":"Customize the floating window position and refresh rate in the module settings. Example: `tasks.setup({ x = 100, y = 100, refresh_seconds = 30 })`","tip":"Use a position that doesn’t obstruct your primary workflow (e.g., top-right corner)."},{"step":"Trigger the window with a hotkey (e.g., `hs.hotkey.bind(\"cmd\", \"t\", tasks.toggle)`). Filter tasks by status or priority using the prompt template.","tip":"Combine with Hammerspoon’s `hs.task` for additional automation, like auto-closing completed tasks."},{"step":"For overdue or stuck tasks, click the task in the window to copy its ID to the clipboard. Use this in your terminal or IDE to take action.","tip":"Pair with Claude Code’s `task list` command for cross-referencing."},{"step":"Monitor the window during long-running tasks. The live updates help you stay aware of task progress without switching contexts.","tip":"Use the `tasks.log` feature to debug if tasks aren’t appearing correctly."}]