ciforge-cli 2.0.0

A zero-dependency CI tool replacing multiple CI services.

ciforge

ciforge is a zero-dependency CLI and GitHub Action that replaces 20 CI services with one robust tool. Run your complete CI pipeline 100% locally or natively within your actions, faster and with zero external dependencies.

Features

• Code Quality: Intelligent linting and AST-based complexity analysis (cyclomatic complexity, long functions).
• Test Coverage Analysis: Deep inspection of test coverage gaps.
• Secret Detection: Catch hardcoded credentials before they reach your repository.
• Config Validation: Native parsing and validation for JSON, YAML, ENV, TOML, and XML files.
• PR Metrics & Velocity Tracking: Analyze pull request size, churn, and time span metrics.
• Multi-Model AI Review: Integrates with OpenAI, Anthropic, or Ollama to find logic flaws and missing edge cases.
• Localization Sync: Finds missing translation keys by comparing localization files against a base en.json.
• Git Hooks Installer: Easily install pre-commit hooks to run ciforge before committing.
• Auto-Generated Badges: Generate dynamic SVG badges reflecting repository health.
• HTML Reports: Export beautiful standalone HTML reports.
• Contributor Welcome Module: Automatically greet first-time contributors.
• Auto-Fixer (--fix): Automatically resolves low-hanging issues like debug statements and bad formatting.
• Custom Ignore Rules: Whitelist files and dummy secrets via .ciforge-ignore.
• Auto-Changelog Generator: Generate CHANGELOG.md from git log using conventional commits.
• Dead Code Detector: Find unreferenced functions and classes.
• Deployment Health Check: Verify production deployments after CI runs.
• Config Drift Detection: Detect out-of-sync environment files (e.g. .env.production vs .env.staging).
• Architecture Diagram Generator: Auto-generate Mermaid dependency diagrams.
• Auto PR Descriptions: Generate rich markdown PR descriptions from git diffs.
• Mobile Config Linter: Catch errors in pubspec.yaml, build.gradle, and Podfile.

Installation

pip install ciforge-cli

Usage

Run locally and print to terminal:

ciforge --repo . --base-ref origin/main --format markdown --fail-on high

Generate a beautiful HTML dashboard:

ciforge --repo . --format html --badge

Run the auto-fixer:

ciforge --repo . --fix

Generate a CHANGELOG.md:

ciforge --repo . --changelog

Check for config drift:

ciforge --repo . --drift

Run deployment health check:

ciforge --repo . --deploy-check https://your-production-url.com

Generate architecture diagram:

ciforge --repo . --arch-diagram

Auto-generate PR description:

ciforge --repo . --pr-describe

Install local pre-commit hook (blocks bad commits):

ciforge --install-hook

GitHub Action Usage

Use ciforge directly in your workflows to comment on PRs and enforce standards:

steps:
  - uses: actions/checkout@v4
  - name: Run CI Forge
    uses: Tahiram32/ciforge@v2.0.0
    with:
      repo: '.'
      base-ref: 'origin/main'
      format: 'markdown'
      fail-on: 'high'
      post-comment: 'true'
      badge: 'true'
      openai-key: ${{ secrets.OPENAI_API_KEY }} # Optional: enables AI Reviewer

❤️ Sponsorship

ciforge is free and open source, and will always stay that way. If it saves you time or money by replacing paid CI services, consider sponsoring its continued development!

Every sponsor helps fund:

• 🚀 New features and integrations
• 🐛 Bug fixes and maintenance
• 📖 Documentation and examples
• 🔒 Security research and improvements