Add desktop shortcut creation for Tingly Box

[0x0079]

Summary

Adds a shortcut command that creates desktop and Start Menu shortcuts for launching Tingly Box, eliminating the need for users to remember and type startup commands. The implementation includes platform-specific shortcut creation for Windows (.lnk), macOS (.command), and Linux (.desktop), with automatic detection of the launch method (binary, npx, or npx-bundle).

Key Changes

• New shortcut command (internal/command/shortcut.go):

  • Creates desktop and/or Start Menu shortcuts across Windows, macOS, and Linux
  • Supports three launch targets: direct binary execution, npx, or npx-bundle
  • Auto-detection mode that prefers recorded launch source, falls back to npx cache detection, then binary
  • Platform-specific implementations:
    • Windows: PowerShell script generating .lnk files via WScript.Shell COM
    • macOS: Shell script files (.command) executable from Finder
    • Linux: freedesktop .desktop entry files
  • Proper shell quoting for POSIX and PowerShell contexts

• Launch source persistence:

  • Added LaunchSource field to global config (internal/server/config/config.go)
  • Added GetLaunchSource() and SetLaunchSource() methods to config and AppConfig
  • PersistLaunchSource() function records how the binary was invoked for future shortcut generation

• Global --source flag (cli/tingly-box/main.go):

  • New CLI flag to specify/record launch method (binary, npx, npx-bundle)
  • Automatically persisted to config for shortcut auto-detection

• NPX wrapper updates:

  • Both build/npx/tingly-box/bin.js and build/npx/tingly-box-bundle/bin.js now prepend --source flag to all invocations
  • Ensures npx-launched binaries record their launch method

• Comprehensive test coverage (internal/command/shortcut_test.go):

  • Tests for launch argument generation, desktop entry/script content
  • Tests for all three launch modes and auto-detection logic
  • Tests for npx cache detection and filename generation
  • Tests for shell and PowerShell quoting functions

Implementation Details

• The shortcut command respects --no-desktop and --no-menu flags to allow selective shortcut creation
• Custom shortcut names are supported via --name flag
• NPX-based shortcuts wrap commands in login shells to ensure node/npx are on PATH
• Windows shortcuts use ComSpec environment variable with fallback to cmd.exe
• Linux shortcuts only create desktop shortcuts if the Desktop directory exists
• All file operations include proper error handling and permission setting (0o755 for executables)

https://claude.ai/code/session_012yPdw9AGArrZBosAPa3M4i