contextking

contextking converts any local project folder or git repository into an LLM-friendly context dump — a structured context/ folder with a file map, symbol index, and per-file markdown snapshots ready to paste into any AI tool.

Install

npm install -g contextking

Usage

codecontext [target] [options]

Arguments:

| Argument | Description | |----------|-------------| | target | Local folder path or git URL (optional — prompted interactively if omitted) |

Options:

| Flag | Description | |------|-------------| | -h, --help | Show help | | -v, --version | Show version | | -o, --out <dir> | Output directory (default: <target>/context) | | --types <csv> | Comma-separated extensions to include, e.g. .js,.ts,.py or * | | --max-size <kb> | Per-file size cap in KB (default: 128) | | --include-hidden | Include hidden files/folders | | --no-interactive | Skip prompts; use defaults / flags |

Examples

# Interactive mode — prompts for target and file types
codecontext

# Dump a local folder non-interactively
codecontext ./my-project --no-interactive

# Clone a git repo and dump it
codecontext https://github.com/user/repo --no-interactive

# Only include JS/TS files, cap at 64 KB per file
codecontext ./my-project --types .js,.ts --max-size 64

Output

Running codecontext produces a context/ folder (or the directory you specify with --out) containing:

| File | Description | |------|-------------| | README.md | Summary: frameworks, file count, byte count, token estimate | | map.md | File tree annotated with symbol counts | | mapping.json | Machine-readable file → symbols index | | mapping.md | Human-readable version of the symbol index | | dump/ | One .md per source file with extracted symbols + full source |

Supported Languages

JavaScript / TypeScript · Python · Dart · Go · Rust · Java · Kotlin · Swift · C / C++ · C# · Ruby · PHP · HTML / CSS / Vue / Svelte · Config files (JSON, YAML, TOML, Markdown) · Shell scripts

License

MIT © Aravind Chowdary Kamani