CodeOS

A CLI tool that analyzes any codebase and automatically generates optimal Claude Code configuration. Uses file-pattern heuristics to detect language, framework, test runner, linter, and project structure, then generates a CLAUDE.md with composable trait-based instructions and managed blocks for safe re-runs.

The Problem

Setting up Claude Code for a new project requires tribal knowledge — which MCP servers to configure, what conventions to document, what commands to list. This setup is manual, inconsistent, and repeated for every project.

The Solution

CodeOS scans a codebase in milliseconds using file-pattern heuristics (no AST parsing, no network calls), builds a confidence-scored project manifest, and generates a tailored CLAUDE.md. Managed blocks with sentinel comments allow safe re-runs without clobbering manual additions.

Key Features

• Heuristic Scanner — detects 7+ languages, 10+ frameworks, package managers, test runners, linters, formatters, and CI systems from file patterns and dependencies
• Composable Trait System — generates CLAUDE.md from independent trait snippets, not rigid templates
• Managed Blocks — sentinel comments mark generated sections for safe updates on re-run
• Command Inference — extracts install, test, lint, format, build, and dev commands from detected tools
• Confidence Scoring — every detection includes confidence level and human-readable evidence
• Four CLI Commands — analyze (inspect), plan (preview), init (generate), doctor (validate)