cc-hub-cli 1.0.0 → 1.0.2

package/README.md

@@ -1 +1,160 @@
-# cc-hub
+# cc-hub
+
+Manage Claude CLI profiles, hooks, and sessions — one tool, all in one place.
+
+## Install
+
+```bash
+npm install -g cc-hub-cli
+```
+
+## Quick Start
+
+```bash
+# Add a profile
+cc-hub profile add flow -m anthropic.claude-4-6-sonnet -t eyJ... -u https://example.com/api
+
+# Set as default
+cc-hub profile default flow
+
+# Launch Claude Code with it
+cc-hub run
+
+# Or launch with a specific profile
+cc-hub run flow
+```
+
+## Commands
+
+### Profiles
+
+Manage multiple Claude API configurations (model, token, URL).
+
+```bash
+cc-hub profile add <name> -m <model> -t <token> -u <url>   # Add or update
+cc-hub profile update <name> -m <model>                      # Update fields
+cc-hub profile list                                          # List all (tokens masked)
+cc-hub profile view <name>                                   # View details (token visible)
+cc-hub profile view <name> -j                                # View as JSON
+cc-hub profile remove <name>                                 # Remove
+cc-hub profile default <name>                                # Set default
+```
+
+### Run / Use
+
+Launch Claude Code with a profile's credentials injected as environment variables.
+
+```bash
+# Set a profile as default (no launch)
+cc-hub use <name>
+
+# Launch Claude Code with a profile
+cc-hub use <name> [extra args...]
+
+# Launch using the default profile
+cc-hub run [extra args...]
+
+# Launch with a specific profile
+cc-hub run <name> [extra args...]
+```
+
+`run` and `use` exec into the `claude` CLI with `ANTHROPIC_AUTH_TOKEN`, `ANTHROPIC_BASE_URL`, and `--model` set from the profile.
+
+### Hook
+
+Manage Claude Code hooks in `~/.claude/settings.json`.
+
+```bash
+cc-hub hook list                                              # List all hooks
+cc-hub hook add -e <event> -c <command> [-m <matcher>] [-a]  # Add a hook
+cc-hub hook remove -i <index>                                 # Remove by index
+cc-hub hook enable -i <index> [-i <index>]                    # Enable disabled hooks
+cc-hub hook disable -i <index> [-i <index>]                   # Disable active hooks
+```
+
+**Events:** `PreToolUse`, `PostToolUse`, `Notification`, `Stop`, `UserPromptSubmit`, `PermissionRequest`
+
+**Examples:**
+
+```bash
+# Desktop notification when Claude finishes
+cc-hub hook add -e Stop -c 'osascript -e "display notification \"Done\""'
+
+# Hook only for Bash tool usage
+cc-hub hook add -e PreToolUse -m Bash -c 'echo "Running bash..."'
+
+# Async hook
+cc-hub hook add -e PostToolUse -c 'my-logger.sh' -a
+```
+
+Disabled hooks are kept in a pool and can be re-enabled later with `hook enable`.
+
+### Session
+
+Browse and search Claude Code session history from `~/.claude/projects/`.
+
+```bash
+cc-hub session list [-n <limit>] [-s] [-j]                   # List projects
+cc-hub session show <project> [-v]                            # Show sessions for a project
+cc-hub session search <query> [-p <project>] [-n <n>] [-i]   # Search conversation history
+cc-hub session ps                                             # Show active processes
+cc-hub session stats                                          # Summary statistics
+cc-hub session clean [-d <days>] [--dry-run]                  # Delete old sessions
+```
+
+**Examples:**
+
+```bash
+# List recent projects
+cc-hub session list -n 10
+
+# Show sessions with first message preview
+cc-hub session show cc-hub -v
+
+# Case-insensitive search
+cc-hub session search "authentication" -i
+
+# Preview what would be cleaned up
+cc-hub session clean -d 60 --dry-run
+```
+
+### Shell Completion
+
+```bash
+# zsh — add to ~/.zshrc
+eval "$(cc-hub complete zsh)"
+
+# bash — add to ~/.bashrc
+eval "$(cc-hub complete bash)"
+```
+
+Completes subcommands, profile names, and event types.
+
+## Configuration
+
+cc-hub reads from these paths (overridable via environment variables):
+
+| File | Default | Env Override |
+|---|---|---|
+| Profiles | `~/.claude/profiles.json` | `CLAUDE_PROFILES_FILE` |
+| Settings | `~/.claude/settings.json` | `CLAUDE_SETTINGS_FILE` |
+| Claude dir | `~/.claude` | `CLAUDE_DIR` |
+
+### Profile storage format
+
+```json
+{
+  "profiles": {
+    "flow": {
+      "model": "anthropic.claude-4-6-sonnet",
+      "token": "eyJ...",
+      "url": "https://example.com/api"
+    }
+  },
+  "default": "flow"
+}
+```
+
+## License
+
+MIT

