Download the PHP package gregpriday/copy-tree without Composer

Copy a Directory and Its Files to Your Clipboard with Ctree

Note: This tool is designed exclusively for MacOS and is not compatible with other operating systems.

Ctree is a command-line utility that effortlessly copies the structure and contents of a local directory or GitHub repository to your clipboard. It formats the output specifically for use with AI assistants such as Claude, ChatGPT, and Gemini, making it ideal for code analysis, generation, and sharing.

Features

• MacOS Integration:
  Seamless clipboard operations using native tools (pbcopy and osascript).

• GitHub Integration:
  Clone and cache GitHub repositories via URL for fast, offline access and updates.

• AI-Powered Capabilities:

  • Intelligent File Filtering:
    Use natural language descriptions to select relevant files.
  • Smart Filename Generation:
    Automatically generate clear, hyphenated filenames for saved output based on content analysis.

• Flexible Directory Management:

  • Dynamic Ruleset System:
    Configure inclusion/exclusion rules with a powerful JSON format.
  • Multiple Rulesets & Auto-detection:
    Define custom rulesets (e.g., frontend.json, backend.json) or let Ctree auto-detect settings for common project types (Laravel, SvelteKit, etc.).
• Versatile Output Options:
  • Copy directly to the clipboard.
  • Save output to a file (with AI-generated names if desired).
  • Display output in the console.
  • Stream output for piping.
  • Copy a reference to a temporary file (to work around clipboard limitations).

Prerequisites

• MacOS
• PHP 8.2 or higher
• Git (required for GitHub repository support)
• Composer

Installation

1. Install via Composer (globally):

2. Add Composer’s Global Bin to Your PATH:
   Edit your ~/.zshrc or ~/.bashrc and add:

3. (Optional) Configure AI Features:
   Create a .env file in ~/.copytree/ and add your OpenAI credentials:

   Replace your-api-key and your-org-id with your actual values.

Quick Start

• Copy the Current Directory:

• Copy from a GitHub Repository:

• Use AI to Filter Files:

Workflows

Ctree is designed to integrate into various development processes. Detailed workflows are available for:

• AI-Driven Design Workflow:
  Iterate on web designs with SvelteKit, Tailwind CSS, and Claude.

• AI-Assisted Development Workflow:
  Leverage AI for test-driven development, code generation, and managing large codebases.

• AI-Assisted Ruleset Creation Workflow:
  Create and refine JSON-based rulesets with AI support.

• AI-Powered Business Plan Development:
  Develop comprehensive business plans with in-depth market research and operational documentation.

Advanced Usage

GitHub Integration

Ctree caches GitHub repositories in ~/.copytree/cache for improved performance.

AI Features

Intelligent File Filtering

Filter files using natural language:

For more details, see AI Features Documentation.

Smart Filename Generation

Automatically generate descriptive filenames when saving output:

Output Options

• Display in Console:
  ctree --display

• Save to File (AI-generated name):
  ctree --output

• Specify Output File:
  ctree --output=my-output-file.txt

• Stream Output (for piping):
  ctree --stream

• Copy as Reference (temporary file):
  ctree --as-reference

Git Filtering

Focus on changes with Git-based options:

These options are ideal for sharing recent changes or reviewing specific updates.

Ruleset System

Ctree’s flexible ruleset system lets you precisely control file selection:

1. Configuration:
   Ctree creates a .ctree directory in your project to store ruleset configurations.

2. Multiple Named Rulesets:
   Define and use custom rulesets (e.g., frontend.json, backend.json).

3. Auto-detection:
   Ctree auto-selects appropriate rulesets for recognized project types (e.g., Laravel, SvelteKit).

To use a custom ruleset, run:

For more details, see:

• Ruleset Examples
• Writing Rulesets
• Fields and Operations Reference
• Using Multiple Rulesets

Directory Structure

Ctree uses the following directory structure for configuration and output:

Contributing

Contributions are welcome! Please note that this project is MacOS-only. To contribute:

1. Fork the repository.
2. Create a feature branch.
3. Make your changes.
4. Submit a pull request.

Testing

Run the tests with:

Security

If you discover any security issues, please email [email protected] rather than using the issue tracker.

License

This project is licensed under the MIT License. See LICENSE.md for details.