vcsx 5.11.0

╔══════════════════╗
║       *          ║
║      vcsx        ║
║     v5.1.0       ║
╚══════════════════╝

✨ What It Does

vcsx is a CLI tool that generates production-ready AI coding environments in seconds.

• 10 AI tools supported: Claude Code, Cursor, Windsurf, Zed, Aider, Bolt, Codex, Copilot, Gemini CLI, AGENTS.md
• 22 production-quality skills with full content (commit, deploy, security, performance, migration...)
• 10 project presets (fastapi-postgres, saas-nextjs, flutter-app, rust-api...)
• 11+ languages with inference (Python, TypeScript, Go, Rust, Kotlin, Swift, Dart, C#, PHP, Ruby, Java)
• 20 CLI commands for every workflow stage

# Full interactive wizard
$ vcsx init

# Fast mode (2 questions, no wizard)
$ vcsx init --fast -c claude-code

# Scan mode (auto-detect from existing project)
$ vcsx init --scan -c claude-code

# Multi-tool at once
$ vcsx init -c claude-code -c cursor -c gemini
$ vcsx init --all-tools

# Scaffold from template
$ vcsx new my-api --preset fastapi-postgres
$ vcsx new my-saas --preset saas-nextjs --tool claude-code --tool cursor

# Audit & maintain
$ vcsx audit --fix        # comprehensive check + auto-fix
$ vcsx validate           # best-practice validation
$ vcsx compare a/ b/      # diff configs between projects
$ vcsx search "deploy"    # search inside skill files

🚀 Installation (5 Methods)

1. PyPI (Recommended)

pip install vcsx

2. Standalone EXE

curl -L https://github.com/barancanercan/vcsx/releases/latest/download/vcsx.exe -o vcsx.exe

3. Homebrew

brew tap vcsx/tap
brew install vcsx

4. npx

npx vcsx init

5. npm

npm install -g vcsx

📦 Supported AI Tools (10 Tools)

🎯 Discovery Process (v4.0 - Enhanced)

The discovery phase now includes purpose-driven questions for a more intelligent setup:

Phase 0: AI Tool & Platform

• Auto-detects existing AI tool configuration
• Detects platform (Windows/macOS/Linux/WSL)

Phase 1: Project Foundation (Most Important)

• Purpose: What do you aim to achieve?
• Problem: What problem does this project solve?
• Project name, description, tech stack
• Project type (web/api/cli/mobile/desktop/library)

Phase 2: User Stories & Success Criteria

• User Stories: Detailed "As a user, I can..." format
• Success Criteria: Measurable metrics for success
• MVP features, target users

Phase 3: Technical Details

• Smart branching: Auth → Auth method
• Hosting, external services, monorepo

Phase 4: Development Standards

• Test level (none/unit/integration/full)
• CI/CD pipeline
• Formatter, linter

Phase 5: Claude Code Configuration

• Recurring tasks (becomes skills)
• Forbidden actions (blocked by hooks)
• Automations

🗂️ Project Templates (10 Presets)

Use vcsx new <name> --preset <template> or vcsx init --fast to scaffold from a template.

vcsx new my-api --preset fastapi-postgres
vcsx new my-saas --preset saas-nextjs --tool claude-code --tool cursor

🧩 Generated Skills (20+)

🔌 Generated Hooks (13)

PreToolUse

• block_destructive — Blocks dangerous commands
• validate_syntax — Validates code syntax
• check_permissions — Warns on permission changes

PostToolUse

• auto_format — Auto-formats on save
• auto_lint — Runs linter after edits
• type_check — Type checking
• secret_scan — Scans for secrets

SessionStart

• check_env — Checks environment variables
• check_deps — Verifies dependencies
• git_status — Shows git status

Stop

• run_tests — Runs test suite
• cleanup_temp — Cleans temp files
• commit_prompt — Prompts for commit

📋 vcsx Commands

🧪 Development

# Install with dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Lint
ruff check src/

# Format
ruff format src/

# Build wheel
python -m build

# Build standalone exe
pyinstaller src/vcsx/cli.py --name vcsx --onefile

🤝 Contributing

Contributions welcome! See CONTRIBUTING.md.

📄 License

MIT License — see LICENSE.