context-dump 0.1.0

Dump a project's source files into a single Markdown file for sharing with LLMs.

context-dump

Dump a project's source files into one Markdown file, ready to paste into an LLM. Respects .gitignore and never re-includes its own output on re-runs.

Install

pip install .

This registers the context-dump command.

Use

# Dump the current directory
context-dump .

# Dump specific paths
context-dump src/ README.md pyproject.toml

# Custom output file
context-dump . -o my_dump.md

# Ignore .gitignore (include everything the filters allow)
context-dump . --no-gitignore

# Plain text instead of Markdown
context-dump . --format txt

By default the output is written to AI_CONTEXT_<stems>.md in the current working directory. For context-dump . that's AI_CONTEXT_..md — usually you want to override with -o, e.g. context-dump . -o context.md.

What it filters

Layered filters, evaluated in order:

1. Hard-ignored dirs/files (IGNORE_DIRS / IGNORE_FILES in ai_context/config.py) — node_modules, .git, build outputs, lockfiles, etc.
2. .gitignore — patterns from the repo's .gitignore (and parent .gitignore files up to the .git boundary) are applied on top.
3. Include filter (INCLUDE_EXTENSIONS / INCLUDE_FILENAMES) — only these extensions/filenames appear in the tree at all. Empty both = include everything that survived step 2.
4. Content hiding (HIDE_CONTENT_FOR or ONLY_SHOW_CONTENT_FOR) — file appears in the tree, but its body is hidden. Mutually exclusive.

Self-exclusion

Re-running context-dump will not include the previous dump in the next one (unless you pass --include-self). Without this, every run would grow the file by its own previous size — guaranteed to hit the size cap eventually.

Configuration

Edit src/ai_context/config.py to change defaults: include filters, ignore patterns, max file size, format, etc. CLI flags override per-run.

Layout

ai_context_project/
├── pyproject.toml
├── README.md
└── src/
    └── ai_context/
        ├── __init__.py
        ├── config.py      # editable defaults
        ├── walker.py      # filesystem traversal + .gitignore
        ├── render.py      # tree, manifest, fenced file dump
        └── cli.py         # `context-dump` entry point
```"# context-dump"

#\x00 \x00c\x00o\x00n\x00t\x00e\x00x\x00t\x00-\x00d\x00u\x00m\x00p\x00 \x00 \x00