kiro-kit 0.1.0 → 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +137 -0
- package/package.json +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,137 @@
|
|
|
1
|
+
<div align="center">
|
|
2
|
+
|
|
3
|
+
# kiro-kit
|
|
4
|
+
|
|
5
|
+
**Engineer-grade [Kiro IDE](https://kiro.dev) workspaces. One command.**
|
|
6
|
+
|
|
7
|
+
[](https://www.npmjs.com/package/kiro-kit)
|
|
8
|
+
[](https://github.com/ihatesea69/kiro-kit/blob/main/LICENSE)
|
|
9
|
+
[](https://www.npmjs.com/package/kiro-kit)
|
|
10
|
+
[](https://nodejs.org)
|
|
11
|
+
[](https://github.com/ihatesea69/kiro-kit/actions/workflows/ci.yml)
|
|
12
|
+
|
|
13
|
+
</div>
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
17
|
+
## Quick Start
|
|
18
|
+
|
|
19
|
+
```bash
|
|
20
|
+
npx kiro-kit init
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
Pick from 6 curated presets, confirm, and your `.kiro/` workspace is ready. Agents, skills, commands, hooks, workflows, MCP servers, statusline, and spec templates — all configured and bundled in the install.
|
|
24
|
+
|
|
25
|
+
```bash
|
|
26
|
+
# or install globally
|
|
27
|
+
npm install -g kiro-kit
|
|
28
|
+
kiro-kit init
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
## Why kiro-kit
|
|
32
|
+
|
|
33
|
+
Most "AI coding kits" are dotfile dumps. This one wires the whole software lifecycle into a single workflow that humans and AI both read: requirements, design, tasks, code, tests — with formal correctness properties as the glue.
|
|
34
|
+
|
|
35
|
+
Pick a preset, run one command, get a workspace where AI agents act like senior teammates instead of intern auto-completers.
|
|
36
|
+
|
|
37
|
+
## Presets
|
|
38
|
+
|
|
39
|
+
| Preset | Stack | Highlights |
|
|
40
|
+
| ------------ | ------------------------------------ | --------------------------------------------------------------------------- |
|
|
41
|
+
| `frontend` | React, Next.js, TypeScript | 20 agents, 21 skills, 30 commands tuned for components, a11y, performance |
|
|
42
|
+
| `backend` | Node, Python, Go APIs | 19 agents, 20 skills, 29 commands for API design, databases, auth, deploy |
|
|
43
|
+
| `fullstack` | Next.js, T3 stack | 20 agents, 22 skills, 30 commands plus payment and Shopify integration |
|
|
44
|
+
| `mobile` | Flutter, React Native | 23 agents, 25 skills, 30 commands for mobile-first patterns and ai-multimodal |
|
|
45
|
+
| `devops` | Docker, Kubernetes, Terraform | 20 agents, 24 skills, 30 commands plus container scanning and IaC workflows |
|
|
46
|
+
| `data-ai` | Python, ML, AI agents | 20 agents, 32 skills, 35 commands for Pandas, PyTorch, Jupyter, Google ADK |
|
|
47
|
+
|
|
48
|
+
Every preset ships **self-contained**: agents, skills, commands, cross-platform hooks, workflows, statusline scripts, MCP server templates, and spec scaffolding.
|
|
49
|
+
|
|
50
|
+
## Commands
|
|
51
|
+
|
|
52
|
+
| Command | What it does |
|
|
53
|
+
| ------------------------ | ------------------------------------------------------- |
|
|
54
|
+
| `kiro-kit init` | Interactive preset picker and workspace bootstrap |
|
|
55
|
+
| `kiro-kit add <preset>` | Drop another preset into an existing workspace |
|
|
56
|
+
| `kiro-kit list` | See all presets with artifact counts |
|
|
57
|
+
| `kiro-kit info <preset>` | Detailed preset contents and file targets |
|
|
58
|
+
| `kiro-kit update` | Pull latest preset version into your workspace |
|
|
59
|
+
| `kiro-kit restore` | Roll back from a timestamped backup |
|
|
60
|
+
| `kiro-kit doctor` | Health check (8 validations, `--fix` auto-repairs) |
|
|
61
|
+
| `kiro-kit telemetry` | Manage opt-in usage telemetry (off by default) |
|
|
62
|
+
|
|
63
|
+
### Common flags
|
|
64
|
+
|
|
65
|
+
```
|
|
66
|
+
-y, --yes Skip confirmation prompts
|
|
67
|
+
--force Overwrite all conflicts (with backup)
|
|
68
|
+
--skip-existing Skip files that already exist
|
|
69
|
+
--no-color Disable ANSI output
|
|
70
|
+
-v, --verbose Verbose logging
|
|
71
|
+
-q, --quiet Errors only
|
|
72
|
+
--json Machine-readable output (list, info)
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
## How it works
|
|
76
|
+
|
|
77
|
+
```
|
|
78
|
+
1. Pick presets 2. Resolve conflicts 3. Workspace ready
|
|
79
|
+
┌─────────┐ ┌──────────────┐ ┌───────────┐
|
|
80
|
+
│ frontend│ ────► │ Backup + │ ────► │ .kiro/ │
|
|
81
|
+
│ devops │ │ Atomic write │ │ Live │
|
|
82
|
+
└─────────┘ └──────────────┘ └───────────┘
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
Three principles drive every design decision:
|
|
86
|
+
|
|
87
|
+
- **Bundled, not fetched** — all presets ship in the npm tarball. Works offline after install.
|
|
88
|
+
- **User-priority merge** — existing user content is never silently overwritten. Conflicts always prompt.
|
|
89
|
+
- **Atomic writes** — temp file plus rename guarantees no partial state on crash or interrupt.
|
|
90
|
+
|
|
91
|
+
## Built for real workflows
|
|
92
|
+
|
|
93
|
+
- Cross-platform hooks (`.js` primary, `.sh` and `.ps1` fallbacks)
|
|
94
|
+
- 4-option conflict resolution (overwrite, skip, view diff, overwrite all)
|
|
95
|
+
- Timestamped backups with `restore` and `restore --list`
|
|
96
|
+
- Tracking file (`.kiro/.kiro-kit.json`) records what came from where
|
|
97
|
+
- Property-based tests verify invariants (round-trips, commutativity, idempotency)
|
|
98
|
+
- Structural tests enforce minimum thresholds across all 6 presets
|
|
99
|
+
|
|
100
|
+
## Privacy
|
|
101
|
+
|
|
102
|
+
Telemetry is **off by default**. Nothing leaves your machine unless you explicitly opt in.
|
|
103
|
+
|
|
104
|
+
```bash
|
|
105
|
+
kiro-kit telemetry status # Check current state
|
|
106
|
+
kiro-kit telemetry enable # Opt in (anonymous events only)
|
|
107
|
+
kiro-kit telemetry disable # Opt out
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
Opt-in events include command name, preset selection, OS, and Node version. Never file contents, paths, or PII.
|
|
111
|
+
|
|
112
|
+
## Requirements
|
|
113
|
+
|
|
114
|
+
- Node.js 18 or later
|
|
115
|
+
- pnpm, npm, or yarn (only one needed for `npx`)
|
|
116
|
+
|
|
117
|
+
## Contributing
|
|
118
|
+
|
|
119
|
+
Got an idea for a new preset, or want to improve an existing one? See [CONTRIBUTING.md](https://github.com/ihatesea69/kiro-kit/blob/main/CONTRIBUTING.md) and [docs/creating-presets.md](https://github.com/ihatesea69/kiro-kit/blob/main/docs/creating-presets.md).
|
|
120
|
+
|
|
121
|
+
```bash
|
|
122
|
+
git clone https://github.com/ihatesea69/kiro-kit.git
|
|
123
|
+
cd kiro-kit
|
|
124
|
+
pnpm install
|
|
125
|
+
pnpm test
|
|
126
|
+
```
|
|
127
|
+
|
|
128
|
+
## Links
|
|
129
|
+
|
|
130
|
+
- Repository: https://github.com/ihatesea69/kiro-kit
|
|
131
|
+
- Issues: https://github.com/ihatesea69/kiro-kit/issues
|
|
132
|
+
- Releases: https://github.com/ihatesea69/kiro-kit/releases
|
|
133
|
+
- Kiro IDE: https://kiro.dev
|
|
134
|
+
|
|
135
|
+
## License
|
|
136
|
+
|
|
137
|
+
[MIT](https://github.com/ihatesea69/kiro-kit/blob/main/LICENSE)
|