FAQ

FAQ

The hook isn't logging anything

Check in order:

1. RedLog running? — Hook needs ~/.redlog/api-port + ~/.redlog/api-token to exist. Both are written when you open a project.
2. Recording paused? — Look at the status bar; click the ● to resume, or run redlog-cli recording resume.
3. cwd in exclusion list? — Settings ▸ 整合 ▸ Claude Code Hook 例外清單. Anything under an excluded path is silently skipped.
4. Legacy $$$ shell hook? — Pre-v0.6.47 installs had a broken hook. v0.6.64+ auto-upgrades on RedLog startup; check the timeline for a system.hook_auto_upgrade event.
5. Claude Code hook using old env-var API? — pre-v0.6.58 hook read CLAUDE_TOOL_* env vars that Claude Code stopped setting. v0.6.58+ reads stdin JSON. Re-install the hook from Settings if you edited it.

redlog-cli chain verify --full says BROKEN

Since v0.6.55 the verifier walks four hash shapes (v0.1, v0.2, v0.6, v0.6+null) plus tolerates NULL prev_hash on pre-v0.2 events (that's a schema-migration sentinel, not tampering). If it still reports broken:

• The brokenAtEventId in the response points at the specific event.
• Cross-reference ~/.redlog/projects/<slug>/timeline.db — SQLite tools will read it directly.
• If the event was genuinely tampered with, only the OpenTimestamps anchor can prove when the divergence started. redlog-cli chain status shows the last anchor.

Dashboard shows "chain N ≠ events M"

Since v0.6.54 the dashboard events card also displays the chain length as a sub-line. When they diverge, it's a tamper signal — someone appended events to the DB without hashing them, or an event's hash was rewritten. Run chain verify --full to isolate.

Screenshots panel is spamming duplicates

Since v0.6.54 there's a dHash (difference hash) perceptual dedup in addition to the SHA-256 byte dedup. If you're still seeing dupes:

• Check the trigger — periodic shots dedup, but manual always lands.
• The dHash Hamming threshold is fixed at 5/64 bits. Cursor movement should be under; a new terminal line is usually 6-10.

⌘/ doesn't open Search

macOS delivers Unidentified as e.key for ⌘/ in some Chromium builds, so e.key === '/' never matched. v0.6.49 added e.code === 'Slash' + ⌘K as an alias — try ⌘K if ⌘/ still doesn't work.

HUD is hidden after ⌘⌥ + Arrow

macOS Sequoia's built-in window tiling grabs ⌘⌥ + Arrow before RedLog sees it, so the two-key combo moves the main window instead of the HUD. v0.6.48+ uses ⌘⇧⌥ + Arrow instead — no built-in system shortcut.

VPS commands aren't showing up

The reverse tunnel needs -R 6660:127.0.0.1:6660 to stay open. Check:

• hooks/vps-deploy.sh tunnel is still in the foreground — closing it drops the tunnel.
• Nothing else is bound to 6660 on the VPS (the tunnel picks the port that matches the local RedLog API).
• Locally, curl -sf http://127.0.0.1:6660/api/health works — if not, RedLog isn't running or the token file is stale.

Where do the .cast files live?

~/.redlog/projects/<slug>/casts/*.cast — asciinema v2 format. Play back with asciinema play <file> or the ▶ Replay buttons in Timeline. Bounded to 50 MB per session (terminal.maxCastBytes in config).

Windows portable exe doesn't launch

RedLog.<version>.exe is unsigned and SmartScreen will block it. Click More info → Run anyway on first launch. If it silently fails, the usual cause is a missing Visual C++ Redistributable — install the latest from Microsoft.