cokit-cli 1.0.1 → 1.0.2

package/skills/ck-repomix/references/usage-patterns.md

@@ -0,0 +1,232 @@
+# Usage Patterns
+
+Practical workflows and patterns for using Repomix in different scenarios.
+
+## AI Analysis Workflows
+
+### Full Repository
+```bash
+repomix --remove-comments --style markdown -o full-repo.md
+```
+**Use:** New codebase, architecture review, complete LLM context, planning
+**Tips:** Remove comments, use markdown, check token limits, review before sharing
+
+### Focused Module
+```bash
+repomix --include "src/auth/**,src/api/**" -o modules.xml
+```
+**Use:** Feature analysis, debugging specific areas, targeted refactoring
+**Tips:** Include related files only, stay within token limits, use XML for AI
+
+### Incremental Analysis
+```bash
+git checkout feature-branch && repomix --include "src/**" -o feature.xml
+git checkout main && repomix --include "src/**" -o main.xml
+```
+**Use:** Feature branch review, change impact, before/after comparison, migration planning
+
+### Cross-Repository
+```bash
+npx repomix --remote org/repo1 -o repo1.xml
+npx repomix --remote org/repo2 -o repo2.xml
+```
+**Use:** Microservices, library comparisons, consistency checks, integration analysis
+
+## Security Audit
+
+### Third-Party Library
+```bash
+npx repomix --remote vendor/library --style xml -o audit.xml
+```
+**Workflow:** Package library → enable security checks → review vulnerabilities → check suspicious patterns → AI analysis
+**Check for:** API keys, hardcoded credentials, network calls, obfuscation, malicious patterns
+
+### Pre-Deployment
+```bash
+repomix --include "src/**,config/**" --style xml -o pre-deploy-audit.xml
+```
+**Checklist:** No sensitive data, no test credentials, env vars correct, security practices, no debug code
+
+### Dependency Audit
+```bash
+repomix --include "**/package.json,**/package-lock.json" -o deps.md --style markdown
+repomix --include "node_modules/suspicious-package/**" -o dep-audit.xml
+```
+**Use:** Suspicious dependency, security advisory, license compliance, vulnerability assessment
+
+### Compliance
+```bash
+repomix --include "src/**,LICENSE,README.md,docs/**" --style markdown -o compliance.md
+```
+**Include:** Source, licenses, docs, configs. **Exclude:** Test data, dependencies
+
+## Documentation
+
+### Doc Context
+```bash
+repomix --include "src/**,docs/**,*.md" --style markdown -o doc-context.md
+```
+**Use:** API docs, architecture docs, user guides, onboarding
+**Tips:** Include existing docs, include source, use markdown
+
+### API Documentation
+```bash
+repomix --include "src/api/**,src/routes/**,src/controllers/**" --remove-comments -o api-context.xml
+```
+**Include:** Routes, controllers, schemas, middleware
+**Workflow:** Package → AI → OpenAPI/Swagger → endpoint docs → examples
+
+### Architecture
+```bash
+repomix --include "src/**/*.ts,*.md" -i "**/*.test.ts" --style markdown -o architecture.md
+```
+**Focus:** Module structure, dependencies, design patterns, data flow
+
+### Examples
+```bash
+repomix --include "examples/**,demos/**,*.example.js" --style markdown -o examples.md
+```
+
+## Library Evaluation
+
+### Quick Assessment
+```bash
+npx repomix --remote owner/library --style markdown -o library-eval.md
+```
+**Evaluate:** Code quality, architecture, dependencies, tests, docs, maintenance
+
+### Feature Comparison
+```bash
+npx repomix --remote owner/lib-a --style xml -o lib-a.xml
+npx repomix --remote owner/lib-b --style xml -o lib-b.xml
+```
+**Compare:** Features, API design, performance, bundle size, dependencies, maintenance
+
+### Integration Feasibility
+```bash
+npx repomix --remote vendor/library --include "src/**,*.md" -o library.xml
+repomix --include "src/integrations/**" -o our-integrations.xml
+```
+Analyze compatibility between target library and your integration points
+
+### Migration Planning
+```bash
+repomix --include "node_modules/old-lib/**" -o old-lib.xml
+npx repomix --remote owner/new-lib -o new-lib.xml
+```
+Compare current vs target library, analyze usage patterns
+
+## Workflow Integration
+
+### CI/CD
+```yaml
+# GitHub Actions
+- name: Generate Snapshot
+  run: |
+    npm install -g repomix
+    repomix --style markdown -o release-snapshot.md
+- name: Upload Artifact
+  uses: actions/upload-artifact@v3
+  with: {name: repo-snapshot, path: release-snapshot.md}
+```
+**Use:** Release docs, compliance archives, change tracking, audit trails
+
+### Git Hooks
+```bash
+#!/bin/bash
+# .git/hooks/pre-commit
+git diff --cached --name-only > staged-files.txt
+repomix --include "$(cat staged-files.txt | tr '\n' ',')" -o .context/latest.xml
+```
+
+### IDE (VS Code)
+```json
+{"version": "2.0.0", "tasks": [{"label": "Package for AI", "type": "shell", "command": "repomix --include 'src/**' --remove-comments --copy"}]}
+```
+
+### Claude Code
+```bash
+repomix --style markdown --copy  # Then paste into Claude
+```
+
+## Language-Specific Patterns
+
+### TypeScript
+```bash
+repomix --include "**/*.ts,**/*.tsx" --remove-comments --no-line-numbers
+```
+**Exclude:** `**/*.test.ts`, `dist/`, `coverage/`
+
+### React
+```bash
+repomix --include "src/**/*.{js,jsx,ts,tsx},public/**" -i "build/,*.test.*"
+```
+**Include:** Components, hooks, utils, public assets
+
+### Node.js Backend
+```bash
+repomix --include "src/**/*.js,config/**" -i "node_modules/,logs/,tmp/"
+```
+**Focus:** Routes, controllers, models, middleware, configs
+
+### Python
+```bash
+repomix --include "**/*.py,requirements.txt,*.md" -i "**/__pycache__/,venv/"
+```
+**Exclude:** `__pycache__/`, `*.pyc`, `venv/`, `.pytest_cache/`
+
+### Monorepo
+```bash
+repomix --include "packages/*/src/**" -i "packages/*/node_modules/,packages/*/dist/"
+```
+**Consider:** Package-specific patterns, shared deps, cross-package refs, workspace structure
+
+## Troubleshooting
+
+### Output Too Large
+**Problem:** Exceeds LLM token limits
+**Fix:**
+```bash
+repomix -i "node_modules/**,dist/**,coverage/**" --include "src/core/**" --remove-comments --no-line-numbers
+```
+
+### Missing Files
+**Problem:** Expected files not included
+**Debug:**
+```bash
+cat .gitignore .repomixignore  # Check ignore patterns
+repomix --no-gitignore --no-default-patterns --verbose
+```
+
+### Sensitive Data Warnings
+**Problem:** Security scanner flags secrets
+**Actions:** Review files → add to `.repomixignore` → remove sensitive data → use env vars
+```bash
+repomix --no-security-check  # Use carefully for false positives
+```
+
+### Performance Issues
+**Problem:** Slow on large repo
+**Optimize:**
+```bash
+repomix --include "src/**/*.ts" -i "node_modules/**,dist/**,vendor/**"
+```
+
+### Remote Access
+**Problem:** Cannot access remote repo
+**Fix:**
+```bash
+npx repomix --remote https://github.com/owner/repo  # Full URL
+npx repomix --remote https://github.com/owner/repo/commit/abc123  # Specific commit
+# For private: clone first, run locally
+```
+
+## Best Practices
+
+**Planning:** Define scope → identify files → check token limits → consider security
+
+**Execution:** Start broad, refine narrow → use appropriate format → enable security checks → monitor tokens
+
+**Review:** Verify no sensitive data → check completeness → validate format → test with LLM
+
+**Iteration:** Refine patterns → adjust format → optimize tokens → document patterns

