✨ vibe — generate structured LLM context from your codebase in one command

Instead of manually opening files, copy-pasting their contents one by one, adding markdown formatting, describing every file, and stitching them into a prompt, vibe does it for you in a single command. vibe collects files from a given directory, processes their contents, and forms a structured markdown context.

By default, the generated context is printed to stdout, so you can pipe it or redirect it to a file. With -c/--copy it goes straight to your clipboard, so you can simply Ctrl+V it into your LLM prompt without any extra steps. It respects git (skips .git and files matched by .gitignore) and excludes package manager lock files by default.

Usage

Run vibe -c path/to/codedir/you/wanna/discuss/with/AI and the full structured description of all files and folders will be ready in your clipboard;) Or drop -c to print it to stdout, e.g. vibe src > context.md.

The help reference:

$ vibe --help
                                                                                
 Usage: vibe [OPTIONS] [path]                                                                               
                                                                                                            
 Generate structured LLM context from a directory or file.                                                  
                                                                                                            
 By default, prints to stdout, respects git and excludes package manager lock files.                        
                                                                                                            
 GLOB without '/' matches names at any depth; with '/' it matches paths relative to the target; '**' spans  
 dirs.                                                                                                      
                                                                                                            
╭─ Arguments ──────────────────────────────────────────────────────────────────────────────────────────────╮
│   path      <path>  Directory or file to build the context from. [default: .]                            │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Options ────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --copy           -c                         Copy the context to the clipboard instead of printing it.    │
│ --summary-only   -s                         Output only the summary, without file contents.              │
│ --git            -g  --no-git     -G        Respect git: skip the .git directory and files matched by    │
│                                             .gitignore.                                                  │
│                                             [default: git]                                               │
│ --binary         -b  --no-binary  -B        List binary (non-text) files in the summary.                 │
│                                             [default: binary]                                            │
│ --locks          -l  --no-locks   -L        Include package manager lock files. [default: no-locks]      │
│ --include        -i                   GLOB  Only include files matching GLOB or inside matching          │
│                                             directories, e.g. '*.py', 'src'. Repeatable.                 │
│ --exclude        -x                   GLOB  Skip files and directories matching GLOB, e.g. 'tests',      │
│                                             '*.svg', 'docs/*.md'. Repeatable.                            │
│ --max-file-size  -m                   SIZE  Omit contents of text files larger than SIZE, e.g. 500KB.    │
│                                             [default: 5MB]                                               │
│ --version        -V                         Show version and exit.                                       │
│ --help                                      Show this message and exit.                                  │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────╯

Installation

Just pip install show-me-your-vibe.

For MacOS and Windows it will work right out of the box.

For Linux (only needed for -c/--copy to access your clipboard) install a support lib according to the table below: