quiche-lorraine/code-context

CLI standalone qui génère un contexte de codebase (JSON + Markdown) destiné aux agents IA.

v1.1.1 2026-05-22 10:59 UTC

Requires

• php: >=8.2
• ext-json: *
• nikic/php-parser: ^5
• symfony/config: ^6.4 || ^7 || ^8
• symfony/console: ^6.4 || ^7 || ^8
• symfony/filesystem: ^6.4 || ^7 || ^8
• symfony/finder: ^6.4 || ^7 || ^8
• symfony/yaml: ^6.4 || ^7 || ^8

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.89
• phpstan/phpstan: ^2.1
• phpunit/phpunit: ^11.5

MIT

• symfony
• php
• cli
• Context
• development
• dev
• ai
• mcp
• model-context-protocol
• code-analysis
• ai-agent

README

Standalone CLI (built on symfony/console) that analyses a PHP codebase and produces a context folder for AI agents, consisting of a structured context.json and several agent-oriented .md files.

Status: Phase 2 in progress. The foundation is operational: init, generate, serve commands, strict config validation, extractor architecture, Symfony detection, thematic .md files.

Installation

composer require --dev quiche-lorraine/code-context

Then initialise the agent configuration:

vendor/bin/code-context init --agent=mcp         # merge .mcp.json (preserves other servers)
vendor/bin/code-context init --agent=claude-code  # writes .claude/settings.json + rebuild hook
vendor/bin/code-context init --agent=cursor       # writes .cursor/rules/code-context.md
vendor/bin/code-context init --agent=all          # all three agents at once

Then generate the first index:

vendor/bin/code-context generate

init --agent command

vendor/bin/code-context init --agent=mcp         # merge into .mcp.json (preserves other servers)
vendor/bin/code-context init --agent=claude-code  # writes .claude/settings.json + hook (skipped if already present)
vendor/bin/code-context init --agent=cursor       # writes .cursor/rules/code-context.md (skipped if already present)
vendor/bin/code-context init --agent=all          # all agents
vendor/bin/code-context init --agent=mcp --dry-run  # prints the result without writing

MCP merge is idempotent: a second run is a no-op if the config is already up to date.

For --agent=claude-code and --agent=cursor: if the target file already exists, the command leaves it untouched (no clobber).

Projects with an existing session-start.sh: add the hook call from your orchestrator:

if [ -x .claude/hooks/code-context-rebuild.sh ]; then
    .claude/hooks/code-context-rebuild.sh
fi

Usage

Main options:

• generate --config=PATH: path to a code-context.yaml file.
• generate --output=DIR: overrides output.directory from the YAML.
• generate --cwd=DIR: analyse a directory other than the current working directory.

Output generated in <output.directory> (default .code-context/):

• context.json: structured representation consumed by the MCP server.
• AGENTS.md: narrative view grouped by namespace.
• architecture.md, routes.md, entities.md, services.md, commands.md: specialised Symfony views.

SessionStart Hook (Claude Code)

The .claude/hooks/code-context-rebuild.sh file (installed by init --agent=claude-code) rebuilds the index at every Claude Code session start.

Architecture

bin/code-context           Symfony Console entrypoint
src/
    Application.php
    Command/
        InitCommand        init --agent=mcp|claude-code|cursor|all + legacy yaml init
        GenerateCommand    Orchestrates scan + extractors + renderers
        ServeCommand       MCP stdio server
    Config/
        Config             Immutable value object
        ConfigLoader       default.yaml + user override + validation
        ConfigSchema       Strict schema via symfony/config
    Detector/
        SymfonyDetector    Symfony framework detection
    Extractor/             ComposerExtractor, PhpStructureExtractor, SymfonyExtractor, ...
    Kernel/
        ProjectContext     Target project path resolution
    Mcp/
        McpManifestMerger  Non-destructive merge of .mcp.json (idempotent)
        MergeResult        Merge result DTO
    Scanner/
        FileScanner        Discovery via symfony/finder
    Analyzer/
        PhpAstAnalyzer     AST via nikic/php-parser
    Model/                 Immutable DTOs: Context, ClassInfo, MethodInfo, ...
    Renderer/
        JsonRenderer       context.json
        Markdown/          AGENTS.md, architecture.md, routes.md, etc.
    Output/
        OutputWriter       Writes to disk
config/
    default.yaml           Bundled default configuration
recipes/
    quiche-lorraine/code-context/1.0/
        manifest.json      gitignore /.code-context/, copies hook + cursor rules
        .claude/           settings.json + hooks/code-context-rebuild.sh
        .cursor/           rules/code-context.md
    quiche-lorraine/code-context/dev-main/
        manifest.json      (same, for installation from the main branch)
resources/agents/
    claude-code/           Source for init --agent=claude-code
    cursor/                Source for init --agent=cursor

Code quality

• composer test (PHPUnit)
• composer lint (PHPStan)
• composer fix (php-cs-fixer)