21 - Monitoring and Productivity with Claude Code

# Installation
npm install -g ccflare

# Launch the Web UI
ccflare serve

# The UI is available at http://localhost:3847
# Open your browser and navigate to the address

# Configuration options
ccflare serve --port 8080           # Custom port
ccflare serve --data ~/.claude/     # Custom data directory

# Installing the improved fork
npm install -g better-ccflare

# Launch with all features
better-ccflare serve

# Export data for external analysis
better-ccflare export --format csv --from 2026-01-01 --to 2026-01-31
# Output: usage-2026-01.csv

# Set consumption alerts
better-ccflare alert --daily-limit 50000 --notify email
# Receive a notification when you exceed 50,000 tokens/day

# Compare periods
better-ccflare compare --this-week --last-week
# Output:
# Token Usage: +15% (this week: 245,000 vs last week: 213,000)
# Sessions: -2 (this week: 18 vs last week: 20)
# Avg tokens/session: +23% (this week: 13,611 vs last week: 10,650)
# Estimated cost: +12% ($4.90 vs $4.26)

# Installation
npm install -g cc-usage

# Show usage of the last session
cc-usage last
# Session: sess_abc123
# Duration: 45 minutes
# Input tokens: 23,456
# Output tokens: 8,901
# Total tokens: 32,357
# Estimated cost: $0.65

# Show daily usage
cc-usage today
# Today's usage:
# Sessions: 5
# Total tokens: 156,789
# Estimated cost: $3.14

# Show weekly usage with ASCII chart
cc-usage week --chart
# Mon: ████████████████ 45,234
# Tue: ██████████████████████ 62,100
# Wed: ████████████ 35,678
# Thu: ██████████████████ 51,234
# Fri: ████████████████████ 56,789
# Sat: ████ 12,345
# Sun: ██ 6,789
# Total: 269,169 tokens (~$5.38)

# Show monthly usage with breakdown by project
cc-usage month --by-project
# Project: portfolio-angular    89,234 tokens (33%)
# Project: play-the-event      134,567 tokens (50%)
# Project: tech-mcp             45,678 tokens (17%)
# Total: 269,479 tokens (~$5.39)

# Installation
npm install -g claudex

# Launch the conversation browser
claudex browse

# Search across all conversations
claudex search "how to configure nginx"
# Found 3 conversations:
# 1. [2026-01-15] Session about nginx reverse proxy setup
# 2. [2026-01-22] Debugging nginx SSL certificate
# 3. [2026-02-01] Nginx load balancer configuration

# Show details of a specific conversation
claudex show sess_abc123

# Export a conversation as markdown
claudex export sess_abc123 --format markdown --output session-recap.md

# Conversation statistics
claudex stats
# Total conversations: 156
# Date range: 2025-11-01 to 2026-02-14
# Most active project: play-the-event (67 conversations)
# Average conversation length: 23 turns
# Most used tools: Write (345), Bash (234), Read (567)

# Installation
npm install -g cc-sessions

# Create a new session with tags
cc-sessions new --project my-app --tag "feature/user-auth" --description "Implementing authentication system"

# List active sessions
cc-sessions list
# ID          | Project    | Tag                | Status  | Last Active
# sess_001    | my-app     | feature/user-auth  | active  | 5 min ago
# sess_002    | my-app     | bugfix/login       | paused  | 2 hours ago
# sess_003    | portfolio  | blog-articles      | active  | 1 hour ago

# Resume a session with context
cc-sessions resume sess_002
# Restoring context for session sess_002...
# Project: my-app
# Branch: bugfix/login
# Last activity: Fixed login timeout, working on session management
# Files modified: LoginService.java, SessionConfig.java

# Save the current session state
cc-sessions save --note "Completed login endpoint, next step: refresh token"

# Search sessions by content
cc-sessions search "nginx configuration"
# Found in sessions: sess_015, sess_023

# Archive completed sessions
cc-sessions archive sess_001 --reason "Feature completed and merged"

# Checkpointing is automatic in Claude Code
# Every file modification is tracked

# In the Claude Code session, you can use:
# /undo - Undo the last modification
# /undo 3 - Undo the last 3 modifications

# Example workflow with checkpoints:
# 1. Claude modifies UserService.java
# 2. Claude modifies UserController.java
# 3. Claude modifies UserDTO.java
# 4. Test fails: the DTO has a problem

# You can undo only the DTO modification:
# /undo 1
# This restores UserDTO.java without touching the other files

# To see the modification history in the session:
# /diff
# Output:
# [1] UserService.java: +15 -3 lines (10:23:45)
# [2] UserController.java: +8 -2 lines (10:25:12)
# [3] UserDTO.java: +5 -1 lines (10:26:30)  <-- undoable

# To undo a specific modification:
# /undo --file UserDTO.java
# Restores only that file to its pre-modification state

# Installation
npm install -g claudekit

