cc-caffeine 0.2.0

package/README.md

@@ -0,0 +1,185 @@
+# cc-caffeine ☕⚡
+
+**Transform your 9-to-5 into 9:30-to-4:30.** Arrive 30min later, leave 30min earlier, while getting the same work done because **Claude Code stays powered in your backpack while commuting.**
+
+Work smarter, not longer.
+
+## 🌍 The Modern Developer's Freedom
+
+Tired of your laptop going to sleep during that perfect coding session because you left your desk 10 minutes? Frustrated when Claude Code disconnects mid-commute because your computer decided it was "idle"?
+
+**cc-caffeine is your personal rebellion against screen timeout.** It keeps your machine awake so you can:
+
+- 🚇 Code on the RER between Paris and suburbs
+- ☕ Sip a latte at Starbucks during 3-hour debugging sessions
+- 🚴‍♂️ Pedal to the coworking space while maintaining your active connection
+- 📱 Respond to your girlfriend calls during work hours, without Claude Code interruptions
+
+## 🎯 Installation
+
+```bash
+/plugin marketplace add samber/cc
+/plugin install cc-caffeine@samber
+```
+
+## 🌟 The Nomad Developer Manifesto
+
+> "I'll never choose between coding and traveling again. With cc-caffeine, I can do both. My laptop will never sleep while I traverse cities in 5G, my Claude Code will stay connected in my backpack, and my productivity will soar. The future of mobile development is here, and it smells like coffee."
+
+## ✨ Why It's Pure Magic
+
+**Automatic Intelligence**: cc-caffeine knows when Claude Code is working and prevents your computer from sleeping. Period.
+
+**System Tray Chic**: A tiny ☕️ icon in your status bar to know instantly if you're protected.
+
+**Perfect Sessions**: Multiple simultaneous Claude Code sessions? No problem.
+
+**Zero Configuration**: Install, run, forget. It's like coffee, but for your computer.
+
+## 🎯 Use Cases That Will Change Your Life
+
+### ☕ **The Coffee Shop Marathon**
+- 3 hours of focus without ever losing your connection
+- No more waking your screen every 5 minutes
+- Baristas will recognize you as "the developer who never sleeps"
+- Your productivity increases proportionally to your caffeine consumption
+
+### 🏠 **Flexible Remote Work**
+- Transform your balcony into an outdoor office
+- Code from the terrace in fresh air
+- No more choosing between "work" and "enjoy the sunshine"
+- Your boss will think you're working 24/7 (that's an advantage, right?)
+
+## 🛠️ Technical Features (With Style)
+
+- **🎯 Session-Based Management**: Intelligently manages multiple simultaneous Claude Code sessions
+- **🔄 Auto-Cleanup**: Forget to disable - sessions automatically expire after 15 minutes without tool call or user input
+- **🚀 Headless**: Just an elegant discreet system tray icon
+- **⚡ Native Sleep Prevention**: Electron's power management - cross-platform sleep prevention
+- **🍎 Cross-Platform**: Works on macOS, Linux, and Windows (yes, even Windows!)
+
+## 🎭 Claude Code Integration
+
+Hooks will be configured automatically if you import the project as a Claude Code plugin.
+
+Otherwise, configure your Claude Code hooks for a seamless experience:
+
+```json
+{
+  "UserPromptSubmit": [
+    {
+      "hooks": [
+        {
+          "type": "command",
+          "command": "npx cc-caffeine caffeinate"
+        }
+      ]
+    }
+  ],
+  "PreToolUse": [
+    {
+      "hooks": [
+        {
+          "type": "command",
+          "command": "npx cc-caffeine caffeinate"
+        }
+      ]
+    }
+  ],
+  "PostToolUse": [
+    {
+      "hooks": [
+        {
+          "type": "command",
+          "command": "npx cc-caffeine caffeinate"
+        }
+      ]
+    }
+  ],
+  "Notification": [
+    {
+      "hooks": [
+        {
+          "type": "command",
+          "command": "npx cc-caffeine uncaffeinate"
+        }
+      ]
+    }
+  ],
+  "Stop": [
+    {
+      "hooks": [
+        {
+          "type": "command",
+          "command": "npx cc-caffeine uncaffeinate"
+        }
+      ]
+    }
+  ],
+  "SessionEnd": [
+    {
+      "hooks": [
+        {
+          "type": "command",
+          "command": "npx cc-caffeine uncaffeinate"
+        }
+      ]
+    }
+  ]
+}
+```
+
+## 💡 The Secret Sauce
+
+cc-caffeine uses an intelligent client-server approach:
+
+1. **Lightweight Client** (`caffeinate`/`uncaffeinate`) - No Electron loading, just fast JSON writes
+2. **System Server** (`server`) - Headless Electron app that monitors sessions and manages power
+3. **Communication** - JSON file with atomic locking for perfect coordination
+
+## 📋 Requirements
+
+- Node.js >= 14.0.0 (your coffee of choice)
+- Electron (included automatically, like sugar in your espresso)
+- A burning desire to code everywhere, all the time
+
+## 🚀 Run without Claude Code
+
+```bash
+# Start server + system tray
+# (optional - will be started automatically)
+npx cc-caffeine server
+
+claude -p 'Write 10 pages of "lorem ipsum"'
+
+npx cc-caffeine status
+```
+
+Manual switch:
+
+```bash
+# Activate caffeine for your coding session
+echo '{"session_id": "session-abcd"}' | npx cc-caffeine caffeinate
+
+# Your session is now protected!
+# Claude can keep working while you sip coffee
+
+# When you're done (or after 15 minutes of auto-cleanup)
+echo '{"session_id": "session-abcd"}' | npx cc-caffeine uncaffeinate
+```
+
+## 💫 Fuel the Revolution
+
+- ⭐️ **Star this repo** - Your star powers the caffeine engine!
+- ☕️ **Buy me a coffee** - I'll literally use it to build more features while drinking actual coffee
+- 🚀 **Sponsor the revolution** - Help me defeat screen timeouts worldwide!
+
+[![💖 GitHub Sponsors](https://img.shields.io/github/sponsors/samber?style=for-the-badge)](https://github.com/sponsors/samber)
+
+*Every sponsor gets a virtual high-five and the knowledge that somewhere, a developer is "coding" from a ski track because of you.* ✨
+
+**PS**: If you encounter bugs, remember that even the best coffee has some grounds sometimes. But most of the time, it works like thunder. ⚡☕
+
+## 📄 License
+
+MIT - Use it, modify it, share it. Like good coffee, it's meant to be shared.

package/assets/icon-coffee-empty.svg

@@ -0,0 +1,10 @@
+<svg width="32" height="32" viewBox="0 0 32 32" xmlns="http://www.w3.org/2000/svg">
+  <!-- Coffee cup outline - smaller cup with more margin -->
+  <path d="M8 10 L8 22 L10 24 L22 24 L24 22 L24 10 Z"
+        fill="none" stroke="#FF6B35" stroke-width="2" stroke-linejoin="miter"/>
+  <!-- Coffee handle - smaller handle with margin -->
+  <path d="M24 14 L28 14 L28 18 L24 18 Z"
+        fill="none" stroke="#FF6B35" stroke-width="2" stroke-linejoin="miter"/>
+  <!-- Coffee residue - smaller with more margin -->
+  <line x1="10" y1="22" x2="22" y2="22" stroke="#FF6B35" stroke-width="1" opacity="0.5"/>
+</svg>

package/assets/icon-coffee-full.svg

@@ -0,0 +1,15 @@
+<svg width="32" height="32" viewBox="0 0 32 32" xmlns="http://www.w3.org/2000/svg">
+  <!-- Coffee cup - smaller cup with more margin -->
+  <path d="M8 10 L8 22 L10 24 L22 24 L24 22 L24 10 Z"
+        fill="#FF6B35"/>
+  <!-- Coffee liquid - smaller liquid with margin -->
+  <path d="M10 14 L10 18 L12 20 L20 20 L22 18 L22 14 Z"
+        fill="#E55A2B"/>
+  <!-- Coffee handle - smaller handle with margin -->
+  <path d="M24 14 L28 14 L28 18 L24 18 Z"
+        fill="#FF6B35"/>
+  <!-- Steam - simple flat lines with more margin -->
+  <line x1="12" y1="6" x2="12" y2="2" stroke="#FF6B35" stroke-width="1" opacity="0.7"/>
+  <line x1="16" y1="6" x2="16" y2="2" stroke="#FF6B35" stroke-width="1" opacity="0.7"/>
+  <line x1="20" y1="6" x2="20" y2="2" stroke="#FF6B35" stroke-width="1" opacity="0.7"/>
+</svg>

package/caffeine.js

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+
+const path = require('path');
+const os = require('os');
+const fs = require('fs');
+
+/**
+ * Main entry point for CC-Caffeine application
+ *
+ * This file contains the main() function and orchestrates all modules.
+ * All functionality has been split into separate modules for better organization.
+ */
+
+const { handleCaffeinate, handleUncaffeinate, handleStatus, handleVersion,  handleUsage } = require('./src/commands');
+const { handleServer } = require('./src/server');
+
+const CONFIG_DIR = path.join(os.homedir(), '.claude', 'plugins', 'cc-caffeine');
+
+const ensureConfigDir = () => {
+  try {
+    fs.mkdirSync(CONFIG_DIR, { recursive: true });
+  } catch (error) {
+    if (error.code !== 'EEXIST') {
+      throw error;
+    }
+  }
+};
+
+/**
+ * Main application entry point
+ * Handles command routing and delegates to appropriate modules
+ */
+const main = async () => {
+  ensureConfigDir();
+
+  const command = process.argv[2];
+
+  switch (command) {
+  case 'caffeinate':
+    await handleCaffeinate();
+    break;
+  case 'uncaffeinate':
+    await handleUncaffeinate();
+    break;
+  case 'server':
+    await handleServer();
+    break;
+  case 'status':
+    await handleStatus();
+    break;
+  case 'version':
+    await handleVersion();
+    break;
+  default:
+    await handleUsage();
+  }
+};
+
+// Handle uncaught errors gracefully
+main().catch(error => {
+  console.error('Fatal error:', error);
+  process.exit(1);
+});

package/hooks/hooks.json

@@ -0,0 +1,67 @@
+{
+    "description": "Prevents your computer from sleeping while Claude Code works hard",
+    "hooks": {
+        "UserPromptSubmit": [
+            {
+                "hooks": [
+                    {
+                        "type": "command",
+                        "command": "npx cc-caffeine caffeinate"
+                    }
+                ]
+            }
+        ],
+        "PreToolUse": [
+            {
+                "matcher": "*",
+                "hooks": [
+                    {
+                        "type": "command",
+                        "command": "npx cc-caffeine caffeinate"
+                    }
+                ]
+            }
+        ],
+        "PostToolUse": [
+            {
+                "matcher": "*",
+                "hooks": [
+                    {
+                        "type": "command",
+                        "command": "npx cc-caffeine caffeinate"
+                    }
+                ]
+            }
+        ],
+        "Notification": [
+            {
+                "hooks": [
+                    {
+                        "type": "command",
+                        "command": "npx cc-caffeine uncaffeinate"
+                    }
+                ]
+            }
+        ],
+        "Stop": [
+            {
+                "hooks": [
+                    {
+                        "type": "command",
+                        "command": "npx cc-caffeine uncaffeinate"
+                    }
+                ]
+            }
+        ],
+        "SessionEnd": [
+            {
+                "hooks": [
+                    {
+                        "type": "command",
+                        "command": "npx cc-caffeine uncaffeinate"
+                    }
+                ]
+            }
+        ]
+    }
+}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "cc-caffeine",
+  "version": "0.2.0",
+  "description": "Prevents your computer from sleeping while Claude Code works hard",
+  "main": "caffeine.js",
+  "bin": {
+    "cc-caffeine": "./caffeine.js"
+  },
+  "scripts": {
+    "start": "npm run server",
+    "caffeinate": "node caffeine.js caffeinate",
+    "uncaffeinate": "node caffeine.js uncaffeinate",
+    "status": "node caffeine.js status",
+    "version": "node caffeine.js version",
+    "server": "npx electron caffeine.js server",
+    "lint": "eslint --fix *.js src/*.js || echo 'eslint not installed'",
+    "format": "prettier --write *.js src/*.js || echo 'prettier not installed'"
+  },
+  "keywords": [
+    "claude-code",
+    "claude-code-plugin",
+    "plugin",
+    "nap",
+    "sleep",
+    "sleep-prevention",
+    "caffeine",
+    "caffeinate",
+    "system-tray",
+    "electron"
+  ],
+  "author": {
+    "name": "Samuel Berthe",
+    "email": "hey@samuel-berthe.fr",
+    "url": "https://samuel-berthe.fr"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "electron": "^38.2.2",
+    "proper-lockfile": "^4.1.2"
+  },
+  "devDependencies": {
+    "eslint": "^9.37.0",
+    "prettier": "^3.6.2"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/samber/cc-caffeine.git"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ]
+}

package/src/commands.js

@@ -0,0 +1,168 @@
+#!/usr/bin/env node
+
+/**
+ * Commands module - Handles all command-line interface functionality
+ */
+
+const path = require('path');
+const fs = require('fs');
+
+const { addSessionWithLock, removeSessionWithLock, getActiveSessionsWithLock } = require('./session');
+const { isServerRunningWithLock } = require('./pid');
+const { runServerProcessIfNotStarted } = require('./server');
+
+/**
+ * Handle session commands with JSON input from Claude Code hooks
+ */
+const handleSessionCommand = async (action, sessionOperation) => {
+  try {
+    // Read session_id from stdin (Claude Code hook format)
+    let input = '';
+    process.stdin.setEncoding('utf8');
+
+    await new Promise((resolve, reject) => {
+      process.stdin.on('data', chunk => (input += chunk));
+      process.stdin.on('end', resolve);
+      process.stdin.on('error', reject);
+    });
+
+    const data = JSON.parse(input);
+    const sessionId = data.session_id;
+
+    if (!sessionId) {
+      console.error('Error: session_id required in JSON input');
+      process.exit(1);
+    }
+
+    // Execute the session operation
+    const result = await sessionOperation(sessionId);
+
+    // For caffeinate command, ensure server is running
+    if (action === 'caffeinate') {
+      await runServerProcessIfNotStarted();
+    }
+
+    console.error(
+      `${action === 'caffeinate' ? 'Enabled' : 'Disabled'} caffeine for session: ${sessionId}`
+    );
+
+    // Log cleanup results if any
+    if (result.cleaned_sessions > 0) {
+      console.error(`Cleaned up ${result.cleaned_sessions} expired sessions`);
+    }
+
+    return result;
+  } catch (error) {
+    console.error('Error:', error.message);
+    process.exit(1);
+  }
+};
+
+/**
+ * Handle caffeinate command
+ */
+const handleCaffeinate = () => {
+  return handleSessionCommand('caffeinate', addSessionWithLock);
+};
+
+/**
+ * Handle uncaffeinate command
+ */
+const handleUncaffeinate = () => {
+  return handleSessionCommand('uncaffeinate', removeSessionWithLock);
+};
+
+/**
+ * Handle version command - show version from package.json and plugin.json
+ */
+const handleVersion = () => {
+  try {
+    // Read package.json
+    const packagePath = path.join(__dirname, '..', 'package.json');
+    const packageData = JSON.parse(fs.readFileSync(packagePath, 'utf8'));
+    const packageVersion = packageData.version || 'unknown';
+
+    // Read plugin.json
+    const pluginPath = path.join(__dirname, '..', '.claude-plugin', 'plugin.json');
+    let pluginVersion = 'unknown';
+
+    try {
+      const pluginData = JSON.parse(fs.readFileSync(pluginPath, 'utf8'));
+      pluginVersion = pluginData.version || 'unknown';
+    } catch (error) {
+      pluginVersion = 'not found';
+    }
+
+    console.error('=== CC-Caffeine Version ===');
+    console.error(`Package version: ${packageVersion}`);
+    console.error(`Plugin version:  ${pluginVersion}`);
+
+    if (packageVersion !== pluginVersion && pluginVersion !== 'not found') {
+      console.error('⚠️  Warning: Package and plugin versions do not match!');
+    }
+  } catch (error) {
+    console.error('Error getting version:', error.message);
+    process.exit(1);
+  }
+};
+
+/**
+ * Handle status command - show current sessions and server status
+ */
+const handleStatus = async () => {
+  try {
+    const serverRunning = await isServerRunningWithLock();
+    const activeSessions = await getActiveSessionsWithLock();
+
+    console.error('=== CC-Caffeine Status ===');
+    console.error(`Server Status: ${serverRunning ? '✅ Running' : '❌ Stopped'}`);
+    console.error(`Active Sessions: ${activeSessions.length}`);
+
+    if (activeSessions.length > 0) {
+      console.error('\nActive Sessions:');
+      activeSessions.forEach((session, index) => {
+        const created = new Date(session.created_at).toLocaleString();
+        const lastActivity = new Date(session.last_activity).toLocaleString();
+        console.error(`  ${index + 1}. ${session.id}`);
+        console.error(`     Created: ${created}`);
+        console.error(`     Last Activity: ${lastActivity}`);
+        if (session.project_dir) {
+          console.error(`     Project: ${session.project_dir}`);
+        }
+      });
+    }
+
+    console.error('\nSession timeout: 15 minutes of inactivity');
+  } catch (error) {
+    console.error('Error getting status:', error.message);
+    process.exit(1);
+  }
+};
+
+/**
+ * Show usage help
+ */
+const handleUsage = () => {
+  console.error('Usage: npx electron caffeine.js [caffeinate|uncaffeinate|server|status|version]');
+  console.error('');
+  console.error('Commands:');
+  console.error('  caffeinate [session_id]   - Enable caffeine for current session');
+  console.error('  uncaffeinate [session_id] - Disable caffeine for current session');
+  console.error('  server                    - Start caffeine server with system tray');
+  console.error('  status                    - Show current status and active sessions');
+  console.error('  version                   - Show version information from package.json and plugin.json');
+  process.exit(1);
+};
+
+// Export command handlers and utilities
+module.exports = {
+  // Command handlers
+  handleCaffeinate,
+  handleUncaffeinate,
+  handleStatus,
+  handleVersion,
+  handleUsage,
+
+  // Session operations
+  handleSessionCommand
+};