cc-context-stats 1.3.0

package/install.sh

@@ -0,0 +1,272 @@
+#!/bin/bash
+#
+# Claude Code Status Line Installer
+# Installs and configures a status line for Claude Code
+#
+# Usage:
+#   Local:  ./install.sh
+#   Remote: curl -fsSL https://raw.githubusercontent.com/luongnv89/cc-context-stats/main/install.sh | bash
+#
+
+set -e
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[0;33m'
+BLUE='\033[0;34m'
+RESET='\033[0m'
+
+CLAUDE_DIR="$HOME/.claude"
+SETTINGS_FILE="$CLAUDE_DIR/settings.json"
+LOCAL_BIN="$HOME/.local/bin"
+
+# GitHub repository info for remote installation
+GITHUB_RAW_URL="https://raw.githubusercontent.com/luongnv89/cc-context-stats/main"
+GITHUB_API_URL="https://api.github.com/repos/luongnv89/cc-context-stats"
+
+# Detect if running from pipe (curl) or locally
+detect_install_mode() {
+    # Check if we have a valid script file with scripts directory
+    if [ -n "${BASH_SOURCE[0]}" ] && [ -f "${BASH_SOURCE[0]}" ]; then
+        SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+        if [ -d "$SCRIPT_DIR/scripts" ]; then
+            INSTALL_MODE="local"
+            INTERACTIVE=true
+            [ -t 0 ] || INTERACTIVE=false
+            return
+        fi
+    fi
+    # Running from curl/pipe or script directory not found
+    INSTALL_MODE="remote"
+    INTERACTIVE=false
+}
+
+echo -e "${BLUE}Claude Code Status Line Installer${RESET}"
+echo "=================================="
+echo
+
+detect_install_mode
+
+if [ "$INSTALL_MODE" = "remote" ]; then
+    echo -e "${YELLOW}Remote installation mode${RESET}"
+    echo "Downloading from GitHub..."
+    echo
+else
+    echo -e "${GREEN}Local installation mode${RESET}"
+    echo
+fi
+
+# Check for curl (required for remote installation)
+check_curl() {
+    if [ "$INSTALL_MODE" = "remote" ]; then
+        if ! command -v curl &>/dev/null; then
+            echo -e "${RED}Error: 'curl' is required for remote installation${RESET}"
+            exit 1
+        fi
+    fi
+}
+
+# Check for jq (required for bash scripts)
+check_jq() {
+    if ! command -v jq &>/dev/null; then
+        echo -e "${YELLOW}Warning: 'jq' is not installed.${RESET}"
+        echo "jq is required for bash status line scripts."
+        echo
+        if [[ "$OSTYPE" == "darwin"* ]]; then
+            echo "Install with: brew install jq"
+        else
+            echo "Install with: sudo apt install jq (Debian/Ubuntu)"
+            echo "         or: sudo yum install jq (RHEL/CentOS)"
+        fi
+        echo
+        if [ "$INTERACTIVE" = true ]; then
+            read -p "Continue anyway? (y/n) " -n 1 -r
+            echo
+            if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+                exit 1
+            fi
+        fi
+    else
+        echo -e "${GREEN}✓${RESET} jq is installed"
+    fi
+}
+
+# Download a file from GitHub
+download_file() {
+    local remote_path="$1"
+    local dest_path="$2"
+    local url="$GITHUB_RAW_URL/$remote_path"
+
+    if curl -fsSL "$url" -o "$dest_path"; then
+        chmod +x "$dest_path"
+        return 0
+    else
+        echo -e "${RED}Error: Failed to download $remote_path${RESET}"
+        return 1
+    fi
+}
+
+# Get latest commit hash from GitHub
+get_remote_commit_hash() {
+    local hash
+    hash=$(curl -fsSL "$GITHUB_API_URL/commits/main" 2>/dev/null | grep -m1 '"sha"' | cut -d'"' -f4 | head -c7)
+    echo "${hash:-unknown}"
+}
+
+# Set script to install (full featured bash script)
+select_script() {
+    SCRIPT_REMOTE="scripts/statusline-full.sh"
+    SCRIPT_NAME="statusline.sh"
+
+    if [ "$INSTALL_MODE" = "local" ]; then
+        SCRIPT_SRC="$SCRIPT_DIR/$SCRIPT_REMOTE"
+    fi
+}
+
+# Create .claude directory if needed
+ensure_claude_dir() {
+    if [ ! -d "$CLAUDE_DIR" ]; then
+        echo -e "${YELLOW}Creating $CLAUDE_DIR directory...${RESET}"
+        mkdir -p "$CLAUDE_DIR"
+    fi
+    echo -e "${GREEN}✓${RESET} Claude directory exists: $CLAUDE_DIR"
+}
+
+# Install/copy script
+install_script() {
+    DEST="$CLAUDE_DIR/$SCRIPT_NAME"
+
+    if [ "$INSTALL_MODE" = "local" ]; then
+        cp "$SCRIPT_SRC" "$DEST"
+        chmod +x "$DEST"
+    else
+        download_file "$SCRIPT_REMOTE" "$DEST"
+    fi
+    echo -e "${GREEN}✓${RESET} Installed: $DEST"
+}
+
+# Install context-stats CLI tool
+install_context_stats() {
+    # Create ~/.local/bin if it doesn't exist
+    if [ ! -d "$LOCAL_BIN" ]; then
+        mkdir -p "$LOCAL_BIN"
+    fi
+
+    DEST="$LOCAL_BIN/context-stats"
+
+    # Get commit hash for version embedding
+    local commit_hash
+    if [ "$INSTALL_MODE" = "local" ]; then
+        commit_hash=$(git -C "$SCRIPT_DIR" rev-parse --short HEAD 2>/dev/null || echo "unknown")
+        cp "$SCRIPT_DIR/scripts/context-stats.sh" "$DEST"
+    else
+        commit_hash=$(get_remote_commit_hash)
+        download_file "scripts/context-stats.sh" "$DEST"
+    fi
+
+    # Embed commit hash
+    sed -i.bak "s/COMMIT_HASH=\"dev\"/COMMIT_HASH=\"$commit_hash\"/" "$DEST" && rm -f "$DEST.bak"
+    chmod +x "$DEST"
+    echo -e "${GREEN}✓${RESET} Installed: $DEST"
+
+    # Check if ~/.local/bin is in PATH
+    if [[ ":$PATH:" != *":$LOCAL_BIN:"* ]]; then
+        echo
+        echo -e "${YELLOW}Note: $LOCAL_BIN is not in your PATH${RESET}"
+        echo "Add it to your shell configuration:"
+        echo
+        if [[ "$SHELL" == *"zsh"* ]]; then
+            echo "  echo 'export PATH=\"\$HOME/.local/bin:\$PATH\"' >> ~/.zshrc"
+            echo "  source ~/.zshrc"
+        else
+            echo "  echo 'export PATH=\"\$HOME/.local/bin:\$PATH\"' >> ~/.bashrc"
+            echo "  source ~/.bashrc"
+        fi
+    fi
+}
+
+# Create config file with defaults if it doesn't exist
+create_config() {
+    CONFIG_FILE="$CLAUDE_DIR/statusline.conf"
+
+    if [ -f "$CONFIG_FILE" ]; then
+        echo -e "${GREEN}✓${RESET} Config file exists: $CONFIG_FILE"
+        return
+    fi
+
+    cat >"$CONFIG_FILE" <<'EOF'
+# Autocompact setting - sync with Claude Code's /config
+autocompact=true
+
+# Token display format
+token_detail=true
+
+# Show token delta since last refresh (adds file I/O on every refresh)
+# Disable if you don't need it to reduce overhead
+show_delta=true
+
+# Show session_id in status line
+show_session=true
+EOF
+    echo -e "${GREEN}✓${RESET} Created config file: $CONFIG_FILE"
+}
+
+# Update settings.json
+update_settings() {
+    echo
+
+    # Create settings file if it doesn't exist
+    if [ ! -f "$SETTINGS_FILE" ]; then
+        echo '{}' >"$SETTINGS_FILE"
+        echo -e "${GREEN}✓${RESET} Created $SETTINGS_FILE"
+    fi
+
+    # Check if jq is available for JSON manipulation
+    if command -v jq &>/dev/null; then
+        # Backup existing settings
+        cp "$SETTINGS_FILE" "$SETTINGS_FILE.backup"
+
+        # Add/update statusLine configuration
+        SCRIPT_PATH="$HOME/.claude/$SCRIPT_NAME"
+        jq --arg cmd "$SCRIPT_PATH" '.statusLine = {"type": "command", "command": $cmd}' \
+            "$SETTINGS_FILE.backup" >"$SETTINGS_FILE"
+
+        rm "$SETTINGS_FILE.backup"
+        echo -e "${GREEN}✓${RESET} Updated settings.json with statusLine configuration"
+    else
+        echo -e "${YELLOW}Note: Could not update settings.json (jq not installed)${RESET}"
+        echo
+        echo "Please add this to $SETTINGS_FILE manually:"
+        echo
+        echo '  "statusLine": {'
+        echo '    "type": "command",'
+        echo "    \"command\": \"~/.claude/$SCRIPT_NAME\""
+        echo '  }'
+    fi
+}
+
+# Main installation
+main() {
+    check_curl
+    check_jq
+    ensure_claude_dir
+    select_script
+    install_script
+    install_context_stats
+    create_config
+    update_settings
+
+    echo
+    echo -e "${GREEN}Installation complete!${RESET}"
+    echo
+    echo "Your status line is now configured."
+    echo "Restart Claude Code to see the changes."
+    echo
+    echo "To customize, edit: $CLAUDE_DIR/$SCRIPT_NAME"
+    echo "To change settings, edit: $CLAUDE_DIR/statusline.conf"
+    echo
+    echo "Run 'context-stats' to visualize token usage for any session."
+}
+
+main

package/jest.config.js

@@ -0,0 +1,11 @@
+/** @type {import('jest').Config} */
+module.exports = {
+    testEnvironment: 'node',
+    testMatch: ['**/tests/node/**/*.test.js'],
+    collectCoverageFrom: ['scripts/statusline.js'],
+    coverageDirectory: 'coverage/node',
+    coverageReporters: ['text', 'lcov', 'html'],
+    modulePathIgnorePatterns: ['<rootDir>/tests/fixtures/'],
+    verbose: true,
+    testTimeout: 10000,
+};

package/npm-publish.sh

@@ -0,0 +1,33 @@
+#!/bin/bash
+
+if [ $# -eq 0 ]; then
+    echo "❌ Error: Please provide your 6-digit OTP code"
+    echo ""
+    echo "Usage: ./npm-publish.sh 123456"
+    echo ""
+    echo "Get your code from Microsoft Authenticator app"
+    exit 1
+fi
+
+echo "🚀 Publishing cc-context-stats to npm..."
+echo "📦 Package: cc-context-stats@1.3.0"
+echo "🔐 Using OTP: $1"
+echo ""
+
+npm publish --otp=$1
+
+if [ $? -eq 0 ]; then
+    echo ""
+    echo "✅ SUCCESS! Package published to npm!"
+    echo "📦 Package name: cc-context-stats"
+    echo "📦 Version: 1.3.0"
+    echo "📦 Install with: npm install cc-context-stats"
+    echo "🌐 View at: https://www.npmjs.com/package/cc-context-stats"
+else
+    echo ""
+    echo "❌ FAILED! Publishing failed."
+    echo "💡 Tips:"
+    echo "   - Make sure your OTP code is current (changes every 30 seconds)"
+    echo "   - Double-check the 6-digit code"
+    echo "   - If you lost access, use a recovery code on npm website"
+fi

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "cc-context-stats",
+  "version": "1.3.0",
+  "description": "Custom status line scripts for Claude Code",
+  "main": "scripts/statusline.js",
+  "scripts": {
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint scripts/statusline.js",
+    "lint:fix": "eslint scripts/statusline.js --fix",
+    "format": "prettier --write 'scripts/*.js' '*.json' '*.md'",
+    "format:check": "prettier --check 'scripts/*.js' '*.json' '*.md'"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "statusline",
+    "terminal",
+    "cli"
+  ],
+  "author": "luongnv89",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/luongnv89/cc-context-stats.git"
+  },
+  "devDependencies": {
+    "eslint": "^8.56.0",
+    "jest": "^29.7.0",
+    "prettier": "^3.2.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/publish.sh

@@ -0,0 +1,24 @@
+#!/bin/bash
+
+echo "npm publish with OTP"
+echo "Usage: ./publish.sh <6-digit-otp-code>"
+echo ""
+
+if [ $# -eq 0 ]; then
+    echo "Please provide your 6-digit OTP code:"
+    echo "  ./publish.sh 123456"
+    exit 1
+fi
+
+echo "Publishing cc-context-stats to npm..."
+npm publish --otp=$1
+
+if [ $? -eq 0 ]; then
+    echo ""
+    echo "✅ Successfully published to npm!"
+    echo "Package: cc-context-stats@1.3.0"
+    echo "Install with: npm install cc-context-stats"
+else
+    echo ""
+    echo "❌ Publishing failed. Please check your OTP code."
+fi

package/pyproject.toml

@@ -0,0 +1,113 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "cc-context-stats"
+version = "1.3.0"
+description = "Never run out of context unexpectedly - monitor your session context in real-time"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.9"
+authors = [
+    { name = "Nguyen Luong", email = "luongnv89@gmail.com" }
+]
+keywords = [
+    "claude",
+    "claude-code",
+    "tokens",
+    "context-window",
+    "monitoring",
+    "visualization",
+    "cli",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Utilities",
+]
+dependencies = []
+
+[project.scripts]
+claude-statusline = "claude_statusline.cli.statusline:main"
+context-stats = "claude_statusline.cli.context_stats:main"
+
+[project.urls]
+Homepage = "https://github.com/luongnv89/cc-context-stats"
+Documentation = "https://github.com/luongnv89/cc-context-stats#readme"
+Repository = "https://github.com/luongnv89/cc-context-stats"
+Issues = "https://github.com/luongnv89/cc-context-stats/issues"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.4.0",
+    "pytest-cov>=4.1.0",
+    "ruff>=0.1.0",
+    "mypy>=1.7.0",
+    "build>=1.0.0",
+    "twine>=4.0.0",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/claude_statusline"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "/src",
+    "/README.md",
+    "/LICENSE",
+]
+
+[tool.ruff]
+target-version = "py39"
+line-length = 100
+src = ["src"]
+
+[tool.ruff.lint]
+select = [
+    "E",   # pycodestyle errors
+    "W",   # pycodestyle warnings
+    "F",   # Pyflakes
+    "I",   # isort
+    "B",   # flake8-bugbear
+    "C4",  # flake8-comprehensions
+    "UP",  # pyupgrade
+]
+ignore = ["E501"]  # line too long (handled by formatter)
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+
+[tool.mypy]
+python_version = "3.9"
+warn_return_any = true
+warn_unused_ignores = true
+strict_optional = true
+ignore_missing_imports = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests/python"]
+addopts = "-v --tb=short"
+python_files = ["test_*.py"]
+python_functions = ["test_*"]
+
+[tool.coverage.run]
+source = ["src/claude_statusline"]
+omit = ["tests/*"]
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "if __name__ == .__main__.:",
+]

package/requirements-dev.txt

@@ -0,0 +1,12 @@
+# Development dependencies for claude-statusline
+
+# Testing
+pytest>=7.4.0
+pytest-cov>=4.1.0
+
+# Linting and formatting
+ruff>=0.1.0
+mypy>=1.7.0
+
+# Pre-commit hooks
+pre-commit>=3.6.0