# List available sub-agents
claudekit list
# Available agents (22):
#
# Development:
#   scaffold    - Generate project scaffolding
#   component   - Create new components with tests
#   api         - Generate REST API endpoints
#   migration   - Create database migrations
#
# Quality:
#   review      - AI-powered code review
#   test        - Generate comprehensive tests
#   lint-fix    - Fix linting issues automatically
#   refactor    - Suggest and apply refactoring
#
# Documentation:
#   docs        - Generate documentation
#   readme      - Create/update README
#   changelog   - Generate changelog from commits
#   adr         - Create Architecture Decision Records
#
# DevOps:
#   docker      - Generate Dockerfile and compose
#   ci          - Create CI/CD pipelines
#   deploy      - Deployment scripts and configs
#
# Analysis:
#   audit       - Security audit of codebase
#   deps        - Dependency analysis and updates
#   perf        - Performance analysis
#   complexity  - Code complexity metrics
#
# Utilities:
#   git-msg     - Generate commit messages
#   pr          - Create pull request descriptions
#   issue       - Generate issue templates

# Automated code review
claudekit review src/app/services/order.service.ts
# Review Report:
# Severity: 2 high, 5 medium, 3 low
#
# [HIGH] Line 45: SQL query built with string concatenation
#   Recommendation: Use parameterized query to prevent SQL injection
#
# [HIGH] Line 78: Sensitive data logged without masking
#   Recommendation: Mask PII in log output
#
# [MEDIUM] Line 23: Method exceeds 50 lines (67 lines)
#   Recommendation: Extract sub-methods for readability
# ...

# Automated test generation
claudekit test src/app/services/user.service.ts
# Generated 12 test cases:
#   - createUser_validInput_returnsUser
#   - createUser_duplicateEmail_throwsException
#   - createUser_invalidEmail_throwsValidation
#   - findById_existingUser_returnsUser
#   - findById_nonExistent_throwsNotFound
#   - updateUser_validChanges_returnsUpdated
#   - updateUser_emailConflict_throwsException
#   - deleteUser_existingUser_returnsSuccess
#   - deleteUser_nonExistent_throwsNotFound
#   - listUsers_withPagination_returnsPaged
#   - listUsers_withFilter_returnsFiltered
#   - listUsers_emptyResult_returnsEmpty

# Complexity analysis
claudekit complexity src/
# Complexity Report:
# File                              | Cyclomatic | Lines | Rating
# ----------------------------------|------------|-------|-------
# order.service.ts                  | 23         | 450   | D
# payment.service.ts                | 18         | 320   | C
# user.service.ts                   | 12         | 180   | B
# notification.service.ts           | 8          | 120   | A
# ...
# Average complexity: 15.2 (C)
# Recommendation: Refactor order.service.ts (complexity > 20)

# Changelog generation
claudekit changelog --from v1.2.0 --to HEAD
# # Changelog v1.3.0
#
# ## Features
# - Add recurring orders functionality (#145)
# - Implement email notification templates (#148)
# - Add export to CSV for reports (#152)
#
# ## Bug Fixes
# - Fix login timeout on slow connections (#143)
# - Resolve pagination issue in order list (#147)
#
# ## Improvements
# - Optimize database queries for order search (#150)
# - Update dependencies to latest versions (#151)

# Installation
cargo install ccometixline

# Configuration in .bashrc or .zshrc
eval "$(ccometixline init bash)"  # For Bash
eval "$(ccometixline init zsh)"   # For Zsh

# Output in the prompt:
# [claude:opus-4|12.5k tokens|$0.25] main* ~/my-project $

# Customization
# ~/.config/ccometixline/config.toml
[display]
show_model = true
show_tokens = true
show_cost = true
show_git_branch = true
show_session_duration = true

[colors]
model = "cyan"
tokens = "yellow"
cost = "green"
git = "magenta"
duration = "white"

[thresholds]
token_warning = 50000     # Yellow above 50k tokens
token_danger = 100000     # Red above 100k tokens
cost_warning = 2.00       # Yellow above $2
cost_danger = 5.00        # Red above $5

#!/bin/bash
# daily-productivity-report.sh
# Generate a daily productivity report

echo "=== Claude Code Productivity Report ==="
echo "Date: $(date +%Y-%m-%d)"
echo ""

# 1. Today's token usage
echo "--- Token Usage ---"
cc-usage today
echo ""

# 2. Today's sessions
echo "--- Sessions ---"
cc-sessions list --today
echo ""

# 3. Files modified with Claude Code today
echo "--- Files Changed ---"
git log --since="today" --name-only --pretty=format: | sort -u | head -20
echo ""

# 4. AI-assisted commits
echo "--- AI-Assisted Commits ---"
git log --since="today" --oneline | wc -l
echo "commits today"
echo ""

# 5. Tests generated
echo "--- Tests Generated ---"
git log --since="today" --name-only --pretty=format: | grep -c "\.spec\.\|\.test\.\|Test\.java"
echo "test files created/modified"
echo ""

# 6. Estimated time savings
echo "--- Time Savings Estimate ---"
COMMITS=$(git log --since="today" --oneline | wc -l)
FILES=$(git log --since="today" --name-only --pretty=format: | sort -u | wc -l)
TESTS=$(git log --since="today" --name-only --pretty=format: | grep -c "\.spec\.\|\.test\.\|Test\.java")

# Conservative estimate: 20 min saved per file, 30 min per test
SAVED_MINUTES=$(( (FILES * 20) + (TESTS * 30) ))
echo "Estimated time saved: ${SAVED_MINUTES} minutes (~$(( SAVED_MINUTES / 60 )) hours)"
echo ""

# 7. Estimated cost
echo "--- Estimated Cost ---"
cc-usage today --cost-only
echo ""

echo "=== End of Report ==="