cc-hub-cli 1.0.1 → 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

@@ -152,7 +152,7 @@ function execClaude(profileName, p, extraArgs) {
   process.exit(result.status ?? 1);
 }
 function useCommand() {
-  return new Command("use").description("Launch Claude Code with a saved profile (or set default if no args)").argument("<name>", "Profile name").argument("[args...]", "Extra arguments passed to claude").action((name, args) => {
+  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];
@@ -170,7 +170,7 @@ function useCommand() {
   });
 }
 function runCommand() {
-  return new Command("run").description("Launch Claude Code using the default or a specified profile").argument("[args...]", "Optional profile name followed by extra arguments").action((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 = "";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cc-hub-cli",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Manage Claude CLI profiles, hooks, and sessions",
   "type": "module",
   "bin": {