cli-lsp-client 1.3.0 → 1.5.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,6 +5,7 @@ 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)
@@ -52,7 +53,7 @@ Configure Claude Code to use the built-in hook command:
         "hooks": [
           {
             "type": "command",
-            "command": "npx -y cli-lsp-client warmup"
+            "command": "npx -y cli-lsp-client start"
           }
         ]
       }
@@ -74,7 +75,7 @@ Configure Claude Code to use the built-in hook command:
 
 #### How It Works
 
-- **SessionStart**: Automatically warms up LSP servers when Claude Code starts for faster initial diagnostics
+- **SessionStart**: Automatically starts 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
@@ -117,10 +118,28 @@ ERROR at line 5, column 20:
   Code: 2345
 ```
 
+### Get Hover Information
+
+```bash
+# 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
+# Check daemon status with uptime and running language servers
 npx cli-lsp-client status
 
 # List all running daemons across directories
@@ -139,6 +158,22 @@ npx cli-lsp-client --version
 npx cli-lsp-client help
 ```
 
+The `status` command shows the current daemon's uptime and running language servers:
+
+```bash
+$ npx cli-lsp-client status
+LSP Daemon Status
+================
+PID: 33502
+Uptime: 1m 38s
+
+Language Servers:
+- typescript (.) - running 1m 33s
+- pyright (.) - running 1m 10s
+
+Total: 2 language servers running
+```
+
 The `list` command shows all running daemon instances with their working directories, PIDs, and status:
 
 ```bash
@@ -205,11 +240,11 @@ For detailed setup instructions, see the [official Eclipse JDT.LS documentation]
 ### Additional Commands
 
 ```bash
-# Warm up LSP servers for current directory (faster subsequent requests)
-npx cli-lsp-client warmup
+# Start LSP servers for current directory (faster subsequent requests)
+npx cli-lsp-client start
 
-# Warm up for specific directory
-npx cli-lsp-client warmup /path/to/project
+# Start servers for specific directory
+npx cli-lsp-client start /path/to/project
 
 # View daemon logs
 npx cli-lsp-client logs
@@ -221,6 +256,9 @@ npx cli-lsp-client logs
 # 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
 

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "cli-lsp-client",
-  "version": "1.3.0",
-  "description": "A Bun CLI daemon application",
+  "version": "1.5.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,13 +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: '' };
@@ -34,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
@@ -109,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);