{"id":31828372,"url":"https://github.com/unclecode/ccat4ai","last_synced_at":"2025-10-11T19:29:00.169Z","repository":{"id":280013335,"uuid":"940748699","full_name":"unclecode/ccat4ai","owner":"unclecode","description":"Fast, simple tool to concatenate Git repositories into single files for LLM analysis","archived":false,"fork":false,"pushed_at":"2025-03-02T03:25:51.000Z","size":26,"stargazers_count":18,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-06T10:57:48.391Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/unclecode.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-28T18:08:16.000Z","updated_at":"2025-10-04T14:03:54.000Z","dependencies_parsed_at":"2025-03-01T15:35:25.599Z","dependency_job_id":null,"html_url":"https://github.com/unclecode/ccat4ai","commit_stats":null,"previous_names":["unclecode/ccat4ai","unclecode/ccode4ai"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/unclecode/ccat4ai","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unclecode%2Fccat4ai","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unclecode%2Fccat4ai/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unclecode%2Fccat4ai/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unclecode%2Fccat4ai/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/unclecode","download_url":"https://codeload.github.com/unclecode/ccat4ai/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/unclecode%2Fccat4ai/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279008424,"owners_count":26084460,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-11T02:00:06.511Z","response_time":55,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-10-11T19:28:52.758Z","updated_at":"2025-10-11T19:29:00.161Z","avatar_url":"https://github.com/unclecode.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# CodeCat4AI (ccat)\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Bash](https://img.shields.io/badge/Shell-Bash-blue.svg)](https://www.gnu.org/software/bash/)\n[![Twitter Follow](https://img.shields.io/twitter/follow/unclecode?style=social)](https://twitter.com/unclecode)\n\nA lightning-fast tool to concatenate entire repositories into markdown files for AI processing.\n\n\u003e **🌟 SPECIAL ANNOUNCEMENT 🌟**  \n\u003e **If this repository reaches 1000 stars in 7 days, I will make CodeCat4AI available as a free online service accessible via a single link!**  \n\u003e *Show your support by starring this repo if you find it useful!*\n\n## Why CodeCat4AI?\n\nI noticed people keep looking for tools to convert a repo into one file to attach to their favorite LLM. Finding no simple solution, I created this 5-line bash script to do the job efficiently!\n\n## Features\n\n- **Fast**: Quickly processes repositories of any size\n- **Simple**: Just a 5-line bash script - no complex dependencies\n- **Flexible**: Works with both remote and local repositories\n- **Smart**: Automatically detects text files\n- **Dual Output**: Generates both full and compact versions\n- **Clean**: Handles temporary files and cleanup automatically\n\n## Installation\n\n### Using Homebrew (macOS)\n\n```bash\n# Install from Homebrew\nbrew tap unclecode/ccat4ai\nbrew install ccat4ai\n```\n\nThis will install the tool as `ccat4ai`.\n\n## Usage\n\n```bash\n# Basic usage - output defaults to \"codebase\"\nccat4ai [repository_url_or_path] [output_name]\n```\n\nThe second parameter `[output_name]` is optional and defaults to `codebase` if not provided.\n\n### Local vs Remote Repositories\n\n- If a URL is provided (starts with http://, https://, or git@), the tool clones the repository temporarily\n- If just a name is provided (like \"crawl4ai\"), the tool assumes it's a local directory in the current path\n- If a path is provided, the tool uses that local repository\n\n### Examples\n\n```bash\n# Process a remote repository with custom output name\nccat4ai https://github.com/unclecode/crawl4ai crawl4ai\n\n# Process a remote repository with default output name\n# Creates codebase.md and mini.codebase.md\nccat4ai https://github.com/unclecode/crawl4ai\n\n# Process a local repository by name (if in current directory)\nccat4ai crawl4ai\n\n# Process a local repository by path\nccat4ai ~/projects/crawl4ai\n```\n\n### Output\n\nThe tool generates two files:\n- `[output_name].md` - Full version with all text files concatenated\n- `mini.[output_name].md` - Compact version with only function/class definitions\n\nBoth files include a directory tree structure at the end.\n\n### Using a Shorter Command Name\n\nAfter installation, you can create a shorter `ccat` command if preferred:\n\n```bash\n# Create ~/bin directory if it doesn't exist\nmkdir -p ~/bin\n\n# Create the symlink\nln -sf $(which ccat4ai) ~/bin/ccat\n\n# Add ~/bin to your PATH (if not already done)\necho 'export PATH=\"$HOME/bin:$PATH\"' \u003e\u003e ~/.zshrc  # or ~/.bashrc\n\n# Apply changes to current terminal\nsource ~/.zshrc  # or ~/.bashrc\n```\n\nThen you can use the shorter command:\n```bash\nccat https://github.com/unclecode/crawl4ai output-name\n```\n\n## Manual Installation\n\nYou can also download and use the script directly without Homebrew:\n\n```bash\n# Clone the repository\ngit clone https://github.com/unclecode/ccat4ai.git\n\n# Option 1: Run directly from the cloned directory\ncd ccat4ai\nchmod +x ccat.sh\n./ccat.sh https://github.com/user/repo output-name\n\n# Option 2: Create a symlink in your bin directory\nmkdir -p ~/bin\nln -sf \"$(pwd)/ccat.sh\" ~/bin/ccat4ai\necho 'export PATH=\"$HOME/bin:$PATH\"' \u003e\u003e ~/.zshrc  # or ~/.bashrc\nsource ~/.zshrc  # or ~/.bashrc\n```\n\n## Uninstallation\n\n```bash\n# If installed with Homebrew\nbrew uninstall ccat4ai\nbrew untap unclecode/ccat4ai\n\n# If you created a symlink\nrm -f ~/bin/ccat4ai\nrm -f ~/bin/ccat  # If you created the shorter alias\n\n# For a complete cleanup, use our cleanup script:\ncurl -s https://raw.githubusercontent.com/unclecode/ccat4ai/main/cleanup-ccat4ai.sh | bash\n```\n\n\n### Examples\n\n```bash\n# Process a remote repository with custom output name\nccat4ai https://github.com/unclecode/crawl4ai crawl4ai\n\n# Process a remote repository with default output name\n# Creates codebase.md and mini.codebase.md\nccat4ai https://github.com/unclecode/crawl4ai\n\n# Process a local repository by name (if in current directory)\nccat4ai crawl4ai\n\n# Process a local repository by path\nccat4ai ~/projects/crawl4ai\n\n# If you created the ccat symlink:\nccat https://github.com/unclecode/crawl4ai\n```\n\n### Output\n\nThe tool generates two files:\n- `[output_name].md` - Full version with all text files concatenated\n- `mini.[output_name].md` - Compact version with only function/class definitions\n\nBoth files include a directory tree structure at the end.\n\n## About the Author\n\nCreated by [Unclecode](https://github.com/unclecode), author of the popular [Crawl4AI](https://github.com/unclecode/crawl4ai) library.\n\nIf you find this tool useful, please ⭐ [CodeCat4AI](https://github.com/unclecode/ccat4ai) and [Crawl4AI](https://github.com/unclecode/crawl4ai) on GitHub!\n\n## License\n\nMIT","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Funclecode%2Fccat4ai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Funclecode%2Fccat4ai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Funclecode%2Fccat4ai/lists"}