cc-viewer 1.0.4 → 1.0.5
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.
- package/README.md +45 -43
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,79 +1,81 @@
|
|
|
1
1
|
# CC-Viewer
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
A request monitoring system for Claude Code that captures and visualizes all API requests and responses in real time. Helps developers monitor their Context for reviewing and debugging during Vibe Coding.
|
|
4
4
|
|
|
5
|
-
[
|
|
5
|
+
[简体中文](./docs/README.zh.md) | [繁體中文](./docs/README.zh-TW.md) | [한국어](./docs/README.ko.md) | [日本語](./docs/README.ja.md) | [Deutsch](./docs/README.de.md) | [Español](./docs/README.es.md) | [Français](./docs/README.fr.md) | [Italiano](./docs/README.it.md) | [Dansk](./docs/README.da.md) | [Polski](./docs/README.pl.md) | [Русский](./docs/README.ru.md) | [العربية](./docs/README.ar.md) | [Norsk](./docs/README.no.md) | [Português (Brasil)](./docs/README.pt-BR.md) | [ไทย](./docs/README.th.md) | [Türkçe](./docs/README.tr.md) | [Українська](./docs/README.uk.md)
|
|
6
6
|
|
|
7
|
-
##
|
|
7
|
+
## Usage
|
|
8
8
|
|
|
9
9
|
```bash
|
|
10
10
|
npm install -g cc-viewer
|
|
11
11
|
```
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
After installation, run:
|
|
14
14
|
|
|
15
15
|
```bash
|
|
16
16
|
ccv
|
|
17
17
|
```
|
|
18
18
|
|
|
19
|
-
|
|
19
|
+
Then use Claude Code as usual and open `http://localhost:7008` in your browser to view the monitoring interface.
|
|
20
20
|
|
|
21
|
-
|
|
21
|
+
After Claude Code updates, no manual action is needed — the next time you run `claude`, it will automatically detect and reconfigure.
|
|
22
|
+
|
|
23
|
+
### Uninstall
|
|
22
24
|
|
|
23
25
|
```bash
|
|
24
26
|
ccv --uninstall
|
|
25
27
|
```
|
|
26
28
|
|
|
27
|
-
##
|
|
29
|
+
## Features
|
|
28
30
|
|
|
29
|
-
###
|
|
31
|
+
### Request Monitoring (Raw Mode)
|
|
30
32
|
|
|
31
|
-
-
|
|
32
|
-
-
|
|
33
|
-
-
|
|
34
|
-
-
|
|
35
|
-
- Request Body
|
|
36
|
-
- Response Body
|
|
37
|
-
-
|
|
38
|
-
-
|
|
39
|
-
- MainAgent
|
|
33
|
+
- Real-time capture of all API requests from Claude Code, including streaming responses
|
|
34
|
+
- Left panel shows request method, URL, duration, and status code
|
|
35
|
+
- Automatically identifies and labels Main Agent and Sub Agent requests
|
|
36
|
+
- Right panel supports Request / Response tab switching
|
|
37
|
+
- Request Body expands `messages`, `system`, `tools` one level by default
|
|
38
|
+
- Response Body fully expanded by default
|
|
39
|
+
- Toggle between JSON view and plain text view
|
|
40
|
+
- One-click JSON content copy
|
|
41
|
+
- MainAgent requests support Body Diff JSON, showing a collapsible diff with the previous MainAgent request (only changed/added fields)
|
|
40
42
|
|
|
41
|
-
###
|
|
43
|
+
### Chat Mode
|
|
42
44
|
|
|
43
|
-
|
|
45
|
+
Click the "Chat mode" button in the top right to parse Main Agent's full conversation history into a chat interface:
|
|
44
46
|
|
|
45
|
-
-
|
|
46
|
-
- `/compact`
|
|
47
|
-
-
|
|
48
|
-
- `thinking`
|
|
49
|
-
- `tool_use`
|
|
50
|
-
-
|
|
51
|
-
-
|
|
52
|
-
-
|
|
53
|
-
-
|
|
54
|
-
-
|
|
47
|
+
- User messages right-aligned (blue bubbles), Main Agent replies left-aligned (dark bubbles) with Markdown rendering
|
|
48
|
+
- `/compact` messages auto-detected and displayed collapsed, click to expand full summary
|
|
49
|
+
- Tool call results displayed inline within the corresponding Assistant message
|
|
50
|
+
- `thinking` blocks collapsed by default, click to expand
|
|
51
|
+
- `tool_use` shown as compact tool call cards (Bash, Read, Edit, Write, Glob, Grep, Task each have dedicated displays)
|
|
52
|
+
- User selection messages (AskUserQuestion) shown in Q&A format
|
|
53
|
+
- System tags (`<system-reminder>`, `<project-reminder>`, etc.) auto-collapsed
|
|
54
|
+
- System text auto-filtered, showing only real user input
|
|
55
|
+
- Multi-session segmented display (auto-segmented after `/compact`, `/clear`, etc.)
|
|
56
|
+
- Each message shows a timestamp accurate to the second
|
|
55
57
|
|
|
56
|
-
### Token
|
|
58
|
+
### Token Stats
|
|
57
59
|
|
|
58
|
-
|
|
60
|
+
Hover panel in the header area:
|
|
59
61
|
|
|
60
|
-
-
|
|
61
|
-
-
|
|
62
|
-
- Main Agent
|
|
62
|
+
- Token counts grouped by model (input/output)
|
|
63
|
+
- Cache creation/read counts and cache hit rate
|
|
64
|
+
- Main Agent cache expiration countdown
|
|
63
65
|
|
|
64
|
-
###
|
|
66
|
+
### Log Management
|
|
65
67
|
|
|
66
|
-
|
|
68
|
+
Via the CC-Viewer dropdown menu in the top left:
|
|
67
69
|
|
|
68
|
-
-
|
|
69
|
-
-
|
|
70
|
-
-
|
|
71
|
-
-
|
|
72
|
-
-
|
|
70
|
+
- Import local logs: browse historical log files, grouped by project, opens in new window
|
|
71
|
+
- Load local JSONL file: directly select and load a local `.jsonl` file (up to 200MB)
|
|
72
|
+
- Download current log: download the current monitoring JSONL log file
|
|
73
|
+
- Export user prompts: extract and display all user inputs, with system-reminder collapsible view
|
|
74
|
+
- Export prompts to TXT: export user prompts to a local `.txt` file
|
|
73
75
|
|
|
74
|
-
###
|
|
76
|
+
### Multi-language Support
|
|
75
77
|
|
|
76
|
-
CC-Viewer
|
|
78
|
+
CC-Viewer supports 18 languages, automatically switching based on system locale:
|
|
77
79
|
|
|
78
80
|
简体中文 | English | 繁體中文 | 한국어 | Deutsch | Español | Français | Italiano | Dansk | 日本語 | Polski | Русский | العربية | Norsk | Português (Brasil) | ไทย | Türkçe | Українська
|
|
79
81
|
|