---

Quick Start

npx kiro-kit init

Pick from 6 curated presets with an interactive selector — arrow keys to move, Enter to select, Enter again to confirm. Your .kiro/ workspace is ready with agents, skills, commands, hooks, MCP servers, Powers recommendations, and spec templates.

# or install globally
npm install -g kiro-kit
kiro-kit init

Presets

Preset	Stack	What you get
frontend	React, Next.js, TypeScript	20 agents, 23 skills, 71 commands tailored for component architecture, accessibility, and performance
backend	Node, Python, Go APIs	19 agents, 24 skills, 66 commands for API design, database management, auth, deployment patterns
fullstack	Next.js, T3 stack	20 agents, 30 skills, 73 commands covering frontend plus backend, payment integration, e-commerce
mobile	Flutter, React Native	23 agents, 28 skills, 71 commands for mobile-first patterns, ai-multimodal, ui-styling
devops	Docker, Kubernetes, Terraform	20 agents, 26 skills, 65 commands for CI checks, container scanning, infrastructure as code
data-ai	Python, ML, AI agents	20 agents, 30 skills, 70 commands for Pandas, PyTorch, TensorFlow, Jupyter, Google ADK, document processing

Every preset is self-contained with 16+ agents, 22+ skills, 40+ commands, 9+ cross-platform hooks (including 3 domain-specific), MCP server auto-config, Powers recommendations, and spec scaffolding.

CLI Experience

The kiro-kit init command features a polished terminal UI:

• Purple gradient ASCII logo (figlet Small font)
• Interactive preset selector: arrow keys to move, Enter to select, Enter x2 to confirm
• Live selected count indicator
• Task progress list with spinners
• Success summary box with file counts and next steps
• Graceful fallback for CI/non-TTY environments

Domain-Specific Hooks

Beyond generic notification hooks, each preset includes 3 domain-specific hooks:

• frontend: accessibility-check, bundle-size-guard, component-test-reminder
• backend: api-schema-validate, migration-safety-check, endpoint-test-coverage
• fullstack: type-sync-check, api-client-gen, deployment-readiness
• mobile: platform-parity-check, asset-optimization, release-checklist
• devops: terraform-plan-review, container-scan, cost-estimation
• data-ai: data-drift-check, model-card-update, experiment-log

MCP Server Auto-Configuration

Running kiro-kit init generates a functional .mcp.json:

• Servers requiring no credentials (filesystem, git, fetch) are enabled immediately
• Servers requiring credentials (postgres, docker) are included as _disabled_ entries with instructions to enable

Kiro Powers Integration

Each preset recommends curated Kiro Powers organized by priority tier:

Preset	Essential	Recommended	Optional
frontend	Figma	Netlify, Context7	Snyk, ScoutQA
backend	Supabase	Neon, Postman, Context7	Stripe, Snyk
fullstack	Supabase	Figma, Netlify, Stripe, Context7	Firebase, LaunchDarkly
mobile	Firebase	Figma, Context7	ElevenLabs, Bria
devops	Terraform	Datadog, Snyk, Depot	Harness, AWS CDK
data-ai	ClickHouse	Context7, Exa	Neon, New Relic

Running init also auto-configures MCP servers (filesystem, git, fetch enabled; postgres, docker as disabled templates) and generates a POWERS-SETUP.md guide.

Commands

Command	What it does
kiro-kit init	Interactive preset picker and workspace bootstrap
kiro-kit add <preset>	Drop another preset into an existing workspace
kiro-kit list	See all presets with artifact counts
kiro-kit info <preset>	Detailed preset contents and file targets
kiro-kit update	Pull latest preset version into your workspace
kiro-kit restore	Roll back from a timestamped backup
kiro-kit doctor	Health check (8 validations, --fix auto-repairs)
kiro-kit telemetry	Manage opt-in usage telemetry (off by default)

Common Flags

-y, --yes              Skip confirmation prompts
--force                Overwrite all conflicts (with backup)
--skip-existing        Skip files that already exist
--no-color             Disable ANSI output
--powers <mode>        Powers setup: none, all, or interactive (default)
--quiet                Suppress non-essential output

How It Works

1. Pick presets       2. Resolve conflicts        3. Workspace ready
   ┌─────────┐           ┌──────────────┐            ┌───────────┐
   │ frontend│  ────►    │ Backup +     │  ────►     │  .kiro/   │
   │ devops  │           │ Atomic write │            │  Live     │
   └─────────┘           └──────────────┘            └───────────┘

Three principles drive every design decision:

• Bundled, not fetched - all presets ship in the npm tarball. Works offline after install.
• User-priority merge - existing user content is never silently overwritten. Conflicts always prompt.
• Atomic writes - temp file plus rename guarantees no partial state on crash or interrupt.

See docs/architecture.md for the module breakdown and docs/how-it-works.md for lifecycle details.

Built for Real Workflows

• Cross-platform hooks (.js primary, .sh and .ps1 fallbacks)
• 4-option conflict resolution (overwrite, skip, view diff, overwrite all)
• Timestamped backups with restore and restore --list
• Tracking file (.kiro/.kiro-kit.json) records what came from where
• Property-based tests verify invariants (round-trips, commutativity, idempotency)
• Structural tests enforce minimum thresholds across all 6 presets

Privacy

Telemetry is off by default. No data ever leaves your machine unless you explicitly opt in:

kiro-kit telemetry status     # Check current state
kiro-kit telemetry enable     # Opt in (anonymous events only)
kiro-kit telemetry disable    # Opt out

Opt-in events include command name, preset selection, OS, and Node version. Never file contents, paths, or PII.

Contributing

Got an idea for a new preset, or want to improve an existing one? See CONTRIBUTING.md and docs/creating-presets.md.

git clone https://github.com/ihatesea69/kiro-kit.git
cd kiro-kit
pnpm install
pnpm test

License

MIT