{"id":45905134,"url":"https://github.com/pipelex/cocode","last_synced_at":"2026-02-28T02:01:37.646Z","repository":{"id":304854482,"uuid":"1020299381","full_name":"Pipelex/cocode","owner":"Pipelex","description":"Cocode is the friend of your code, it is a powerful command-line tool for analyzing and processing code repositories. It converts repository structures and contents into text formats, extracts code interfaces, and performs software engineering analysis using AI-powered pipelines using Pipelex.","archived":false,"fork":false,"pushed_at":"2026-02-22T00:28:26.000Z","size":3262,"stargazers_count":17,"open_issues_count":3,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-22T08:38:32.342Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","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/Pipelex.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":"CLA.md"}},"created_at":"2025-07-15T16:42:30.000Z","updated_at":"2026-02-17T16:43:06.000Z","dependencies_parsed_at":"2025-07-16T16:15:28.903Z","dependency_job_id":"8f33e074-df4d-4b4b-9275-d5efd15cd8f5","html_url":"https://github.com/Pipelex/cocode","commit_stats":null,"previous_names":["pipelex/cocode"],"tags_count":26,"template":false,"template_full_name":"Pipelex/pipelex-starter","purl":"pkg:github/Pipelex/cocode","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pipelex%2Fcocode","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pipelex%2Fcocode/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pipelex%2Fcocode/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pipelex%2Fcocode/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Pipelex","download_url":"https://codeload.github.com/Pipelex/cocode/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Pipelex%2Fcocode/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29922710,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-27T19:37:42.220Z","status":"online","status_checked_at":"2026-02-28T02:00:07.010Z","response_time":90,"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":"2026-02-28T02:01:36.666Z","updated_at":"2026-02-28T02:01:37.640Z","avatar_url":"https://github.com/Pipelex.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Cocode ⚡️\n\n*Cocode is the friend of your code*\n\nCocode is a powerful command-line tool for analyzing and processing code repositories. It converts repository structures and contents into text formats, extracts code interfaces, and performs software engineering analysis using **AI-powered workflows** using [Pipelex](https://github.com/Pipelex/pipelex).\n\n\u003ch3 align=\"center\"\u003eCocode demo\u003c/h3\u003e\n  \u003cp align=\"center\"\u003e\n    \u003ca href=\"https://www.youtube.com/watch?v=T56MOkoZwm8\"\u003e\u003cimg src=\"https://raw.githubusercontent.com/Pipelex/cocode/main/.github/assets/demo-thumbnail.png\" alt=\"Cocode Demo\" width=\"600\" style=\"max-width: 100%; height: auto;\"\u003e\u003c/a\u003e\n  \u003c/p\u003e\n\n## 🚀 Main Features\n\n### 📝 **Automatic Documentation \u0026 Release Management**\nStreamline your documentation workflow with AI-powered automation:\n- **Automatic Changelog Generation**: Generate comprehensive changelogs from git diffs and version comparisons\n- **Smart Documentation Updates**: Automatically update docs and README files based on releases and code changes\n- **Documentation Proofreading**: Detect critical inconsistencies between documentation and actual codebase that could break user code\n\n## 📦 Installation\n\n```bash\npip install cocode\n```\n\nImportant: the current version of Cocode only works when run from the cocode directory.\n\n## 🔑 Get Your API Keys\n\nCocode's built-in AI workflows require access to AI models. To use the main features (changelog generation, documentation updates, proofreading), you need API keys for:\n\n- **Claude models** (Anthropic) - Required for changelog generation and documentation analysis\n- **Gemini models** (Google) - Required for documentation proofreading\n\nYou have several options:\n\n### Option 1: Free Pipelex API Key (Free)\nGet free access to all models with a single API key:\n- Join our [Discord community](https://go.pipelex.com/discord) \n- Request your **free API key** (no credit card required) in the [🔑・free-api-key](https://discord.com/channels/1369447918955921449/1418228010431025233) channel\n- Add it to your `.env` file: `PIPELEX_API_KEY=your-key-here`\n\n### Option 2: Bring Your Own API Keys\nUse your own API keys from AI providers:\n\n**Required for core features:**\n- Claude models - Use either:\n  - `ANTHROPIC_API_KEY` - Direct Anthropic API ([Get key](https://console.anthropic.com/))\n  - Amazon Bedrock - AWS credentials for Claude via Bedrock ([Setup guide](https://docs.pipelex.com/pages/configuration/config-technical/inference-backend-config/))\n- Google Cloud credentials - For Gemini models ([Setup guide](https://docs.pipelex.com/pages/build-reliable-ai-workflows-with-pipelex/ai-plugins-for-multi-llm-workflows/#4-google-vertex-ai-configuration))\n\nAdd these to your environment variables or in your `.env` file in your project root.\n\n### Option 3: Local AI\nYou can also use local models with Ollama, vLLM, or any OpenAI-compatible endpoint. See the [Pipelex configuration guide](https://docs.pipelex.com/pages/setup/configure-ai-providers/) for details.\n\n## ✅ Validation\n\n```bash\n# Verify setup and pipelines\ncocode validate\n```\n\n## 🛠️ Quick Start\n\n### Automatic Documentation \u0026 Release Features\n```bash\n# Update documentation based on code changes\ncocode doc update v1.0.0 path/to/your/local/repository\n\n# Proofread documentation against codebase\ncocode doc proofread --doc-dir docs path/to/your/local/repository\n\n# Generate changelog from version diff\ncocode changelog update v1.0.0 path/to/your/local/repository\n\n# Update AI instructions (AGENTS.md, CLAUDE.md, cursor rules) based on code changes\ncocode ai_instructions update v1.0.0 path/to/your/local/repository\n\n```\n\n### 📁 Output Location\n\nThe results of these commands will be saved in a `results` (default behavior) folder at the root of your project.\n\n### IDE extension\n\nWe **highly** recommend installing our own extension for PLX files into your IDE of choice. You can find it in the [Open VSX Registry](https://open-vsx.org/extension/Pipelex/pipelex). It's coming soon to VS Code marketplace too and if you are using Cursor, Windsurf or another VS Code fork, you can search for it directly in your extensions tab.\n\n## 🔧 Other Features\n\n### 🤖 **AI-Powered Software Engineering Analysis**\nLeverage AI pipelines for advanced code understanding:\n- Extract project fundamentals and architecture insights\n- Generate comprehensive onboarding documentation\n- Analyze software features and capabilities\n- Create structured development guides\n\n### 📊 **Repository Analysis**\nTransform entire repositories into structured, analyzable formats:\n- Convert codebases to text for AI processing and documentation\n- Extract directory structures and file contents\n- Filter by file types, paths, and patterns\n- Multiple output formats for different use cases\n\n### 🐍 **Smart Python Processing**\nIntelligent Python code analysis with multiple extraction modes:\n- **Interface Mode**: Extract class/function signatures and docstrings only\n- **Imports Mode**: Analyze dependencies and import relationships  \n- **Integral Mode**: Include complete source code\n\n### 🎯 **Flexible Output Formats**\nChoose the right format for your needs:\n- **Repo Map**: Complete tree structure with file contents\n- **Flat**: Clean content-only output\n- **Tree**: Directory structure visualization\n- **Import List**: Dependency analysis format\n\n### 🔗 **GitHub Integration**\nPowerful GitHub repository management features:\n- **Authentication**: Check and manage GitHub authentication status\n- **Repository Info**: Get detailed information about repositories\n- **Branch Management**: Check branches, list branches\n- **Label Sync**: Synchronize issue labels across repositories from JSON templates\n\n### GitHub Commands\n```bash\n# Check authentication status\ncocode github auth\n\n# Get repository information\ncocode github repo-info pipelex/cocode\n\n# Check if a branch exists\ncocode github check-branch pipelex/cocode feature-branch\n\n# List branches (with limit)\ncocode github list-branches pipelex/cocode --limit 20\n\n# Sync labels from JSON file\ncocode github sync-labels pipelex/cocode ./labels.json --dry-run\ncocode github sync-labels pipelex/cocode ./labels.json --delete-extra\n```\n\n### Commands for Other Features\n\n#### Code Analysis\n```bash\n# Analyze git diff with a specific prompt/query\ncocode analyze diff v1.0.0 --prompt \"What are the main architectural changes in this update?\"\n\n# Analyze security-related changes\ncocode analyze diff HEAD~10 --prompt \"Identify any security vulnerabilities or improvements\"\n\n# Analyze performance impacts\ncocode analyze diff main --prompt \"What changes might affect application performance?\"\n```\n\n## ⚠️ Limitations\n\nThis tool is in early development! There are many things to fix and improve. You may encounter bugs, incomplete features, or unexpected behavior. We're actively working on making Cocode more robust and user-friendly.\n\nIf you run into issues or have suggestions, please check our [GitHub Issues](https://github.com/Pipelex/cocode/issues) section to report problems or see what we're working on.\n\n#### Basic Repository Analysis\n```bash\n# Converts repositories into AI-readable text formats\ncocode repox convert\n\n# Analyze specific project\ncocode repox convert path/to/project --output-filename project-analysis.txt\n```\n\n#### Smart Code Extraction\n```bash\n# Extract Python interfaces only\ncocode repox convert --python-rule interface\n\n# Analyze import dependencies\ncocode repox convert --python-rule imports --output-style import_list\n```\n\n#### AI-Powered Analysis\n```bash\n# Extract project fundamentals\ncocode repo extract_fundamentals . --output-filename overview.json\n\n# Generate feature documentation\ncocode features extract ./analysis.txt --output-filename features.md\n```\n\n## 🔧 Configuration\n\nCocode integrates with the [Pipelex](https://github.com/Pipelex/pipelex) framework for AI pipeline processing. Configuration files control default settings, output directories, and pipeline behaviors.\n\nFor detailed command options and advanced usage, see [CLI_README.md](CLI_README.md).\n\n---\n\n## Contact \u0026 Support\n\n| Channel                                | Use case                                                                  |\n| -------------------------------------- | ------------------------------------------------------------------------- |\n| **GitHub Discussions → \"Show \u0026 Tell\"** | Share ideas, brainstorm, get early feedback.                              |\n| **GitHub Issues**                      | Report bugs or request features.                                          |\n| **Email (privacy \u0026 security)**         | [security@pipelex.com](mailto:security@pipelex.com)                       |\n| **Discord**                            | Real-time chat — [https://go.pipelex.com/discord](https://go.pipelex.com/discord) |\n\n## 📝 License\n\nThis project is licensed under the [MIT license](LICENSE). Runtime dependencies are distributed under their own licenses via PyPI.\n\n---\n\n*Happy coding!* 🚀\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpipelex%2Fcocode","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpipelex%2Fcocode","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpipelex%2Fcocode/lists"}