@kimuson/claude-code-viewer 0.5.9 → 0.6.0-beta.2

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 CHANGED
@@ -32,6 +32,10 @@ Claude Code Viewer is a web-based Claude Code client focused on **comprehensive
32
32
  | Review Changes | Built-in Git Diff Viewer lets you review all changes directly within Claude Code Viewer |
33
33
  | Commit Changes | Execute Git commits directly from the web interface within the Git Diff Viewer |
34
34
  | Push Changes | Push committed changes directly from the Git Diff Viewer. Supports both separate push operations and combined commit-and-push workflows for streamlined deployment |
35
+ | Branch Switcher | Switch local Git branches directly from the Git tab (with search and status indicators) |
36
+ | Files & Tools Inspector | Right panel tab that summarizes edited files, groups them by project, and lists tool invocations with filters and quick file preview |
37
+ | Todo Viewer | Extracts the latest `TodoWrite` items from sessions and displays them in collapsible checklists |
38
+ | Terminal Panel | Bottom panel terminal over WebSocket for running shell commands without leaving the UI |
35
39
  | MCP Server Viewer | View MCP server configurations directly in the session sidebar. Lists all configured servers with their names and commands, with real-time reload capability |
36
40
  | System Information | Monitor Claude Code and Claude Code Viewer versions, feature compatibility, and system status |
37
41
  | Multi-language Support | Full internationalization support with English, Japanese, and Simplified Chinese language options |
@@ -140,7 +144,7 @@ The application reads Claude Code conversation logs from:
140
144
 
141
145
  ### Environment Variables
142
146
 
143
- **NODE_ENV Consideration**: If you have `NODE_ENV=development` set in your environment (from other projects or system configuration), the application may not work correctly. Either set `NODE_ENV=production` or leave it unset when running Claude Code Viewer.
147
+ **CCV_ENV Consideration**: If you have `CCV_ENV=development` set in your environment, the application will start in development mode. For production use, set `CCV_ENV=production` or leave it unset.
144
148
 
145
149
  ## Configuration
146
150
 
@@ -155,12 +159,24 @@ Claude Code Viewer can be configured using command-line options or environment v
155
159
  | `-P, --password <password>` | `CCV_PASSWORD` | Password for authentication. When set, enables password-based authentication to protect access to Claude Code Viewer. All `/api` routes (except login, logout, check, config, and version endpoints) require authentication. If not set, authentication is disabled and the application is publicly accessible | (none) |
156
160
  | `-e, --executable <executable>` | `CCV_CC_EXECUTABLE_PATH` | Path to Claude Code installation. If not set, uses system PATH installation, or falls back to bundled version from dependencies | (auto-detect) |
157
161
  | `--claude-dir <claude-dir>` | `CCV_GLOBAL_CLAUDE_DIR` | Path to Claude directory where session logs are stored | `~/.claude` |
162
+ | `--terminal-disabled` | `CCV_TERMINAL_DISABLED` | Disable the in-app terminal panel when set to `1`/`true` (env) or when the flag is present (CLI) | (unset) |
163
+ | `--terminal-shell <path>` | `CCV_TERMINAL_SHELL` | Shell executable for terminal sessions (e.g. `/bin/zsh`) | (auto-detect) |
164
+ | `--terminal-unrestricted` | `CCV_TERMINAL_UNRESTRICTED` | When set to `1` (env) or when the flag is present (CLI), disables the restricted shell flags for bash | (unset) |
158
165
 
159
166
  **Breaking Change**: Environment variable names have been changed. If you're using environment variables, update them as follows:
160
167
  - `CLAUDE_CODE_VIEWER_AUTH_PASSWORD` → `CCV_PASSWORD`
161
168
  - `CLAUDE_CODE_VIEWER_CC_EXECUTABLE_PATH` → `CCV_CC_EXECUTABLE_PATH`
162
169
  - New environment variable added: `CCV_GLOBAL_CLAUDE_DIR` (previously the Claude directory path was hardcoded to `~/.claude`)
163
170
 
171
+ ### API Authentication
172
+
173
+ When `--password` / `CCV_PASSWORD` is set, all `/api` routes (except auth-related endpoints) require authentication. You can authenticate in two ways:
174
+
175
+ 1. **Session cookie**: Use the `/api/auth/login` endpoint to set the `ccv-session` cookie, then include it in subsequent requests.
176
+ 2. **Authorization header**: Send `Authorization: Bearer <password>` on each request.
177
+
178
+ If no password is configured, API authentication is disabled.
179
+
164
180
  ### User Settings
165
181
 
166
182
  Settings can be configured from the sidebar in Claude Code Viewer.