Skip to main content

No project description provided

Project description

Copcon 🐎

Copcon (Copy Context) is a CLI tool designed to rapidly capture and summarize code context for use in large language model (LLM) based chatbots like Claude and ChatGPT.

Just point the copcon command at a directory, and all the LLM needs to know about your code is copied to your clipboard, ready to fire into ChatGPT with CTRL+V 🐎

Why Copcon?

  • 🚀 Speed Up Your Workflow: No more manual explanations of your project structure.
  • 🎯 Get More Accurate AI Responses: Provide complete context in seconds.
  • 🧠 Enhance AI Understanding: Help AI understand your specific codebase instantly.

Features

  • Generate a directory tree structure
  • Capture file contents
  • Customizable depth for directory traversal
  • Ability to exclude hidden files and directories
  • Option to ignore specific directories and files
  • Copies the generated report to the clipboard

Quick Start

  1. Install: pip install copcon
  2. Run: copcon /path/to/your/project
  3. Paste the result into your AI chat

Usage

After installation, you can use the copcon command:

copcon /path/to/your/directory

Options:

  • --depth INTEGER: Depth of directory tree to display (-1 for unlimited)
  • --exclude-hidden / --no-exclude-hidden: Exclude hidden files and directories (default: True)
  • --ignore-dirs TEXT: Additional directories to ignore (can be used multiple times)
  • --ignore-files TEXT: Additional files to ignore (can be used multiple times)

For help, use:

copcon --help

By default, Copcon ignores the following directories: __pycache__, .venv, node_modules, .git, .idea, .vscode, build, dist, target

And the following files: poetry.lock, package-lock.json, Cargo.lock, .DS_Store, yarn.lock

You can add more directories or files to ignore using the --ignore-dirs and --ignore-files options:

copcon /path/to/your/directory --ignore-dirs my_ignore_dir --ignore-files my_ignore_file.txt

Note

This tool is designed for macOS and Windows.

Development

To set up the development environment:

  1. Ensure you have Python 3.11+ and Poetry installed
  2. Clone the repository
  3. Run poetry install to install dependencies

Contributing

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

License

This project is licensed under the MIT License.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

copcon-0.2.1.tar.gz (3.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

copcon-0.2.1-py3-none-any.whl (4.4 kB view details)

Uploaded Python 3

File details

Details for the file copcon-0.2.1.tar.gz.

File metadata

  • Download URL: copcon-0.2.1.tar.gz
  • Upload date:
  • Size: 3.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.3 CPython/3.11.8 Darwin/23.5.0

File hashes

Hashes for copcon-0.2.1.tar.gz
Algorithm Hash digest
SHA256 91b753ec1c91920981a7fdcc82e136934f1b15af2b5d29b9b05e013cffec5f53
MD5 b70c58e3f0aacbd602e479efcce31019
BLAKE2b-256 02fcd3da06a4e376f5bcefdb676aeda0ff035081afc091294236be8d89230eab

See more details on using hashes here.

File details

Details for the file copcon-0.2.1-py3-none-any.whl.

File metadata

  • Download URL: copcon-0.2.1-py3-none-any.whl
  • Upload date:
  • Size: 4.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.3 CPython/3.11.8 Darwin/23.5.0

File hashes

Hashes for copcon-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 7b1855461c9245d24ec178d8423b8c9b773038a73813490d4217b0933043b852
MD5 428ac0f46660b389a43d2e009582a201
BLAKE2b-256 7399678706624f784d69665ec34bde62812c1c08a639bb776ee30d7db4304eac

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page