learn_bash_from_session_data 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,45 @@
+# learn_bash_from_session_data
+
+Learn bash from your Claude Code sessions. Extracts commands you've used, categorizes them, and generates an interactive HTML learning resource with quizzes.
+
+## Installation
+
+```bash
+npm install -g learn_bash_from_session_data
+```
+
+## Usage
+
+```bash
+# Analyze all sessions from current project
+learn-bash
+
+# Analyze last 5 sessions
+learn-bash -n 5
+
+# List available projects
+learn-bash --list
+
+# Process specific session file
+learn-bash --file ~/.claude/projects/.../session.jsonl
+
+# Custom output path
+learn-bash --output ./my-lessons.html
+```
+
+## Features
+
+- **Command Extraction**: Parses Claude Code session JSONL files
+- **Categorization**: Groups commands by category (Git, File System, Text Processing, etc.)
+- **Complexity Scoring**: Rates commands from 1-5 based on complexity
+- **Interactive Quizzes**: Test your knowledge with auto-generated quizzes
+- **Self-Contained HTML**: No external dependencies, works offline
+
+## Requirements
+
+- Node.js >= 14.0.0
+- Python >= 3.8
+
+## License
+
+MIT

package/bin/learn-bash.js

@@ -0,0 +1,328 @@
+#!/usr/bin/env node
+
+/**
+ * learn-bash CLI
+ * Learn bash from your Claude Code sessions - extracts commands and generates interactive HTML lessons
+ *
+ * Usage:
+ *   learn-bash [options]
+ *   learn-bash --list                    List available Claude Code projects
+ *   learn-bash --sessions 5              Process last 5 sessions from current project
+ *   learn-bash --file path/to/session    Process a specific session file
+ *   learn-bash --project "project-name"  Process sessions from a specific project
+ *   learn-bash --output ./my-lesson.html Specify output file location
+ *   learn-bash --no-open                 Don't auto-open the generated HTML
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { spawn, execSync } = require('child_process');
+const os = require('os');
+
+// ANSI color codes for terminal output
+const colors = {
+  reset: '\x1b[0m',
+  bright: '\x1b[1m',
+  red: '\x1b[31m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  blue: '\x1b[34m',
+  cyan: '\x1b[36m'
+};
+
+/**
+ * Parse command line arguments (minimist-style, no dependencies)
+ */
+function parseArgs(args) {
+  const result = {
+    _: [],
+    sessions: null,
+    file: null,
+    output: null,
+    list: false,
+    'no-open': false,
+    project: null,
+    help: false
+  };
+
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    const nextArg = args[i + 1];
+
+    if (arg === '--help' || arg === '-h') {
+      result.help = true;
+    } else if (arg === '--list' || arg === '-l') {
+      result.list = true;
+    } else if (arg === '--no-open') {
+      result['no-open'] = true;
+    } else if (arg === '--sessions' || arg === '-n') {
+      result.sessions = parseInt(nextArg, 10);
+      i++;
+    } else if (arg === '--file' || arg === '-f') {
+      result.file = nextArg;
+      i++;
+    } else if (arg === '--output' || arg === '-o') {
+      result.output = nextArg;
+      i++;
+    } else if (arg === '--project' || arg === '-p') {
+      result.project = nextArg;
+      i++;
+    } else if (!arg.startsWith('-')) {
+      result._.push(arg);
+    }
+  }
+
+  return result;
+}
+
+/**
+ * Print usage information
+ */
+function printHelp() {
+  console.log(`
+${colors.bright}${colors.cyan}learn-bash${colors.reset} - Learn bash from your Claude Code sessions
+
+${colors.bright}USAGE:${colors.reset}
+  learn-bash [options]
+
+${colors.bright}OPTIONS:${colors.reset}
+  -n, --sessions <count>   Number of recent sessions to process (default: all)
+  -f, --file <path>        Process a specific session file
+  -o, --output <path>      Output HTML file path (default: ./bash-lesson.html)
+  -p, --project <name>     Process sessions from a specific project
+  -l, --list               List available Claude Code projects
+      --no-open            Don't auto-open the generated HTML in browser
+  -h, --help               Show this help message
+
+${colors.bright}EXAMPLES:${colors.reset}
+  ${colors.green}learn-bash${colors.reset}                           Process all sessions from current project
+  ${colors.green}learn-bash -n 5${colors.reset}                      Process last 5 sessions
+  ${colors.green}learn-bash --list${colors.reset}                    List available projects
+  ${colors.green}learn-bash -p "my-project"${colors.reset}           Process sessions from specific project
+  ${colors.green}learn-bash -f ~/.claude/sessions/abc.json${colors.reset}
+  ${colors.green}learn-bash -o ./lesson.html --no-open${colors.reset}
+
+${colors.bright}SESSION LOCATION:${colors.reset}
+  Claude Code sessions are stored at: ${colors.yellow}~/.claude/projects/${colors.reset}
+`);
+}
+
+/**
+ * Get the Claude projects directory path
+ */
+function getClaudeProjectsDir() {
+  const homeDir = os.homedir();
+  return path.join(homeDir, '.claude', 'projects');
+}
+
+/**
+ * List available Claude Code projects
+ */
+function listProjects() {
+  const projectsDir = getClaudeProjectsDir();
+
+  if (!fs.existsSync(projectsDir)) {
+    console.log(`${colors.yellow}No Claude Code projects directory found at:${colors.reset}`);
+    console.log(`  ${projectsDir}`);
+    console.log(`\n${colors.cyan}Make sure you have used Claude Code at least once.${colors.reset}`);
+    return [];
+  }
+
+  const entries = fs.readdirSync(projectsDir, { withFileTypes: true });
+  const projects = entries
+    .filter(entry => entry.isDirectory())
+    .map(entry => {
+      const projectPath = path.join(projectsDir, entry.name);
+      const sessionsPath = path.join(projectPath, 'sessions');
+      let sessionCount = 0;
+
+      if (fs.existsSync(sessionsPath)) {
+        const sessions = fs.readdirSync(sessionsPath)
+          .filter(f => f.endsWith('.json') || f.endsWith('.jsonl'));
+        sessionCount = sessions.length;
+      }
+
+      return {
+        name: entry.name,
+        path: projectPath,
+        sessionCount
+      };
+    })
+    .filter(p => p.sessionCount > 0);
+
+  if (projects.length === 0) {
+    console.log(`${colors.yellow}No projects with sessions found.${colors.reset}`);
+    return [];
+  }
+
+  console.log(`\n${colors.bright}${colors.cyan}Available Claude Code Projects:${colors.reset}\n`);
+  projects.forEach((project, index) => {
+    console.log(`  ${colors.green}${index + 1}.${colors.reset} ${project.name}`);
+    console.log(`     ${colors.yellow}Sessions:${colors.reset} ${project.sessionCount}`);
+    console.log(`     ${colors.yellow}Path:${colors.reset} ${project.path}\n`);
+  });
+
+  return projects;
+}
+
+/**
+ * Check if Python 3 is available
+ */
+function checkPython() {
+  const pythonCommands = ['python3', 'python'];
+
+  for (const cmd of pythonCommands) {
+    try {
+      const version = execSync(`${cmd} --version 2>&1`, { encoding: 'utf8' });
+      if (version.includes('Python 3')) {
+        return cmd;
+      }
+    } catch (e) {
+      // Command not found, try next
+    }
+  }
+
+  return null;
+}
+
+/**
+ * Open a file in the default browser
+ */
+function openInBrowser(filePath) {
+  const platform = os.platform();
+  let cmd;
+  let args;
+
+  switch (platform) {
+    case 'darwin':
+      cmd = 'open';
+      args = [filePath];
+      break;
+    case 'win32':
+      cmd = 'cmd';
+      args = ['/c', 'start', '', filePath];
+      break;
+    default:
+      // Linux and others
+      cmd = 'xdg-open';
+      args = [filePath];
+  }
+
+  try {
+    spawn(cmd, args, { detached: true, stdio: 'ignore' }).unref();
+    return true;
+  } catch (e) {
+    return false;
+  }
+}
+
+/**
+ * Find the Python main.py script
+ */
+function findPythonScript() {
+  // Check relative to this script's location
+  const scriptDir = path.dirname(__filename);
+  const possiblePaths = [
+    path.join(scriptDir, '..', 'scripts', 'main.py'),
+    path.join(scriptDir, 'scripts', 'main.py'),
+    path.join(process.cwd(), 'scripts', 'main.py')
+  ];
+
+  for (const p of possiblePaths) {
+    if (fs.existsSync(p)) {
+      return path.resolve(p);
+    }
+  }
+
+  return null;
+}
+
+/**
+ * Main entry point
+ */
+function main() {
+  const args = parseArgs(process.argv.slice(2));
+
+  // Show help
+  if (args.help) {
+    printHelp();
+    process.exit(0);
+  }
+
+  // List projects
+  if (args.list) {
+    listProjects();
+    process.exit(0);
+  }
+
+  // Check Python availability
+  const pythonCmd = checkPython();
+  if (!pythonCmd) {
+    console.error(`${colors.red}${colors.bright}Error:${colors.reset} Python 3 is required but not found.`);
+    console.error(`Please install Python 3 from: ${colors.cyan}https://www.python.org/downloads/${colors.reset}`);
+    process.exit(1);
+  }
+
+  // Find the Python script
+  const pythonScript = findPythonScript();
+  if (!pythonScript) {
+    console.error(`${colors.red}${colors.bright}Error:${colors.reset} Could not find scripts/main.py`);
+    console.error(`Make sure you're running from the package directory or it's properly installed.`);
+    process.exit(1);
+  }
+
+  // Build Python script arguments
+  const pythonArgs = [pythonScript];
+
+  if (args.sessions) {
+    pythonArgs.push('--sessions', args.sessions.toString());
+  }
+
+  if (args.file) {
+    pythonArgs.push('--file', args.file);
+  }
+
+  if (args.output) {
+    pythonArgs.push('--output', args.output);
+  }
+
+  if (args.project) {
+    pythonArgs.push('--project', args.project);
+  }
+
+  // Default output path if not specified
+  const outputPath = args.output || path.join(process.cwd(), 'bash-lesson.html');
+
+  console.log(`\n${colors.bright}${colors.cyan}learn-bash${colors.reset} - Extracting bash commands from Claude Code sessions...\n`);
+
+  // Spawn Python process
+  const pythonProcess = spawn(pythonCmd, pythonArgs, {
+    stdio: 'inherit',
+    cwd: process.cwd()
+  });
+
+  pythonProcess.on('close', (code) => {
+    if (code === 0) {
+      console.log(`\n${colors.green}${colors.bright}Success!${colors.reset} Generated: ${colors.cyan}${outputPath}${colors.reset}`);
+
+      // Open in browser unless --no-open specified
+      if (!args['no-open'] && fs.existsSync(outputPath)) {
+        console.log(`${colors.yellow}Opening in browser...${colors.reset}`);
+        if (!openInBrowser(outputPath)) {
+          console.log(`${colors.yellow}Could not auto-open. Please open manually:${colors.reset} ${outputPath}`);
+        }
+      }
+    } else {
+      console.error(`\n${colors.red}${colors.bright}Error:${colors.reset} Python script exited with code ${code}`);
+      process.exit(code);
+    }
+  });
+
+  pythonProcess.on('error', (err) => {
+    console.error(`${colors.red}${colors.bright}Error:${colors.reset} Failed to start Python process:`, err.message);
+    process.exit(1);
+  });
+}
+
+// Run main
+main();

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "learn_bash_from_session_data",
+  "version": "1.0.0",
+  "description": "Learn bash from your Claude Code sessions - extracts commands and generates interactive HTML lessons",
+  "main": "bin/learn-bash.js",
+  "bin": {
+    "learn-bash": "./bin/learn-bash.js",
+    "bash-learner": "./bin/learn-bash.js"
+  },
+  "scripts": {
+    "test": "node tests/test-runner.js"
+  },
+  "keywords": ["bash", "learning", "claude", "cli", "terminal", "shell"],
+  "author": "",
+  "license": "MIT",
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bjpl/learn_bash_from_session_data"
+  }
+}

package/scripts/__init__.py

@@ -0,0 +1,34 @@
+"""
+Scripts package for learn_bash_from_session_data.
+
+Provides JSONL extraction and bash command parsing utilities.
+"""
+
+from .extractor import (
+    ExtractedCommand,
+    JSONLExtractor,
+    extract_commands_from_jsonl,
+    extract_commands_from_sessions,
+)
+
+from .parser import (
+    ParsedCommand,
+    CommandCategory,
+    BashParser,
+    parse_command,
+    parse_commands,
+)
+
+__all__ = [
+    # Extractor
+    "ExtractedCommand",
+    "JSONLExtractor",
+    "extract_commands_from_jsonl",
+    "extract_commands_from_sessions",
+    # Parser
+    "ParsedCommand",
+    "CommandCategory",
+    "BashParser",
+    "parse_command",
+    "parse_commands",
+]