Skip to content

Conversation

@jongwony
Copy link

@jongwony jongwony commented Jan 29, 2026

Summary

Clipboard-20260129-135743-665

ClaudeTasks is a Spoon for viewing and managing Claude Code tasks directly from Hammerspoon.

Features

  • Task Viewer: Floating WebView displaying tasks from ~/.claude/tasks/
  • Session Management: Switch between Claude Code sessions, copy session IDs with click
  • Quick Actions:
    • Launch Claude in specific working directory with session resume (-r flag)
    • Quick task updates via TaskUpdate API
  • Auto-refresh: File watcher monitors task changes in real-time
  • Bidirectional Bridge: JavaScript-Lua communication for seamless interaction

Hotkeys

Key Action
opt+. Toggle task viewer
cmd+alt+T Show task status summary

Usage

hs.loadSpoon("ClaudeTasks")
spoon.ClaudeTasks:bindHotkeys({
    toggle = {{"alt"}, "."},
    status = {{"cmd", "alt"}, "T"}
})
spoon.ClaudeTasks:start()

Requirements

  • macOS with Hammerspoon installed
  • Claude Code CLI (claude) installed
  • Terminal app (Ghostty, iTerm2, or Terminal.app)

Metadata

Checklist

  • Spoon follows naming conventions (TitleCase)
  • init.lua contains required metadata (name, version, author, license)
  • Standard methods implemented (:start(), :stop(), :bindHotkeys())
  • No background work in init.lua load phase
  • docs.json included

jongwony and others added 2 commits January 29, 2026 22:38
Features:
- Floating WebView displaying tasks from ~/.claude/tasks/
- Session management with quick switching and ID copy
- Launch Claude in specific working directory with session resume (-r flag)
- Quick task updates via TaskUpdate API
- Auto-refresh via file watcher
- Bidirectional JavaScript-Lua bridge

Hotkeys: opt+. (toggle), cmd+alt+T (status)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant