DevFlow — Developer Workflow Automation CLI

One tool to scaffold, audit, fix, and ship any project.

---

Stop Wasting Hours on Project Setup

Every developer knows the pain:

• Starting a new project means hours of boilerplate — config files, CI/CD, linting, testing, Docker
• Code reviews catch formatting and lint issues that should have been fixed automatically
• Shipping a release means bumping versions, updating changelogs, tagging, building — all manual and error-prone

DevFlow replaces 10+ separate tools with 4 commands.

---

What DevFlow Does

devflow init — Smart Project Scaffolding

Creates production-ready projects with best practices baked in:

• Python (CLI, API, library), Node.js, and full-stack templates
• Pre-configured linting (ruff), formatting (black), type checking (mypy), and testing (pytest)
• GitHub Actions CI/CD ready to go
• Docker config included
• Automatic git init and initial commit
• Sensible defaults you can override

$ devflow init my-api --template api --description "REST API for widget tracking"
$ devflow init my-cli --template cli
$ devflow init my-saas --template fullstack --description "My SaaS app"

devflow audit — Codebase Health Check

Comprehensive project audit that checks:

• Project structure and conventions
• Linting violations (ruff)
• Code formatting (black)
• Import organization (isort/ruff)
• Test coverage and passing status
• Docstring coverage
• Security vulnerabilities (bandit)
• Hardcoded secrets
• Dependency freshness and known vulnerabilities

$ devflow audit
# 72/100 — 8 passed, 3 warnings, 1 error

$ devflow audit --format markdown --severity error
$ devflow audit --format json  # for CI integration

devflow fix — Auto-Fix Everything

One command to fix all the issues audit found:

• Format code with black
• Sort imports with ruff/isort
• Fix lint violations
• Preview with --dry-run before applying

$ devflow fix --dry-run      # See what would change
$ devflow fix --apply        # Fix everything
$ devflow fix --scope format # Just fix formatting

devflow ship — Release Automation

Ship a release in one command:

• Runs audit first (quality gate — blocks release on errors)
• Bumps version (patch/minor/major)
• Updates CHANGELOG.md
• Creates git tag
• Builds distribution packages
• Optionally pushes to remote

$ devflow ship --bump patch --message "Fix login bug"
$ devflow ship --bump minor --message "Add user dashboard" --push
$ devflow ship --bump major --dry-run  # Preview before shipping

---

Why Developers Buy DevFlow

• Save 2-4 hours per project setup. Stop copy-pasting configs between projects.
• Catch issues before code review. Audit and fix in your editor, not in PR comments.
• Ship with confidence. Automated quality gates prevent broken releases.
• One tool, not ten. Replace black, isort, ruff, flake8, bandit, pip-audit, bumpversion, and manual changelogs.
• CI-ready output. JSON and markdown formats integrate with any pipeline.

---

Installation

pip install kryptorious-devflow

Requires Python 3.9+.

---

Quick Start

# Create a new project
devflow init my-project --template cli

# Check its health
cd my-project
devflow audit

# Fix any issues
devflow fix --apply

# Ship v0.1.0
devflow ship --bump patch --message "Initial release"

---

What You Get

• Full source code — MIT-licensed, modifiable, extensible
• 6 project templates — Python CLI, API, Library, Node.js, Full-stack, and Generic
• Pre-configured tooling — ruff, black, mypy, pytest, GitHub Actions CI
• Docker support — Dockerfile and docker-compose included for all templates
• Lifetime updates — All 1.x updates included

---

Requirements

• Python 3.9 or later
• Git (for init and ship commands)
• Optional: black, ruff, bandit, pip-audit (devflow tells you what to install)

---

License

Proprietary — single-user license. See LICENSE for terms.

---

Support

Email: support@devflow.sh Docs: https://devflow.sh/docs

---

Built with DevFlow itself. Ship everything.