Skip to content

Latest commit

 

History

History
 
 

scripts

README.md

Scripts

Utility scripts for Claude Code power users.

Overview

Script Description
audit-scan.sh Security and quality audit of Claude Code setup
check-claude.sh/.ps1 Health check for Claude Code installation
clean-reinstall-claude.sh/.ps1 Clean reinstall of Claude Code
fresh-context-loop.sh Run Claude Code in fresh context loops
session-search.sh Search across Claude Code session histories
session-stats.sh Statistics about Claude Code sessions
bridge.py Bridge: Claude Code → doobidoo → LM Studio

Bridge Script (Claude Code → LM Studio)

Purpose: Execute Claude Code plans locally via LM Studio for cost savings.

Architecture

┌──────────────┐     store_memory      ┌─────────────────┐
│ Claude Code  │ ─────────────────────►│    doobidoo     │
│   (Opus)     │   tag: "plan"         │   SQLite + Vec  │
│   PLANNER    │   status: "pending"   │ ~/.mcp-memory-  │
└──────────────┘                       │  service/       │
                                       └────────┬────────┘
                                                │
                                                │ Direct SQLite read
                                                ▼
                                       ┌─────────────────┐
                                       │   bridge.py     │
                                       │                 │
                                       │ • PlanReader    │
                                       │ • StepExecutor  │
                                       │ • Validator     │
                                       └────────┬────────┘
                                                │
                                                │ HTTP POST
                                                │ /v1/chat/completions
                                                ▼
                                       ┌─────────────────┐
                                       │    LM Studio    │
                                       │  localhost:1234 │
                                       └─────────────────┘

Requirements

pip install httpx
  • doobidoo MCP server with SQLite backend (~/.mcp-memory-service/)
  • LM Studio running on localhost:1234 with a loaded model

Usage

# Check LM Studio is running
python bridge.py --health

# List pending plans
python bridge.py --list

# Execute all pending plans
python bridge.py

# Execute specific plan
python bridge.py --plan plan_auth_refactor

# Verbose mode
python bridge.py -v

Workflow

1. Claude Code creates the plan

In Claude Code (Opus), store a plan via doobidoo:

store_memory("""
{
  "$schema": "bridge-plan-v1",
  "id": "plan_auth_refactor",
  "status": "pending",
  "context": {
    "project": "/path/to/project",
    "objective": "Refactor authentication to use JWT",
    "files_context": {
      "src/auth.py": "LOAD",
      "src/config.py": "REFERENCE"
    }
  },
  "steps": [
    {
      "id": 1,
      "type": "analysis",
      "description": "Analyze current auth implementation",
      "prompt": "Analyze the authentication code and identify migration points for JWT.",
      "validation": {"type": "non_empty"}
    },
    {
      "id": 2,
      "type": "code_generation",
      "description": "Generate JWT middleware",
      "prompt": "Generate a JWT authentication middleware based on the analysis.",
      "depends_on": [1],
      "validation": {"type": "syntax_check"},
      "file_output": "src/jwt_auth.py"
    }
  ]
}
""", tags=["plan"])

2. Execute via bridge

python bridge.py
# Reads plan from doobidoo SQLite
# Executes each step via LM Studio
# Stores results back in doobidoo

3. Retrieve results in Claude Code

search_by_tag(["result", "plan_auth_refactor"])
# Returns all execution results

Plan Schema

See bridge-plan-schema.json for the complete JSON Schema.

Field Required Description
$schema Yes Must be "bridge-plan-v1"
id Yes Unique plan ID (e.g., plan_auth_refactor)
status Yes pending, in_progress, completed, failed
context.objective Yes High-level goal description
context.project No Absolute path to project root
context.files_context No Files to inject (LOAD) or reference
steps Yes Array of execution steps

Step Types

Type Use Case
analysis Analyze code, identify patterns, plan changes
code_generation Generate new code from scratch
code_modification Modify existing code
decision Make architectural or design decisions

Validation Types

Type Description
non_empty Output is not empty (default)
json Valid JSON output
syntax_check Valid Python syntax
contains_keys JSON contains specific keys

Failure Handling

on_failure Behavior
retry_with_context Retry with error feedback (default)
skip Skip step, continue execution
halt Stop entire plan

Cost Savings

  • Planning (Opus): ~$0.50-2.00 per complex plan
  • Execution (LM Studio): Free (local)
  • ROI: 80-90% cost reduction on implementation tasks

Limitations

Limitation Mitigation
Local model quality varies Strict validation + retries
No MCP tools in LM Studio Inject file content in context
Limited context window Truncate old results
No streaming 120s timeout per step

Audit Scan

Security and quality audit of your Claude Code configuration.

./audit-scan.sh

Checks:

  • Sensitive data in CLAUDE.md files
  • Permission configurations
  • MCP server security
  • Hook script safety

Health Check

Quick verification of Claude Code installation.

# macOS/Linux
./check-claude.sh

# Windows
./check-claude.ps1

Clean Reinstall

Complete reinstall preserving configurations.

# macOS/Linux
./clean-reinstall-claude.sh

# Windows
./clean-reinstall-claude.ps1

Fresh Context Loop

Run Claude Code with fresh context for long-running tasks.

./fresh-context-loop.sh --iterations 5 --project /path/to/project

Session Search

Search across all Claude Code session histories.

./session-search.sh "authentication"

Session Stats

Get statistics about your Claude Code usage.

./session-stats.sh