Skillget

ClaudePanel.spoon

skill
Security Audit
Pass
Health Pass
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 30 GitHub stars
Code Pass
  • Code scan — Scanned 3 files during light audit, no dangerous patterns found
Permissions Pass
  • Permissions — No dangerous permissions requested
Purpose
This is a Hammerspoon extension (Spoon) that provides a floating, customizable window to view, manage, and interact with Claude Code tasks directly from your desktop.

Security Assessment
The overall risk is Low. The tool acts as a local graphical interface for managing your tasks. Based on its configuration options and stated features, it does execute local shell commands—specifically to launch Claude Code sessions in your terminal application. However, it relies on standard system paths and does not make suspicious external network requests. The automated code scan checked 3 files and found no dangerous patterns, malicious code, or hardcoded secrets. Furthermore, it does not request any inherently dangerous system permissions.

Quality Assessment
The project is actively maintained, with its last push occurring today. It has earned 30 GitHub stars, indicating a baseline level of community trust and usage. The documentation is excellent, providing clear installation steps, feature demonstrations, and detailed keyboard customization guides. It is properly licensed under the standard MIT license, making it safe and open for anyone to use and modify.

Verdict
Safe to use. It is a well-documented, actively maintained local tool that simplifies interacting with Claude Code tasks.
SUMMARY

View and manage Claude Code tasks and memory in a floating Hammerspoon window with live updates.

README.md

ClaudePanel.spoon

Hammerspoon Spoon for viewing Claude Code tasks in a floating window.

Demo

Clipboard-20260129-135743-665

Features

  • Floating task viewer with WebView UI
  • Vim-like keyboard navigation (j/k or ↑/↓ to move, Space to view, Enter to launch)
  • Customizable key bindings - configure all keyboard shortcuts
  • Task deletion with keyboard shortcut (⌘⌫)
  • Task search/filtering with real-time results
  • Auto-refresh on file changes via pathwatcher
  • Session selector with datalist autocomplete
  • Quick TaskUpdate via dialog (⌘E)
  • Launch Claude session in terminal (▶ button)
  • Task detail view with metadata display
  • Keyboard shortcuts help popup (?)

Installation

Option 1: Clone and Symlink (Recommended for development)

git clone https://github.com/jongwony/ClaudePanel.spoon.git
ln -sf $(pwd)/ClaudePanel.spoon ~/.hammerspoon/Spoons/ClaudePanel.spoon

Option 2: Direct Download

Download and extract to ~/.hammerspoon/Spoons/ClaudePanel.spoon/

Usage

Add to your ~/.hammerspoon/init.lua:

hs.loadSpoon("ClaudePanel")
spoon.ClaudePanel:bindHotkeys(spoon.ClaudePanel.defaultHotkeys)
spoon.ClaudePanel:start()

Default Hotkeys

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

In-App Keyboard Shortcuts

Key Action
j / k / ↓ / ↑ Navigate tasks
Space View task detail
Enter Launch Claude session
⌘⌫ Delete selected task
/ Search mode
= Session input mode
Escape Return to navigation
? Show shortcuts help
⌘E Quick Task dialog
⌘Enter Create task

All keyboard shortcuts can be customized via bindShortcuts().

Custom Configuration

hs.loadSpoon("ClaudePanel")
spoon.ClaudePanel:configure({
    width = 500,
    height = 700,
    margin = 30,
    debugMode = true,
    -- Specify paths explicitly if auto-discovery fails
    claudePath = "/usr/local/bin/claude",
    terminalApp = "/Applications/iTerm.app/Contents/MacOS/iTerm2",
    shell = "/bin/bash",
})
spoon.ClaudePanel:bindHotkeys({
    toggle = {{"cmd", "shift"}, "t"},
    status = {{"cmd", "alt"}, "t"}
})
-- You can customize all in-app keyboard shortcuts
spoon.ClaudePanel:bindShortcuts({
    navigateDown = {modifiers = {}, keys = {'j', 'ㅓ', 'ArrowDown'}},
    navigateUp = {modifiers = {}, keys = {'k', 'ㅏ', 'ArrowUp'}},
    deleteTask = {modifiers = {'cmd'}, keys = {'Backspace'}},
    openTask = {modifiers = {}, keys = {' '}},
    launchTask = {modifiers = {}, keys = {'Enter'}},
})
spoon.ClaudePanel:start()

API

Methods

  • obj:init() - Initialize the Spoon (called automatically)
  • obj:start() - Start file watching and load saved state
  • obj:stop() - Stop file watching and cleanup
  • obj:show() - Show the task viewer
  • obj:hide() - Hide the task viewer
  • obj:toggle() - Toggle visibility
  • obj:refresh() - Manually refresh the task list
  • obj:setTaskListId(id) - Set the session ID filter
  • obj:createTask(subject) - Create a new task via Claude CLI
  • obj:quickTaskUpdate(prompt) - Run quick TaskUpdate via haiku model
  • obj:launchClaudeWithTaskList() - Launch Claude in terminal with current session
  • obj:launchClaudeWithCwd(sessionId, cwd) - Launch Claude with specific working directory
  • obj:launchClaudeWithSession(sessionId) - Launch Claude with session env var
  • obj:showTaskDetailWindow(subject, description, metadata) - Show task detail popup
  • obj:deleteTask(taskId, sessionId) - Delete a task by ID
  • obj:status() - Get current status info
  • obj:configure(options) - Update configuration
  • obj:bindHotkeys(mapping) - Bind hotkeys

Configuration Options

Option Default Description
width 420 Window width
height 580 Window height
margin 20 Screen edge margin
refreshDebounce 0.2 Debounce delay for file changes (seconds)
debugMode false Enable debug logging
taskListId $CLAUDE_CODE_TASK_LIST_ID Session ID filter
claudePath nil Path to claude CLI (auto-discovered if nil)
terminalApp nil Path to terminal app (auto-discovered if nil)
shell nil Shell to use (defaults to $SHELL or /bin/zsh)
keyBindings (see below) Customizable keyboard shortcuts (use bindShortcuts())

Requirements

  • Hammerspoon
  • Claude Code CLI (claude command)
  • A supported terminal app (Ghostty, iTerm2, or Terminal.app)

License

MIT License - see LICENSE

Reviews (0)

No results found