cc-caffeine 0.2.0 → 0.3.0

package/CLAUDE.md

@@ -14,6 +14,7 @@ The system consists of a modular architecture with the following components:
 4. **src/server.js** - Handles server process management and Electron integration
 5. **src/system-tray.js** - Manages system tray functionality and sleep prevention
 6. **src/electron.js** - Wraps Electron-specific functionality and provides cross-platform support
+7. **src/config.js** - Reads user configuration from `~/.claude/plugins/cc-caffeine/config.json`
 
 ### User Commands
 
@@ -27,7 +28,7 @@ The system consists of a modular architecture with the following components:
 - Cross-platform support (Linux, macOS, Windows)
 - Headless Electron system tray (no windows, only system tray)
 - JSON file for session persistence with proper-lockfile for concurrency
-- Automatic session timeout (15 minutes of inactivity)
+- Configurable session timeout (default: 15 minutes of inactivity)
 - Auto-server startup when not running
 - Multiple concurrent session support
 - Real-time status monitoring
@@ -35,6 +36,24 @@ The system consists of a modular architecture with the following components:
 - Native sleep prevention using Electron's powerSaveBlocker API
 - Hidden from macOS dock using app.dock.hide()
 
+## Configuration
+
+User configuration is stored at `~/.claude/plugins/cc-caffeine/config.json`. All settings are optional and have sensible defaults.
+
+```json
+{
+  "session_timeout_minutes": 15,
+  "icon_theme": "orange"
+}
+```
+
+### Options
+
+| Setting | Default | Description |
+|---------|---------|-------------|
+| `session_timeout_minutes` | `15` | Minutes of inactivity before a session expires |
+| `icon_theme` | `"orange"` | Tray icon theme: `"orange"` (colored) or `"monochrome"` (black/white, auto-adapts to macOS dark mode) |
+
 ## Technical Stack
 
 - **Node.js 14+** - Runtime environment with modern JavaScript features
@@ -177,7 +196,7 @@ Sessions are removed automatically after 15 minutes of inactivity.
 
 ## Session Management
 
-- Sessions auto-expire after 15 minutes of inactivity
+- Sessions auto-expire after the configured timeout (default: 15 minutes of inactivity)
 - Automatic cleanup of expired sessions during every add/remove operation
 - Server polls JSON file every 10 seconds for active sessions (with file locking)
 - Multiple sessions can be active simultaneously
@@ -235,9 +254,11 @@ npm run format    # Format code with Prettier (if installed)
 The application uses CommonJS modules with clear dependency hierarchy:
 
 - `caffeine.js` imports from `src/commands.js` and `src/server.js`
-- `src/commands.js` imports from `src/session.js`
+- `src/commands.js` imports from `src/session.js` and `src/config.js`
 - `src/server.js` imports from `src/session.js`, `src/system-tray.js`, and `src/electron.js`
-- `src/system-tray.js` imports from `src/session.js` and `src/electron.js`
+- `src/system-tray.js` imports from `src/session.js`, `src/electron.js`, and `src/config.js`
+- `src/session.js` imports from `src/config.js`
+- `src/config.js` reads `~/.claude/plugins/cc-caffeine/config.json`
 - `src/electron.js` provides Electron functionality on-demand
 
 ## Sleep Prevention
@@ -258,13 +279,19 @@ src/
 └── server.js            - Server process management and Electron integration
 └── system-tray.js       - System tray functionality and sleep prevention
 └── electron.js          - Electron-specific functionality wrapper
+└── config.js            - User configuration reader
 package.json         - Node.js dependencies and scripts
 icon-coffee-full.png - Active caffeine icon (PNG)
 icon-coffee-empty.png- Inactive caffeine icon (PNG)
 icon-coffee-full.svg - Active caffeine icon (SVG)
 icon-coffee-empty.svg- Inactive caffeine icon (SVG)
+icon-coffee-full-mono.png - Active caffeine icon monochrome (PNG)
+icon-coffee-empty-mono.png- Inactive caffeine icon monochrome (PNG)
+icon-coffee-full-mono.svg - Active caffeine icon monochrome (SVG)
+icon-coffee-empty-mono.svg- Inactive caffeine icon monochrome (SVG)
 ~/.claude/plugins/cc-caffeine/
 └── sessions.json    - JSON file with session data
+└── config.json      - User configuration (optional)
 ```
 
 **Modular architecture benefits:**

package/README.md

@@ -15,6 +15,8 @@ Tired of your laptop going to sleep during that perfect coding session because y
 - 🚴‍♂️ Pedal to the coworking space while maintaining your active connection
 - 📱 Respond to your girlfriend calls during work hours, without Claude Code interruptions
 
+<img width="4032" height="1152" alt="image" src="https://github.com/user-attachments/assets/e1db7f4c-bd49-4ec5-8da4-2595c7f9b80a" />
+
 ## 🎯 Installation
 
 ```bash