package/dist/index.js

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command4 } from "commander";
+import { Command as Command5 } from "commander";
 
 // src/profiles.ts
 import { Command } from "commander";
-import Anthropic from "@anthropic-ai/sdk";
+import { spawnSync } from "child_process";
 
 // src/config.ts
 import fs from "fs";
@@ -134,78 +134,60 @@ function profileCommand() {
   });
   return profile;
 }
-async function runWithProfile(profileName, prompt) {
-  ensureProfilesFile();
-  const data = readJson(PROFILES_FILE);
-  const p = data.profiles[profileName];
-  if (!p) {
-    console.error(`Profile '${profileName}' not found.`);
-    process.exit(1);
-  }
-  if (!p.token) {
-    console.error(`Profile '${profileName}' has no token configured.`);
-    process.exit(1);
-  }
-  const client = new Anthropic({
-    apiKey: p.token,
-    ...p.url ? { baseURL: p.url } : {}
-  });
+function execClaude(profileName, p, extraArgs) {
+  const cmd = ["claude"];
+  if (p.model) cmd.push("--model", p.model);
+  cmd.push(...extraArgs);
+  const env = {
+    ...process.env,
+    ANTHROPIC_AUTH_TOKEN: p.token || void 0,
+    ANTHROPIC_BASE_URL: p.url || void 0
+  };
+  delete env.ANTHROPIC_API_KEY;
   console.error(`Using profile '${profileName}': model=${p.model || "(default)"} url=${p.url || "(default)"}`);
-  const stream = client.messages.stream(
-    {
-      model: p.model || "claude-sonnet-4-20250514",
-      max_tokens: 4096,
-      messages: [{ role: "user", content: prompt }]
-    }
-  );
-  for await (const event of stream) {
-    if (event.type === "content_block_delta" && event.delta.type === "text_delta") {
-      process.stdout.write(event.delta.text);
-    }
-  }
-  process.stdout.write("\n");
+  const result = spawnSync(cmd[0], cmd.slice(1), {
+    stdio: "inherit",
+    env
+  });
+  process.exit(result.status ?? 1);
 }
 function useCommand() {
-  return new Command("use").description("Launch a chat session using a saved profile").argument("<name>", "Profile name").argument("[prompt...]", "Prompt text").action(async (name, promptParts) => {
-    const prompt = promptParts.join(" ");
-    if (!prompt) {
-      ensureProfilesFile();
-      const data = readJson(PROFILES_FILE);
-      if (!data.profiles[name]) {
-        console.error(`Profile '${name}' not found.`);
-        process.exit(1);
-      }
+  return new Command("use").description("Launch Claude Code with a saved profile (or set default if no args)").allowUnknownOption().argument("<name>", "Profile name").argument("[args...]", "Extra arguments passed to claude").action((name, args) => {
+    ensureProfilesFile();
+    const data = readJson(PROFILES_FILE);
+    const p = data.profiles[name];
+    if (!p) {
+      console.error(`Profile '${name}' not found.`);
+      process.exit(1);
+    }
+    if (!args || args.length === 0) {
       data.default = name;
       writeJson(PROFILES_FILE, data);
       console.log(`Default profile set to '${name}'.`);
       return;
     }
-    await runWithProfile(name, prompt);
+    execClaude(name, p, args);
   });
 }
 function runCommand() {
-  return new Command("run").description("Run a prompt using the default or a specified profile").argument("[args...]", "Optional profile name followed by prompt").action(async (args) => {
+  return new Command("run").description("Launch Claude Code using the default or a specified profile").allowUnknownOption().argument("[args...]", "Optional profile name followed by extra arguments").action((args) => {
     ensureProfilesFile();
     const data = readJson(PROFILES_FILE);
     let profileName = "";
-    let promptParts;
+    let claudeArgs;
     if (args.length > 0 && data.profiles[args[0]]) {
       profileName = args[0];
-      promptParts = args.slice(1);
+      claudeArgs = args.slice(1);
     } else {
       profileName = data.default || "";
-      promptParts = args;
+      claudeArgs = args;
     }
     if (!profileName) {
       console.error("No default profile set. Use 'cc-hub use <name>' first.");
       process.exit(1);
     }
-    const prompt = promptParts.join(" ");
-    if (!prompt) {
-      console.error("No prompt provided.");
-      process.exit(1);
-    }
-    await runWithProfile(profileName, prompt);
+    const p = data.profiles[profileName];
+    execClaude(profileName, p, claudeArgs);
   });
 }
 
@@ -250,7 +232,7 @@ function buildFlat(data) {
   return rows;
 }
 function hooksCommand() {
-  const hooks = new Command2("hooks").alias("h").description("Manage Claude Code hooks in settings.json");
+  const hooks = new Command2("hook").description("Manage Claude Code hooks in settings.json");
   hooks.command("list").description("List all hooks").action(() => {
     ensureSettingsFile();
     const data = readJson(SETTINGS_FILE);
@@ -777,12 +759,188 @@ function sessionCommand() {
   return session;
 }
 
+// src/complete.ts
+import { Command as Command4 } from "commander";
+var ZSH_COMPLETION = `#compdef cc-hub
+
+_cc-hub() {
+  local -a commands
+  commands=(
+    'profile:Manage Claude CLI profiles'
+    'use:Launch Claude Code with a saved profile'
+    'run:Launch Claude Code using the default or a specified profile'
+    'hook:Manage Claude Code hooks in settings.json'
+    'session:Manage Claude Code sessions'
+    'complete:Print shell completion functions'
+    'help:Display help for a command'
+  )
+
+  local -a profile_subcmds
+  profile_subcmds=(
+    'add:Add or update a profile'
+    'update:Update fields of an existing profile'
+    'list:List all profiles'
+    'view:View full details of a profile'
+    'remove:Remove a profile'
+    'default:Set the default profile'
+  )
+
+  local -a hooks_subcmds
+  hooks_subcmds=(
+    'list:List all hooks'
+    'add:Add a hook to settings.json'
+    'remove:Remove a hook by its global index'
+    'enable:Enable one or more disabled hooks'
+    'disable:Disable one or more hooks'
+  )
+
+  local -a session_subcmds
+  session_subcmds=(
+    'list:List all Claude Code project sessions'
+    'show:Show session files for a project'
+    'search:Search conversation history across all projects'
+    'ps:Show active Claude Code processes'
+    'stats:Show summary statistics'
+    'clean:Delete session JSONL files older than N days'
+  )
+
+  _cc_hub_profiles() {
+    local profiles_file="\${CLAUDE_PROFILES_FILE:-$HOME/.claude/profiles.json}"
+    if [[ -f "$profiles_file" ]]; then
+      local -a names
+      names=(\${(f)"$(command python3 -c "
+import json
+data = json.load(open('$profiles_file'))
+for name in data.get('profiles', {}):
+    print(name)
+" 2>/dev/null)"})
+      _describe -t profiles 'profile' names
+    fi
+  }
+
+  _arguments -C \\
+    '1: :->command' \\
+    '*::arg:->args'
+
+  case $state in
+    command)
+      _describe -t commands 'cc-hub command' commands
+      ;;
+    args)
+      case $words[1] in
+        profile)
+          if (( CURRENT == 2 )); then
+            _describe -t profile-subcmds 'profile subcommand' profile_subcmds
+          elif [[ $words[2] == "view" || $words[2] == "remove" || $words[2] == "default" || $words[2] == "update" ]]; then
+            _cc_hub_profiles
+          fi
+          ;;
+        use|run)
+          _cc_hub_profiles
+          ;;
+        hook)
+          if (( CURRENT == 2 )); then
+            _describe -t hooks-subcmds 'hook subcommand' hooks_subcmds
+          fi
+          ;;
+        session)
+          if (( CURRENT == 2 )); then
+            _describe -t session-subcmds 'session subcommand' session_subcmds
+          fi
+          ;;
+      esac
+      ;;
+  esac
+}
+
+_cc-hub "$@"
+`;
+var BASH_COMPLETION = `_cc-hub_profiles() {
+  local profiles_file="\${CLAUDE_PROFILES_FILE:-$HOME/.claude/profiles.json}"
+  if [[ -f "$profiles_file" ]]; then
+    local names
+    names=$(command python3 -c "
+import json
+data = json.load(open('$profiles_file'))
+for name in data.get('profiles', {}):
+    print(name)
+" 2>/dev/null)
+    COMPREPLY=($(compgen -W "$names" -- "\${cur}"))
+  fi
+}
+
+_cc-hub() {
+  local cur prev commands
+  COMPREPLY=()
+  cur="\${COMP_WORDS[COMP_CWORD]}"
+  prev="\${COMP_WORDS[COMP_CWORD-1]}"
+  commands="profile use run hook session complete help"
+
+  local profile_subcmds="add update list view remove default"
+  local hooks_subcmds="list add remove enable disable"
+  local session_subcmds="list show search ps stats clean"
+
+  # Top-level command
+  if [[ \${COMP_CWORD} -eq 1 ]]; then
+    COMPREPLY=($(compgen -W "$commands" -- "$cur"))
+    return 0
+  fi
+
+  local cmd="\${COMP_WORDS[1]}"
+
+  case "$cmd" in
+    profile)
+      if [[ \${COMP_CWORD} -eq 2 ]]; then
+        COMPREPLY=($(compgen -W "$profile_subcmds" -- "$cur"))
+      elif [[ "$prev" == "view" || "$prev" == "remove" || "$prev" == "default" || "$prev" == "update" ]]; then
+        _cc-hub_profiles
+      elif [[ "$prev" == "profile" ]]; then
+        COMPREPLY=($(compgen -W "$profile_subcmds" -- "$cur"))
+      fi
+      ;;
+    use|run)
+      _cc-hub_profiles
+      ;;
+    hook)
+      if [[ \${COMP_CWORD} -eq 2 ]]; then
+        COMPREPLY=($(compgen -W "$hooks_subcmds" -- "$cur"))
+      fi
+      ;;
+    session)
+      if [[ \${COMP_CWORD} -eq 2 ]]; then
+        COMPREPLY=($(compgen -W "$session_subcmds" -- "$cur"))
+      fi
+      ;;
+  esac
+
+  return 0
+}
+
+complete -F _cc-hub cc-hub
+`;
+function completeCommand() {
+  return new Command4("complete").description("Print shell completion script").argument("<shell>", "Shell type: bash or zsh").action((shell) => {
+    switch (shell) {
+      case "zsh":
+        process.stdout.write(ZSH_COMPLETION);
+        break;
+      case "bash":
+        process.stdout.write(BASH_COMPLETION);
+        break;
+      default:
+        console.error(`Unsupported shell: ${shell}. Use 'bash' or 'zsh'.`);
+        process.exit(1);
+    }
+  });
+}
+
 // src/index.ts
-var program = new Command4();
+var program = new Command5();
 program.name("cc-hub").description("Manage Claude CLI profiles, hooks, and sessions").version("1.0.0");
 program.addCommand(profileCommand());
 program.addCommand(useCommand());
 program.addCommand(runCommand());
 program.addCommand(hooksCommand());
 program.addCommand(sessionCommand());
+program.addCommand(completeCommand());
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-hub-cli",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Manage Claude CLI profiles, hooks, and sessions",
   "type": "module",
   "bin": {
@@ -25,7 +25,6 @@
     "anthropic"
   ],
   "dependencies": {
-    "@anthropic-ai/sdk": "^0.39.0",
     "commander": "^13.1.0"
   },
   "devDependencies": {