feat: improve CLI help menu and command descriptions (#32)

- Update main CLI description to match README tagline
- Enhance init command description with detailed TypeScript features
- Improve session command description with usage examples
- Remove unused @oclif/plugin-plugins dependency
- Make all help content more descriptive and actionable

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-authored-by: Claude <[email protected]>

Author: johnlindquist

package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-hooks",
-  "description": "CLI to initialize Claude Code hooks in your project",
+  "description": "TypeScript-powered hook system for Claude Code - write hooks with full type safety and auto-completion",
   "version": "1.1.7",
   "author": "John Lindquist @johnlindquist",
   "bin": {
@@ -10,7 +10,6 @@
   "dependencies": {
     "@oclif/core": "^4",
     "@oclif/plugin-help": "^6",
-    "@oclif/plugin-plugins": "^5",
     "chalk": "^5.4.1",
     "fs-extra": "^11.3.0",
     "ora": "^8.2.0"
@@ -65,8 +64,7 @@
     "dirname": "claude-hooks",
     "commands": "./dist/commands",
     "plugins": [
-      "@oclif/plugin-help",
-      "@oclif/plugin-plugins"
+      "@oclif/plugin-help"
     ],
     "topicSeparator": " "
   },

src/commands/init.ts

@@ -8,11 +8,17 @@ import ora from 'ora'
 export default class Init extends Command {
   static description = `Initialize Claude Code hooks in your project
 
-This command sets up basic Claude Code hooks in your project:
+Sets up a TypeScript-powered hook system for Claude Code with full type safety:
 • Creates settings.json (or settings.json.local with --local flag) with hook configuration
-• Generates index.ts with session-saving handlers for all hook types (including SubagentStop)
-• Creates lib.ts with base utilities for hook management
-• Saves session data to system temp directory`
+• Generates index.ts with TypeScript handlers for all hook types (PreToolUse, PostToolUse, Notification, Stop, SubagentStop)
+• Creates lib.ts with strongly-typed payload interfaces and utilities
+• Sets up session.ts for optional session tracking
+• Initializes a Bun project with TypeScript configuration
+• Saves session data to system temp directory
+
+Requirements:
+• Node.js >= 18.0.0
+• Bun runtime (https://bun.sh)`
 
   static examples = [
     {

src/commands/session.ts

@@ -8,7 +8,12 @@ import fs from 'fs-extra'
 export default class Session extends Command {
   static description = `Open the latest Claude session log
 
-This command finds and opens the most recent session log file from the system temp directory.`
+Finds and opens Claude hook session logs for debugging and analysis:
+• Opens the most recent session log by default
+• Lists all available sessions with --list flag
+• Opens a specific session by ID with --id flag
+• Session logs contain detailed hook execution data and payloads
+• Logs are stored in: <system-temp-dir>/claude-hooks-sessions/`
 
   static examples = [
     {

test/integration/cli.test.ts

@@ -98,7 +98,7 @@ describe('CLI Integration Tests', () => {
         encoding: 'utf8',
       })
 
-      expect(output).to.include('CLI to initialize Claude Code hooks')
+      expect(output).to.include('TypeScript-powered hook system for Claude Code')
       expect(output).to.include('COMMANDS')
       expect(output).to.include('init')
     })