@@ -22,6 +24,12 @@ Tired of your laptop going to sleep during that perfect coding session because y
 /plugin install cc-caffeine@samber
 ```
 
+*cc-caffine status*:
+
+![](./assets/icon-coffee-empty.png) - Claude Code is idle
+
+![](./assets/icon-coffee-full.png) - Claude Code is working hard
+
 ## 🌟 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."

package/assets/icon-coffee-empty-mono.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="#000000" 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="#000000" stroke-width="2" stroke-linejoin="miter"/>
+  <!-- Coffee residue - smaller with more margin -->
+  <line x1="10" y1="22" x2="22" y2="22" stroke="#000000" stroke-width="1" opacity="0.5"/>
+</svg>

package/assets/icon-coffee-full-mono.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="#000000"/>
+  <!-- Coffee liquid - smaller liquid with margin -->
+  <path d="M10 14 L10 18 L12 20 L20 20 L22 18 L22 14 Z"
+        fill="#333333"/>
+  <!-- Coffee handle - smaller handle with margin -->
+  <path d="M24 14 L28 14 L28 18 L24 18 Z"
+        fill="#000000"/>
+  <!-- Steam - simple flat lines with more margin -->
+  <line x1="12" y1="6" x2="12" y2="2" stroke="#000000" stroke-width="1" opacity="0.7"/>
+  <line x1="16" y1="6" x2="16" y2="2" stroke="#000000" stroke-width="1" opacity="0.7"/>
+  <line x1="20" y1="6" x2="20" y2="2" stroke="#000000" stroke-width="1" opacity="0.7"/>
+</svg>

package/caffeine.js

@@ -11,7 +11,13 @@ const fs = require('fs');
  * All functionality has been split into separate modules for better organization.
  */
 
-const { handleCaffeinate, handleUncaffeinate, handleStatus, handleVersion,  handleUsage } = require('./src/commands');
+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');
@@ -36,23 +42,23 @@ const main = async () => {
   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();
+    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();
   }
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-caffeine",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Prevents your computer from sleeping while Claude Code works hard",
   "main": "caffeine.js",
   "bin": {
@@ -35,11 +35,11 @@
   },
   "license": "MIT",
   "dependencies": {
-    "electron": "^38.2.2",
+    "electron": "^40.1.0",
     "proper-lockfile": "^4.1.2"
   },
   "devDependencies": {
-    "eslint": "^9.37.0",
+    "eslint": "^10.0.1",
     "prettier": "^3.6.2"
   },
   "engines": {
@@ -54,4 +54,4 @@
     "linux",
     "win32"
   ]
-}
+}

package/src/commands.js

@@ -7,9 +7,14 @@
 const path = require('path');
 const fs = require('fs');
 
-const { addSessionWithLock, removeSessionWithLock, getActiveSessionsWithLock } = require('./session');
+const {
+  addSessionWithLock,
+  removeSessionWithLock,
+  getActiveSessionsWithLock
+} = require('./session');
 const { isServerRunningWithLock } = require('./pid');
 const { runServerProcessIfNotStarted } = require('./server');
+const { getConfig } = require('./config');
 
 /**
  * Handle session commands with JSON input from Claude Code hooks
@@ -132,7 +137,9 @@ const handleStatus = async () => {
       });
     }
 
-    console.error('\nSession timeout: 15 minutes of inactivity');
+    console.error(
+      `\nSession timeout: ${getConfig().session_timeout_minutes} minutes of inactivity`
+    );
   } catch (error) {
     console.error('Error getting status:', error.message);
     process.exit(1);
@@ -150,7 +157,9 @@ const handleUsage = () => {
   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');
+  console.error(
+    '  version                   - Show version information from package.json and plugin.json'
+  );
   process.exit(1);
 };
 

package/src/config.js

@@ -0,0 +1,37 @@
+/**
+ * Config module - Reads user configuration from config.json
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const CONFIG_DIR = path.join(os.homedir(), '.claude', 'plugins', 'cc-caffeine');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+
+const DEFAULTS = {
+  session_timeout_minutes: 15,
+  icon_theme: 'orange' // 'orange' | 'monochrome'
+};
+
+let cachedConfig = null;
+
+const getConfig = () => {
+  if (cachedConfig) {
+    return cachedConfig;
+  }
+
+  let userConfig = {};
+  try {
+    if (fs.existsSync(CONFIG_FILE)) {
+      userConfig = JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf8'));
+    }
+  } catch (error) {
+    console.error('Warning: Failed to read config file, using defaults:', error.message);
+  }
+
+  cachedConfig = { ...DEFAULTS, ...userConfig };
+  return cachedConfig;
+};
+
+module.exports = { getConfig };

package/src/pid.js

@@ -18,7 +18,7 @@ const lockfile = require('proper-lockfile');
 const CONFIG_DIR = path.join(os.homedir(), '.claude', 'plugins', 'cc-caffeine');
 const PID_FILE = path.join(CONFIG_DIR, 'server.pid');
 
-const withPidLock = async (fn) => {
+const withPidLock = async fn => {
   // create if not exists
   try {
     const fd = fs.openSync(PID_FILE, 'wx');
@@ -138,8 +138,8 @@ const validatePid = async pid => {
     const isWindows = os.platform() === 'win32';
     const psCommand = isWindows
       ? spawn('wmic', ['process', 'where', `processid=${pid}`, 'get', 'commandline'], {
-        stdio: 'pipe'
-      })
+          stdio: 'pipe'
+        })
       : spawn('ps', ['-p', pid, '-o', 'command='], { stdio: 'pipe' });
 
     let output = '';
@@ -157,7 +157,8 @@ const validatePid = async pid => {
       const commandLine = output.trim().toLowerCase();
       for (const line of commandLine.split('\n')) {
         // Check if command line contains both "caffeine" and "server"
-        const isCaffeineServer = line.includes('caffeine server') || line.includes('caffeine.js server');
+        const isCaffeineServer =
+          line.includes('caffeine server') || line.includes('caffeine.js server');
         const isElectron = line.includes('electron');
 
         if (isCaffeineServer && isElectron) {

package/src/session.js

@@ -2,10 +2,11 @@ const fs = require('fs');
 const path = require('path');
 const os = require('os');
 const lockfile = require('proper-lockfile');
+const { getConfig } = require('./config');
 
 const CONFIG_DIR = path.join(os.homedir(), '.claude', 'plugins', 'cc-caffeine');
 const SESSIONS_FILE = path.join(CONFIG_DIR, 'sessions.json');
-const SESSION_TIMEOUT = 15 * 60 * 1000; // 15 minutes
+const getSessionTimeout = () => getConfig().session_timeout_minutes * 60 * 1000;
 const MAX_RETRIES = 10;
 
 const initSessionsFile = async () => {
@@ -66,7 +67,7 @@ const addSessionWithLock = async sessionId => {
       const lastActivity = new Date(sessionData.last_activity);
       const timeDiff = nowDate - lastActivity;
 
-      if (timeDiff >= SESSION_TIMEOUT) {
+      if (timeDiff >= getSessionTimeout()) {
         delete data.sessions[existingSessionId];
         removedCount++;
       }
@@ -124,7 +125,7 @@ const removeSessionWithLock = async sessionId => {
       const lastActivity = new Date(sessionData.last_activity);
       const timeDiff = nowDate - lastActivity;
 
-      if (timeDiff >= SESSION_TIMEOUT) {
+      if (timeDiff >= getSessionTimeout()) {
         delete data.sessions[existingSessionId];
         cleanedCount++;
       }
@@ -169,7 +170,7 @@ const getActiveSessionsWithLock = async () => {
       const lastActivity = new Date(sessionData.last_activity);
       const timeDiff = now - lastActivity;
 
-      if (timeDiff < SESSION_TIMEOUT) {
+      if (timeDiff < getSessionTimeout()) {
         activeSessions.push({
           id: sessionId,
           ...sessionData
@@ -200,7 +201,7 @@ const cleanupExpiredSessionsWithLock = async () => {
       const lastActivity = new Date(sessionData.last_activity);
       const timeDiff = now - lastActivity;
 
-      if (timeDiff >= SESSION_TIMEOUT) {
+      if (timeDiff >= getSessionTimeout()) {
         delete data.sessions[sessionId];
         removedCount++;
       }

package/src/system-tray.js

@@ -6,6 +6,7 @@ const path = require('path');
 
 const { getActiveSessionsWithLock, cleanupExpiredSessionsWithLock } = require('./session');
 const { getElectron } = require('./electron');
+const { getConfig } = require('./config');
 const { removePidFileWithLock } = require('./pid');
 const package = require('../package.json');
 
@@ -15,10 +16,19 @@ let trayState = null;
  * Create icon for system tray
  */
 const createIcon = isActive => {
-  const icon = isActive ? '../assets/icon-coffee-full.png' : '../assets/icon-coffee-empty.png';
+  const { icon_theme } = getConfig();
+  const isMono = icon_theme === 'monochrome';
+  const suffix = isMono ? '-mono' : '';
+  const icon = isActive
+    ? `../assets/icon-coffee-full${suffix}.png`
+    : `../assets/icon-coffee-empty${suffix}.png`;
   const iconPath = path.join(__dirname, icon);
   const { nativeImage } = getElectron();
-  return nativeImage.createFromPath(iconPath);
+  const image = nativeImage.createFromPath(iconPath);
+  if (isMono && process.platform === 'darwin') {
+    image.setTemplateImage(true);
+  }
+  return image;
 };
 
 /**
@@ -54,13 +64,13 @@ const createSystemTray = () => {
       {
         label: 'Github',
         click: () => {
-          getElectron().shell.openExternal('https://github.com/samber/cc-caffeine')
+          getElectron().shell.openExternal('https://github.com/samber/cc-caffeine');
         }
       },
       {
         label: '💖 Sponsor',
         click: () => {
-          getElectron().shell.openExternal('https://github.com/sponsors/samber')
+          getElectron().shell.openExternal('https://github.com/sponsors/samber');
         }
       },
       {