ScriptsApr 9, 2026·2 min read

ClaudeForge — Auto-Generate CLAUDE.md for Any Project

Generate and maintain CLAUDE.md files automatically. Scans your codebase, scores existing docs, and creates context-specific instruction files for Claude Code. MIT, 340+ stars.

SC
Script Depot · Community
Quick Use

Use it first, then decide how deep to go

This block should tell both the user and the agent what to copy, install, and apply first.

  1. Install ClaudeForge:
curl -fsSL https://raw.githubusercontent.com/alirezarezvani/ClaudeForge/main/install.sh | bash
  1. Run in your project root:
claudeforge generate
  1. Your CLAUDE.md is ready — Claude Code loads it automatically on next session.
Intro

ClaudeForge is an automated CLAUDE.md creation and maintenance tool with 340+ GitHub stars. It scans your codebase structure, analyzes your tech stack, and generates context-specific instruction files that tell Claude Code exactly how to work with your project. Best for teams adopting Claude Code who want consistent AI behavior across repos. Works with TypeScript, Python, Go, React, Vue, FastAPI, and more.

See also: Claude Code Skills collection on TokRepo for ready-made skill files.

ClaudeForge — Automated CLAUDE.md Creation & Maintenance

Why You Need This

Every Claude Code project benefits from a CLAUDE.md file — it tells the AI your project conventions, architecture, and coding standards. But writing one from scratch is tedious and error-prone. ClaudeForge automates the entire process.

Key Features

  • Interactive project exploration — scans directory structure, detects frameworks, identifies patterns
  • Quality scoring — rates existing CLAUDE.md files 0-100 and suggests improvements
  • Modular architecture — generates separate files for backend/, frontend/, database/ contexts
  • Background sync agent — automatically updates CLAUDE.md when your codebase changes
  • Tech stack templates — pre-built configurations for TypeScript, Python, Go, React, Vue, FastAPI
  • Adaptive complexity — adjusts output for solo developers vs. large teams

Installation

macOS/Linux:

curl -fsSL https://raw.githubusercontent.com/alirezarezvani/ClaudeForge/main/install.sh | bash

Windows (PowerShell):

iwr https://raw.githubusercontent.com/alirezarezvani/ClaudeForge/main/install.ps1 -useb | iex

Usage

# Generate CLAUDE.md for current project
claudeforge generate

# Score existing CLAUDE.md quality (0-100)
claudeforge score

# Generate context-specific files for subdirectories
claudeforge generate --modular

# Start background sync agent
claudeforge watch

What It Generates

  • Root CLAUDE.md navigation hub with project overview
  • Context-specific instruction files per directory
  • ASCII project structure diagrams
  • Setup and installation instructions
  • Architecture documentation
  • Tech stack specifications and coding conventions

FAQ

Q: What is ClaudeForge? A: ClaudeForge is an open-source CLI tool that automatically generates and maintains CLAUDE.md instruction files for Claude Code projects. It scans your codebase and creates context-aware AI guidelines.

Q: Is ClaudeForge free? A: Yes, ClaudeForge is free and open-source under the MIT license.

Q: Does ClaudeForge work with any programming language? A: Yes, it supports TypeScript, Python, Go, React, Vue, FastAPI, and auto-detects most common tech stacks.

🙏

Source & Thanks

Created by Alireza Rezvani. Licensed under MIT.

ClaudeForge — ⭐ 340+

Thanks to Alireza for building a tool that makes Claude Code adoption significantly easier.

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets

Great Expectations — Data Validation for AI Pipelines

Test your data like you test code. Validate data quality in AI/ML pipelines with expressive assertions, auto-profiling, and data docs. Apache-2.0, 11,400+ stars.

Script Depot

LLMLingua — Compress Prompts 20x with Minimal Loss

Microsoft research tool for prompt compression. Reduce token usage up to 20x while maintaining LLM performance. Solves lost-in-the-middle for RAG. MIT, 6,000+ stars.

Script Depot

TokenCost — LLM Price Calculator for 400+ Models

Client-side token counting and USD cost estimation for 400+ LLMs. 3 lines of Python to track prompt and completion costs. Supports OpenAI, Anthropic, Mistral, AWS Bedrock. MIT, 2K+ stars.

Script Depot
◈Home🔍Search👤Me