ask-log

Auto-capture and visualize your AI conversation history with a local web panel.

Install

npm install -g ask-log

Requires Node.js >= 20.

Setup (one command)

ask-log init

This will:

1. Create data directory at ~/.ask-log/data/
2. Register hooks in Claude Code's ~/.claude/settings.json

Then restart Claude Code for hooks to take effect.

Usage

# Start the web panel
ask-log serve

# Check today's stats in terminal
ask-log status

Open http://localhost:3721 to view the panel.

How it works

Claude Code ──hook──> ask-log collect ──> ~/.ask-log/data/YYYY-MM-DD.json
                                                    │
ask-log serve ──> Express API ──> Web Panel ────────┘

• Every time you send a prompt in Claude Code, the UserPromptSubmit hook fires and records your question
• Every time Claude finishes a response, the Stop hook fires and records the reply
• Data is stored locally as JSON, organized by date and session
• The web panel reads from local JSON files — nothing leaves your machine

Web Panel Features

• Session tabs to switch between different terminal windows
• Project directory labels (from cwd) to tell sessions apart
• Full-text search across all history (Ctrl+K)
• Date navigation
• Question list with AI response previews

Commands

| Command | Description | |---------|-------------| | ask-log init | Register Claude Code hooks | | ask-log serve | Start web panel (default port 3721) | | ask-log status | Show today's stats in terminal | | ask-log uninstall | Remove hooks from Claude Code settings |

Configuration

| Env Variable | Default | Description | |-------------|---------|-------------| | ASK_LOG_PORT | 3721 | Web server port |

Uninstall

ask-log uninstall     # Remove hooks
npm uninstall -g ask-log  # Remove package
rm -rf ~/.ask-log     # Remove data (optional)

License

MIT