pycmdc

Tired of Cmd+C'ing your way though files to feed your LLMs code context? Use cmdc instead to browse, grab, and format your code with style. Stop the manual copy-paste madness.

Features

• Flexible Output: Copies to clipboard by default, supports console, and file output
• Directory Browser: Visual tree structure for easy directory navigation
• File Search: Fast file search and selection with fuzzy matching
• LLM-Ready Format: Structured output with XML-style tags
• Token Counting: Built-in token counter for LLM context awareness
• Smart Ignore Rules: Automatic parsing of project's .gitignore files
• Customizable: Configurable ignore patterns and file filters

Installation

Install using pip:

pip install pycmdc

Quick Start

1. Navigate to your project directory:

cd your-project

2. Run cmdc:

cmdc

This will open an interactive file browser where you can:

• Navigate using arrow keys (↑/↓)
• Toggle selection using arrow keys (←/→)
• Search files by typing
• Select all files using Ctrl+A
• Toggle all selections using Ctrl+D
• Confirm selection with Enter
• Selected files will be structured and copied to your clipboard

Usage

Basic Commands

# Browse current directory
cmdc

# Browse specific directory
cmdc /path/to/directory

# Configure cmdc
cmdc --config

# Show help
cmdc --help

Advanced Options

# Filter by file extensions
cmdc --filters .py .js .ts

# Ignore specific patterns (combines with .gitignore rules)
cmdc --ignore "node_modules" "*.pyc"

# Disable .gitignore parsing
cmdc --no-gitignore

# Recursive directory traversal
cmdc --recursive

# Set maximum directory depth
cmdc --depth 2

# Save output to file
cmdc --output output.txt

# Non-interactive mode (select all matching files)
cmdc --non-interactive

Configuration

Run the configuration wizard:

cmdc --config

Show current configuration:

cmdc --config-show

List ignore patterns:

cmdc --list-ignore

Add new ignore patterns:

cmdc --add-ignore "*.log" "temp/*"

Output Format

cmdc generates structured output in an XML-like format:

<summary>
<selected_files>
file1.py
file2.js
</selected_files>
<directory_structure>
your-project/
├── file1.py
├── file2.js
└── src/
    └── other.py
</directory_structure>
</summary>

<open_file>
file1.py
<contents>
# Content of file1.py
</contents>
</open_file>

<open_file>
file2.js
<contents>
// Content of file2.js
</contents>
</open_file>

Configuration File

The configuration file is stored in:

• Linux/macOS: ~/.config/cmdc/config.toml
• Windows: %APPDATA%\cmdc\config.toml

Example configuration:

[cmdc]
recursive = false
depth = 3
copy_to_clipboard = true
print_to_console = false
use_gitignore = true
ignore_patterns = [ ".git", "node_modules", "__pycache__", "*.pyc", "venv", ".venv", "env", ".env", ".idea", ".vscode", ".pytest_cache", ".ruff_cache", ".mypy_cache", ".cache", ".DS_Store"]
filters = [".py", ".md"]
tiktoken_model = "o200k_base"

Environment Variables

You can override configuration using environment variables:

• CMDC_FILTERS: Comma-separated list of file extensions
• CMDC_IGNORE: Comma-separated list of ignore patterns
• CMDC_RECURSIVE: Set to "true" for recursive mode
• CMDC_COPY_CLIPBOARD: Set to "true" to enable clipboard copy
• CMDC_USE_GITIGNORE: Set to "true" to use .gitignore patterns

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.