package/skills/ck-repomix/scripts/README.md

@@ -0,0 +1,179 @@
+# Repomix Scripts
+
+Utility scripts for batch processing repositories with Repomix.
+
+## repomix_batch.py
+
+Batch process multiple repositories (local or remote) using the repomix CLI tool.
+
+### Features
+
+- Process multiple repositories in one command
+- Support local and remote repositories
+- Configurable output formats (XML, Markdown, JSON, Plain)
+- Environment variable loading from multiple .env file locations
+- Comprehensive error handling
+- Progress reporting
+
+### Installation
+
+Requires Python 3.10+ and repomix CLI:
+
+```bash
+# Install repomix
+npm install -g repomix
+
+# Install Python dependencies (if needed)
+pip install pytest pytest-cov pytest-mock  # For running tests
+```
+
+### Usage
+
+**Process single repository:**
+```bash
+python repomix_batch.py /path/to/repo
+```
+
+**Process multiple repositories:**
+```bash
+python repomix_batch.py /repo1 /repo2 /repo3
+```
+
+**Process remote repositories:**
+```bash
+python repomix_batch.py owner/repo1 owner/repo2 --remote
+```
+
+**From JSON file:**
+```bash
+python repomix_batch.py -f repos.json
+```
+
+**With options:**
+```bash
+python repomix_batch.py /repo1 /repo2 \
+  --style markdown \
+  --output-dir output \
+  --remove-comments \
+  --include "src/**/*.ts" \
+  --ignore "tests/**" \
+  --verbose
+```
+
+### Configuration File Format
+
+Create `repos.json` with repository configurations:
+
+```json
+[
+  {
+    "path": "/path/to/local/repo",
+    "output": "custom-output.xml"
+  },
+  {
+    "path": "owner/repo",
+    "remote": true
+  },
+  {
+    "path": "https://github.com/owner/repo",
+    "remote": true,
+    "output": "repo-output.md"
+  }
+]
+```
+
+### Environment Variables
+
+Loads .env files in order of precedence:
+1. Process environment (highest priority)
+2. `./repomix/.env` (skill-specific)
+3. `./skills/.env` (skills directory)
+4. `%USERPROFILE%/.claude/.env` (lowest priority)
+
+### Command Line Options
+
+```
+positional arguments:
+  repos                  Repository paths or URLs to process
+
+options:
+  -h, --help            Show help message
+  -f, --file FILE       JSON file containing repository configurations
+  --style {xml,markdown,json,plain}
+                        Output format (default: xml)
+  -o, --output-dir DIR  Output directory (default: repomix-output)
+  --remove-comments     Remove comments from source files
+  --include PATTERN     Include pattern (glob)
+  --ignore PATTERN      Ignore pattern (glob)
+  --no-security-check   Disable security checks
+  -v, --verbose         Verbose output
+  --remote              Treat all repos as remote URLs
+```
+
+### Examples
+
+**Process local repositories:**
+```bash
+python repomix_batch.py /path/to/repo1 /path/to/repo2 --style markdown
+```
+
+**Process remote repositories:**
+```bash
+python repomix_batch.py yamadashy/repomix facebook/react --remote
+```
+
+**Mixed configuration:**
+```bash
+python repomix_batch.py \
+  /local/repo \
+  --remote owner/remote-repo \
+  -f additional-repos.json \
+  --style json \
+  --remove-comments
+```
+
+**TypeScript projects only:**
+```bash
+python repomix_batch.py /repo1 /repo2 \
+  --include "**/*.ts,**/*.tsx" \
+  --ignore "**/*.test.ts,dist/" \
+  --remove-comments \
+  --style markdown
+```
+
+### Testing
+
+Run tests with coverage:
+
+```bash
+cd tests
+pytest test_repomix_batch.py -v --cov=repomix_batch --cov-report=term-missing
+```
+
+Current coverage: 99%
+
+### Exit Codes
+
+- `0` - All repositories processed successfully
+- `1` - One or more repositories failed or error occurred
+
+### Troubleshooting
+
+**repomix not found:**
+```bash
+npm install -g repomix
+```
+
+**Permission denied:**
+```bash
+chmod +x repomix_batch.py
+```
+
+**Timeout errors:**
+- Default timeout: 5 minutes per repository
+- Reduce scope with `--include` patterns
+- Exclude large directories with `--ignore`
+
+**No repositories specified:**
+- Provide repository paths as arguments
+- Or use `-f` flag with JSON config file