Kien DevKit

A CLI toolkit for AI-assisted software development with phase templates and environment setup.

Features

• Multi-Environment Support: Cursor, Claude Code, Trae
• Planning Tracks: Quick Flow, BMad Method, Enterprise
• Update-Safe System: Preserve customizations when updating templates
• Workflow Management: YAML-based workflow definitions
• Checklist Generation: Automated checklist templates
• Agent Customization: Custom agent overrides
• Platform Scaffolding: iOS, Android, Flutter
• Background Removal: PicWish-powered CLI to strip image backgrounds
• iOS Asset Slicing: Generate 1x/2x/3x imagesets from a single PNG
• Antigravity Manager: Manage multiple Antigravity accounts with account switching

Installation

npm install -g kien-dev-kit

Quick Start

# Initialize project with Cursor environment
kien-dev-kit init -e cursor

# Initialize with specific track
kien-dev-kit init -e cursor -t method -a

# Initialize with platform scaffold
kien-dev-kit init -e cursor -t method -s ios -n MyApp -o com.example.app

Planning Tracks

Kien DevKit hỗ trợ 3 planning tracks:

• ⚡ Quick Flow Track (quick): Bug fixes, small features (tech-spec only)
• 📋 BMad Method Track (method): Products, platforms (PRD + Architecture + UX)
• 🏢 Enterprise Track (enterprise): Enterprise systems (Security/DevOps/Test strategy)

👉 Xem hướng dẫn chi tiết về Planning Tracks

Commands

Init

kien-dev-kit init [options]

Options:

• -e, --environment <env>: Môi trường (cursor|claude|trae|both)
• -t, --track <track>: Planning track (quick|method|enterprise)
• -a, --all: Khởi tạo tất cả phases
• -p, --phases <phases>: Danh sách phases (comma-separated)
• -s, --scaffold <platform>: Scaffold platform (ios|android|flutter)
• -n, --name <name>: Tên dự án
• -o, --org <org>: Organization/namespace
• -f, --force: Force overwrite
• -u, --update-rules: Update rules for existing project

Update

kien-dev-kit update [options]

Update templates while preserving customizations in _custom/ directory.

Options:

• -e, --environment <env>: Environment to update
• -f, --force: Force update (overwrite customizations)
• -b, --backup: Create backup before update
• -d, --dry-run: Dry run mode
• -c, --check: Check for updates only

Checklist

kien-dev-kit checklist [templateId] [options]

Generate checklists from templates.

PicWish Background Removal

kien-dev-kit picwish --input ./images/photo.png [options]

Options:

• -o, --output <path>: Custom output path (default appends .bg-removed)
• --mask-output <path>: Optional path to store mask asset
• --poll-interval <ms>: Polling interval in milliseconds (default: 1000)
• --timeout <ms>: Timeout in milliseconds (default: 30000)

The command requires PICWISH_API to be defined in .env. It uploads the source image, polls PicWish until completion, and streams the processed asset to disk.

Usage checklist:

1. Create .env with PICWISH_API=<your_key> (never commit real keys).
2. Run npm install and npm run build to compile the CLI.
3. Execute PICWISH_API=<your_key> node dist/cli.js picwish --input ./images/sample.png or rely on the key loaded from .env.
4. Inspect the generated file (default suffix .bg-removed) and optional mask output if --mask-output was provided.

Slice iOS Assets

kien-dev-kit slice-assets --input ./assets/[email protected] [options]

Options:

• -n, --name <name>: Imageset name (default: source filename)
• -o, --output <dir>: Target Assets.xcassets path (default: ./Assets.xcassets)
• --base-scale <scale>: Source image scale (1, 2, or 3). Default: 3 (@3x)

The command reads the source PNG (typically the @3x version), rescales it to @1x/2x/3x, and writes the images plus Contents.json into <output>/<Name>.imageset.

Migrate

kien-dev-kit migrate [options]

Migrate existing projects to new structure with _custom/ support.

Antigravity Manager

kien-dev-kit antigravity <command> [options]

Manage multiple Antigravity accounts with seamless switching.

Commands:

• list - List all saved account snapshots
• add - Create/update account snapshot from current state
• switch - Switch to a different account
• delete - Delete an account snapshot
• start - Start Antigravity application
• stop - Stop Antigravity application

Options:

• -i, --id <id>: Account ID or index number (for switch/delete)
• -n, --name <name>: Account name (for add)
• -e, --email <email>: Account email (for add)

Examples:

# List all accounts
kien-dev-kit antigravity list

# Add current account with custom name
kien-dev-kit antigravity add --name "Work Account"

# Switch to account by index
kien-dev-kit antigravity switch --id 1

# Delete account
kien-dev-kit antigravity delete --id 1

# Start/stop Antigravity
kien-dev-kit antigravity start
kien-dev-kit antigravity stop

Requirements:

• Node.js 16+ (already required for Kien DevKit)
• Antigravity application installed on your system
• Database access to Antigravity's state files (automatically detected)

Note: This feature is fully implemented in Node.js/TypeScript and does not require Python or any external dependencies beyond the CLI itself.

Documentation

• Planning Tracks Guide
• PicWish Integration PRD
• Project Checklist
• CHANGELOG

License

MIT