cli-lsp-client 1.2.0 → 1.4.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 cli-lsp-client
+Copyright (c) 2025 cli-lsp-client
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -5,8 +5,11 @@ CLI tool for getting LSP diagnostics. Uses a background daemon to keep LSP serve
 ## Features
 
 - Get diagnostics from LSP servers
+- Get hover information for symbols (functions, variables, types)
 - Background daemon for fast repeated requests
 - Built in Claude Code hook to provide feedback on file edit tool calls
+- Comprehensive daemon management (`list`, `stop-all` commands)
+- Multi-project support with isolated daemon instances per directory
 
 ## Supported Languages
 
@@ -40,10 +43,21 @@ Get instant diagnostic feedback for TypeScript, Python, Go, JSON, CSS, YAML, Bas
 
 Configure Claude Code to use the built-in hook command:
 
-```bash
+```json
 {
   "$schema": "https://json.schemastore.org/claude-code-settings.json",
   "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup|resume",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx -y cli-lsp-client warmup"
+          }
+        ]
+      }
+    ],
     "PostToolUse": [
       {
         "matcher": "Edit|MultiEdit|Write",
@@ -61,7 +75,8 @@ Configure Claude Code to use the built-in hook command:
 
 #### How It Works
 
-- Automatically runs diagnostics after each file edit
+- **SessionStart**: Automatically warms up LSP servers when Claude Code starts for faster initial diagnostics
+- **PostToolUse**: Runs diagnostics after each file edit (Edit, MultiEdit, Write tools)
 - Built-in file filtering for all supported languages (11 file types)
 - Shows errors, warnings, and hints inline
 - Graceful error handling - never breaks your editing experience
@@ -103,16 +118,63 @@ ERROR at line 5, column 20:
   Code: 2345
 ```
 
-### Other Commands
+### Get Hover Information
 
 ```bash
-# Check daemon status
+# Get hover info for a function
+npx cli-lsp-client hover src/main.ts myFunction
+
+# Get hover info for a variable or type
+npx cli-lsp-client hover app.py MyClass
+```
+
+```bash
+$ npx cli-lsp-client hover src/client.ts runCommand
+Location: src/client.ts:370:17
+```typescript
+export function runCommand(command: string, commandArgs: string[]): Promise<void>
+```
+```
+
+### Daemon Management
+
+```bash
+# Check daemon status and memory usage
 npx cli-lsp-client status
 
-# Stop daemon (it will auto-restart when needed)
+# List all running daemons across directories
+npx cli-lsp-client list
+
+# Stop current directory's daemon
 npx cli-lsp-client stop
+
+# Stop all daemons across all directories (useful after package updates)
+npx cli-lsp-client stop-all
+
+# Show version
+npx cli-lsp-client --version
+
+# Show help
+npx cli-lsp-client help
 ```
 
+The `list` command shows all running daemon instances with their working directories, PIDs, and status:
+
+```bash
+$ npx cli-lsp-client list
+
+Running Daemons:
+================
+Hash   | PID   | Status    | Working Directory             
+----------------------------------------------------------
+h0gx9u | 12345 | ● Running | /Users/user/project-a
+94yi9w | 12346 | ● Running | /Users/user/project-b
+
+2/2 daemon(s) running
+```
+
+Use `stop-all` when updating the CLI package to ensure all old daemon processes are terminated and fresh ones spawn with the updated code.
+
 ## Java Installation Guide
 
 Eclipse JDT Language Server requires Java 17+ and manual setup:
@@ -159,11 +221,33 @@ pacman -S jdtls
 
 For detailed setup instructions, see the [official Eclipse JDT.LS documentation](https://github.com/eclipse-jdtls/eclipse.jdt.ls).
 
+### Additional Commands
+
+```bash
+# Warm up LSP servers for current directory (faster subsequent requests)
+npx cli-lsp-client warmup
+
+# Warm up for specific directory
+npx cli-lsp-client warmup /path/to/project
+
+# View daemon logs
+npx cli-lsp-client logs
+```
+
 ## Examples
 
 ```bash
 # Check a specific file
 npx cli-lsp-client diagnostics src/main.ts
+
+# Get hover info for a symbol
+npx cli-lsp-client hover src/main.ts myFunction
+
+# List all daemon instances
+npx cli-lsp-client list
+
+# Stop all daemons after package update
+npx cli-lsp-client stop-all
 ```
 
 ## Development

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "cli-lsp-client",
-  "version": "1.2.0",
-  "description": "A Bun CLI daemon application",
+  "version": "1.4.0",
+  "description": "CLI tool for fast LSP diagnostics with background daemon and multi-project support",
   "type": "module",
   "main": "src/cli.ts",
+  "license": "MIT",
   "bin": {
     "cli-lsp-client": "cli-lsp-client"
   },

package/src/cli.ts

@@ -2,12 +2,14 @@
 
 import path from 'path';
 import { startDaemon } from './daemon.js';
-import { runCommand } from './client.js';
+import { runCommand, sendToExistingDaemon } from './client.js';
 import { formatDiagnosticsPlain } from './lsp/formatter.js';
 import type { Diagnostic } from './lsp/types.js';
 import { HELP_MESSAGE } from './constants.js';
+import { ensureDaemonRunning } from './utils.js';
+import packageJson from '../package.json' with { type: 'json' };
 
-export async function handleClaudeCodeHook(filePath: string): Promise<{ hasIssues: boolean; output: string }> {
+export async function handleClaudeCodeHook(filePath: string): Promise<{ hasIssues: boolean; output: string; daemonFailed?: boolean }> {
   // Check if file exists
   if (!await Bun.file(filePath).exists()) {
     return { hasIssues: false, output: '' };
@@ -33,7 +35,18 @@ export async function handleClaudeCodeHook(filePath: string): Promise<{ hasIssue
   
   // Get diagnostics (suppress errors to stdout)
   try {
-    const { sendToExistingDaemon } = await import('./client.js');
+    // Ensure daemon is running
+    const daemonStarted = await ensureDaemonRunning();
+    
+    if (!daemonStarted) {
+      // Failed to start daemon - return with flag so caller can handle
+      return { 
+        hasIssues: false, 
+        output: 'Failed to start LSP daemon. Please try running "cli-lsp-client stop" and retry.',
+        daemonFailed: true 
+      };
+    }
+    
     const result = await sendToExistingDaemon('diagnostics', [filePath]);
     
     // The diagnostics command returns an array of diagnostics
@@ -73,6 +86,12 @@ async function run(): Promise<void> {
     return;
   }
 
+  // Handle version command directly (no daemon needed)
+  if (command === 'version' || command === '--version' || command === '-v') {
+    console.log(packageJson.version);
+    return;
+  }
+
   // Handle claude-code-hook command directly (reads JSON from stdin)
   if (command === 'claude-code-hook') {
     try {
@@ -102,6 +121,11 @@ async function run(): Promise<void> {
       }
 
       const result = await handleClaudeCodeHook(filePath);
+      if (result.daemonFailed) {
+        // Daemon failed to start - exit with status 1 to show error to user
+        console.error(result.output);
+        process.exit(1);
+      }
       if (result.hasIssues) {
         console.error(result.output);
         process.exit(2);