Package Exports

cc-hub-cli

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (cc-hub-cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

cc-hub

Manage Claude CLI profiles, hooks, and sessions — one tool, all in one place.

Note: macOS, Linux, and Windows supported.

Install

npm install -g cc-hub-cli

Quick Start

# Add a profile with single model
cc-hub profile add flow -m anthropic.claude-4-6-sonnet -t eyJ... -u https://example.com/api

# Add a profile with multiple models
cc-hub profile add multi -m kimi-k2.5 -m claude-sonnet-4-6 -m gpt-4 -t eyJ... -u https://api.example.com

# 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).

cc-hub profile add <name> -m <model> -t <token> -u <url>   # Add or update
cc-hub profile add <name> -m <m1> -m <m2> -t <token>       # Add with multiple models
cc-hub profile update <name> -m <model>                      # Update fields
cc-hub profile update <name> -m <m1> -m <m2>                 # Update with multiple models
cc-hub profile remove-model <name> -m <model>                # Remove specific models
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

Multi-Model Profiles:

You can specify multiple models per profile using the -m flag multiple times:

# Add a profile with multiple models
cc-hub profile add myprofile -m kimi-k2.5 -m claude-sonnet-4-6 -t <token> -u <url>

# Remove specific models
cc-hub profile remove-model myprofile -m kimi-k2.5

When you launch Claude Code with cc-hub run, the models are automatically populated into Claude Code's /model picker via the availableModels setting in ~/.claude/settings.json. The first model is used as the default.

Non-Anthropic Models:

If your profile includes non-Anthropic models (e.g., kimi-k2.5, gpt-4), the first such model is also exposed via the ANTHROPIC_CUSTOM_MODEL_OPTION environment variable, which adds it as a named entry in the /model picker.

Run / Use

Launch Claude Code with a profile's credentials injected as environment variables.

# Set a profile as default
cc-hub use <name>

# Launch using the default profile
cc-hub run [extra args...]

# Launch with a specific profile
cc-hub run <name> [extra args...]

run execs 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.

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:

# Desktop notification when Claude finishes (macOS)
cc-hub hook add -e Stop -c 'osascript -e "display notification \"Done\""'

# Desktop notification when Claude finishes (Windows PowerShell)
cc-hub hook add -e Stop -c 'powershell -Command "Add-Type -AssemblyName System.Windows.Forms; [System.Windows.Forms.MessageBox]::Show(\"Claude 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/.

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:

# 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

# zsh — add to ~/.zshrc
eval "$(cc-hub completion zsh)"

# bash — add to ~/.bashrc
eval "$(cc-hub completion bash)"

# PowerShell — add to $PROFILE
Invoke-Expression (& cc-hub completion powershell | Out-String)

Completes subcommands, profile names, and event types.

Logging

cc-hub writes structured logs to ~/.claude/cc-hub/logs/cc-hub-YYYY-MM-DD.log.

Log levels

Levels are ordered from most to least verbose:

Level	Description
`DEBUG`	All service calls, file reads/writes, path encode/decode, proxy requests
`INFO`	Command executions, profile launches, proxy start/stop
`WARN`	JSON auto-fix events, backup restores
`ERROR`	Thrown exceptions, upstream errors, uncaught exceptions/rejections

The default level is INFO. To change it, add _cc_hub_logLevel to ~/.claude/settings.json:

{
  "_cc_hub_logLevel": "DEBUG"
}

Valid values: DEBUG, INFO, WARN, ERROR.

Viewing logs

# Tail today's log
tail -f ~/.claude/cc-hub/logs/cc-hub-$(date +%Y-%m-%d).log

# View all logs
ls -lt ~/.claude/cc-hub/logs/

# Search for errors
grep ERROR ~/.claude/cc-hub/logs/*.log

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

Single-model profile:

{
  "profiles": {
    "flow": {
      "model": "anthropic.claude-4-6-sonnet",
      "token": "eyJ...",
      "url": "https://example.com/api"
    }
  },
  "default": "flow"
}

Multi-model profile:

{
  "profiles": {
    "multi": {
      "model": "kimi-k2.5",
      "models": ["kimi-k2.5", "claude-sonnet-4-6", "gpt-4"],
      "token": "eyJ...",
      "url": "https://api.example.com"
    }
  },
  "default": "multi"
}

When launching with a multi-model profile, cc-hub automatically configures Claude Code's availableModels setting, populating the /model picker with all specified models.

Claude Code Skill

cc-hub includes a Claude Code skill for natural language profile management. The skill is located at skills/cc-hub/SKILL.md.

Capabilities:

Add/remove models from profiles using natural language
List models in a profile
Set the default model for a profile

Examples:

Add kimi-k2.5 and gpt-4 to my hy profile
Remove claude-sonnet from the flow profile
What models are in my hy profile?
Set the default model for hy to gpt-4

The skill directly reads and writes ~/.claude/profiles.json to make changes.

License

MIT