cc-hub-cli 1.1.4 → 1.1.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +38 -0
  2. package/dist/index.js +467 -213
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -159,6 +159,44 @@ Invoke-Expression (& cc-hub completion powershell | Out-String)
159
159
 
160
160
  Completes subcommands, profile names, and event types.
161
161
 
162
+ ## Logging
163
+
164
+ cc-hub writes structured logs to `~/.claude/cc-hub/logs/cc-hub-YYYY-MM-DD.log`.
165
+
166
+ ### Log levels
167
+
168
+ Levels are ordered from most to least verbose:
169
+
170
+ | Level | Description |
171
+ |---|---|
172
+ | `DEBUG` | All service calls, file reads/writes, path encode/decode, proxy requests |
173
+ | `INFO` | Command executions, profile launches, proxy start/stop |
174
+ | `WARN` | JSON auto-fix events, backup restores |
175
+ | `ERROR` | Thrown exceptions, upstream errors, uncaught exceptions/rejections |
176
+
177
+ The default level is `INFO`. To change it, add `_cc_hub_logLevel` to `~/.claude/settings.json`:
178
+
179
+ ```json
180
+ {
181
+ "_cc_hub_logLevel": "DEBUG"
182
+ }
183
+ ```
184
+
185
+ Valid values: `DEBUG`, `INFO`, `WARN`, `ERROR`.
186
+
187
+ ### Viewing logs
188
+
189
+ ```bash
190
+ # Tail today's log
191
+ tail -f ~/.claude/cc-hub/logs/cc-hub-$(date +%Y-%m-%d).log
192
+
193
+ # View all logs
194
+ ls -lt ~/.claude/cc-hub/logs/
195
+
196
+ # Search for errors
197
+ grep ERROR ~/.claude/cc-hub/logs/*.log
198
+ ```
199
+
162
200
  ## Configuration
163
201
 
164
202
  cc-hub reads from these paths (overridable via environment variables):