@tdsoft-tech/aikit 0.1.19 → 0.1.30

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/LICENSE ADDED
@@ -0,0 +1,63 @@
1
+ AIKit Non-Commercial License v1.0
2
+
3
+ Copyright (c) 2026 TDSoft / AIKit Contributors
4
+
5
+ 1. Grant of Permission
6
+
7
+ Permission is hereby granted, free of charge, to any person obtaining a copy
8
+ of this software and associated documentation files (the "Software"), to use,
9
+ copy, modify, and distribute the Software solely for non-commercial purposes,
10
+ subject to the conditions below.
11
+
12
+ 2. Non-Commercial Use Only
13
+
14
+ You may use the Software only for non-commercial purposes, including but not limited to:
15
+
16
+ - Personal use
17
+ - Educational use
18
+ - Academic research
19
+ - Internal evaluation
20
+ - Open-source learning or experimentation
21
+
22
+ Commercial use is strictly prohibited.
23
+
24
+ 3. Prohibited Uses
25
+
26
+ You may NOT:
27
+
28
+ - Use the Software, in whole or in part, for any commercial purpose
29
+ - Use the Software to build, train, enhance, or power a commercial product or service
30
+ - Sell, sublicense, rent, lease, or otherwise monetize the Software
31
+ - Offer the Software as part of a paid service, SaaS, or commercial API
32
+ - Reproduce, fork, or adapt the Software with the intent of creating a revenue-generating product
33
+
34
+ Any use that directly or indirectly results in financial benefit is considered commercial use.
35
+
36
+ 4. Commercial Licensing
37
+
38
+ If you wish to use the Software for commercial purposes,
39
+ you must obtain a separate commercial license.
40
+
41
+ Please contact:
42
+ 📧 dev@tdsoft.tech or duypnt23@gmail.com
43
+
44
+ 5. Attribution
45
+
46
+ Any permitted distribution of the Software must retain:
47
+
48
+ - This license text
49
+ - The copyright notice
50
+ - Any existing attribution notices
51
+
52
+ 6. Disclaimer of Warranty
53
+
54
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
55
+ EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
56
+ MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
57
+
58
+ 7. Limitation of Liability
59
+
60
+ IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE
61
+ FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF
62
+ CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
63
+ WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
package/README.md ADDED
@@ -0,0 +1,348 @@
1
+ <div align="center">
2
+
3
+ <img src="assets/logo.png" alt="AIKit Logo" width="200"/>
4
+
5
+ # **AIKit**
6
+
7
+ ### **Open-Source AI Coding Agent Toolkit**
8
+
9
+ **Works with Claude Code & OpenCode**
10
+
11
+ [![npm version](https://badge.fury.io/js/%40tdsoft-tech%2Faikit.svg)](https://www.npmjs.com/package/@tdsoft-tech/aikit)
12
+ [![License](https://img.shields.io/badge/License-Dual%20License-blue.svg)](LICENSE)
13
+ [![Node](https://img.shields.io/badge/Node-%3E=18.0.0-brightgreen)](https://nodejs.org)
14
+ [![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue)](https://www.typescriptlang.org/)
15
+
16
+ [![Stars](https://img.shields.io/github/stars/tdsoft-technology/aikit?style=social)](https://github.com/tdsoft-technology/aikit/stargazers)
17
+ [![Forks](https://img.shields.io/github/forks/tdsoft-technology/aikit?style=social)](https://github.com/tdsoft-technology/aikit/network/members)
18
+ [![Issues](https://img.shields.io/github/issues/tdsoft-technology/aikit)](https://github.com/tdsoft-technology/aikit/issues)
19
+
20
+ **Skills • Agents • Commands • Tools • Plugins**
21
+
22
+ [Documentation](https://aikit.tdsoft.tech/docs/intro) • [Quick Start](#-quick-start) • [Features](#-features) • [Contributing](#-contributing)
23
+
24
+ </div>
25
+
26
+ ---
27
+
28
+ ## ✨ What is AIKit?
29
+
30
+ **AIKit** is a powerful, open-source toolkit that extends your AI coding experience with reusable **skills**, intelligent **agents**, custom **commands**, and flexible **plugins**. It's designed to supercharge your development workflow with AI-driven automation.
31
+
32
+ **Works with Claude Code (recommended) and OpenCode.**
33
+
34
+ Perfect for developers who want to:
35
+ - 🚀 **Automate repetitive tasks** with custom commands
36
+ - 🧠 **Leverage specialized AI skills** (testing, refactoring, security, etc.)
37
+ - 🤖 **Use intelligent agents** for complex workflows
38
+ - 🔌 **Extend functionality** with plugins
39
+ - 📦 **Share knowledge** across projects
40
+
41
+ ---
42
+
43
+ ## 🎯 Key Features
44
+
45
+ ### 🧠 Specialized Skills
46
+
47
+ 23+ skills covering every aspect of development:
48
+
49
+ **Design & Architecture** • **Development** • **Testing** • **Workflow**
50
+
51
+ - 🎨 Frontend Aesthetics
52
+ - 🏗️ Component Design
53
+ - 🗄️ Database Design
54
+ - 📐 Design Measurement
55
+ - 🔌 API Design
56
+ - ⚡ Performance Optimization
57
+ - 🔨 Refactoring
58
+ - 🛡️ Security Audit
59
+ - 🐛 Systematic Debugging
60
+ - ✅ Unit Testing
61
+ - 🔄 Test-Driven Development
62
+ - 🔗 Integration Testing
63
+ - 🧪 Frontend Testing
64
+ - 📝 Documentation
65
+ - 🔀 CI/CD
66
+ - 🐳 Docker
67
+ - 🌳 Git Best Practices
68
+ - 💳 Payments Integration
69
+
70
+ ---
71
+
72
+ ### 🤖 Intelligent Agents
73
+
74
+ 8 specialized agents for different workflows:
75
+
76
+ | Agent | Mode | Purpose |
77
+ |:-----:|:----:|:---------|
78
+ | `aikitplanner` | `<tab>` | Plan complex features |
79
+ | `aikitbuild` | `<tab>` | Implement features |
80
+ | `rush` | `<tab>` | Quick fixes |
81
+ | `review` | `<tab>` | Code review |
82
+ | `scout` | `<tab>` | Explore codebase |
83
+ | `explore` | `<tab>` | Deep analysis |
84
+ | `vision` | `<tab>` | Image analysis |
85
+ | `one-shot` | `<tab>` | End-to-end automation |
86
+
87
+ > 💡 **Tip:** Press `<tab>` in Claude Code or OpenCode to switch between agents!
88
+
89
+ ---
90
+
91
+ ### ⚡ Quick Commands
92
+
93
+ 28+ commands at your fingertips:
94
+
95
+ **Claude Code (simpler):**
96
+ ```bash
97
+ /plan /implement /fix
98
+ /test /review /branch
99
+ /session:start
100
+ ```
101
+
102
+ **OpenCode (prefixed):**
103
+ ```bash
104
+ /ak_cm_plan /ak_cm_implement /ak_cm_fix
105
+ /ak_cm_test /ak_sk_review /ak_cm_branch
106
+ /session:start
107
+ ```
108
+
109
+ [View all commands →](https://aikit.tdsoft.tech/docs/commands/intro)
110
+
111
+ ---
112
+
113
+ ## 🚀 Quick Start
114
+
115
+ ### Prerequisites
116
+
117
+ - **Node.js** >= 18.0.0
118
+ - **Claude Code** (recommended) or **OpenCode** with Claude integration
119
+
120
+ ### Installation
121
+
122
+ ```bash
123
+ # Install AIKit globally
124
+ npm install -g @tdsoft-tech/aikit
125
+
126
+ # Or install in your project
127
+ npm install -D @tdsoft-tech/aikit
128
+
129
+ # Initialize AIKit in your project
130
+ aikit install
131
+ ```
132
+
133
+ That's it! 🎉 AIKit is now ready to use.
134
+
135
+ ### First Steps
136
+
137
+ **For Claude Code:**
138
+ 1. Open Claude Code in your project
139
+ 2. Use commands: `/plan`, `/implement`, `/fix`, `/test`
140
+ 3. Try a skill: `/test-driven-development` or `/code-review`
141
+ 4. Read the [documentation](https://aikit.tdsoft.tech/docs/intro)
142
+
143
+ **For OpenCode:**
144
+ 1. **Open OpenCode** and press `/` to see available commands
145
+ 2. Try a skill: `/ak_sk_test-driven-development`
146
+ 3. Switch agents: Press `<tab>` to cycle through agents
147
+ 4. Read the [documentation](https://aikit.tdsoft.tech/docs/intro)
148
+
149
+ ---
150
+
151
+ ## 📚 Documentation
152
+
153
+ **[📖 Full Documentation](https://aikit.tdsoft.tech/docs/intro)**
154
+
155
+ ### Quick Links
156
+
157
+ - [Installation Guide](https://aikit.tdsoft.tech/docs/installation)
158
+ - [Quick Reference](https://aikit.tdsoft.tech/docs/quick-reference)
159
+ - [All Skills](https://aikit.tdsoft.tech/docs/skills)
160
+ - [Commands](https://aikit.tdsoft.tech/docs/commands)
161
+ - [One-Shot Mode](https://aikit.tdsoft.tech/docs/one-shot-mode)
162
+ - [Figma Integration](https://aikit.tdsoft.tech/docs/using-analyze-figma)
163
+
164
+ ---
165
+
166
+ ## 🎬 Usage Examples
167
+
168
+ > 💡 **Note:** Command formats differ between Claude Code and OpenCode
169
+
170
+ ### Session Management
171
+
172
+ **Claude Code:**
173
+ ```bash
174
+ /session:start "Implement OAuth 2.0"
175
+ /session:update
176
+ /session:end
177
+ ```
178
+
179
+ **OpenCode:**
180
+ ```bash
181
+ /session:start "Implement OAuth 2.0"
182
+ /session:update
183
+ /session:end
184
+ ```
185
+
186
+ ### Planning Features
187
+
188
+ **Claude Code:**
189
+ ```bash
190
+ /plan "Add user authentication with OAuth"
191
+ ```
192
+
193
+ **OpenCode:**
194
+ ```bash
195
+ /ak_cm_plan "Add user authentication with OAuth"
196
+ ```
197
+
198
+ ### Implementing Features
199
+
200
+ **Claude Code:**
201
+ ```bash
202
+ /implement
203
+ # Or use skill directly
204
+ /test-driven-development
205
+ ```
206
+
207
+ **OpenCode:**
208
+ ```bash
209
+ /ak_cm_implement
210
+ /ak_sk_test-driven-development
211
+ ```
212
+
213
+ ### Fixing Bugs
214
+
215
+ **Claude Code:**
216
+ ```bash
217
+ /fix "Login fails on Safari"
218
+ ```
219
+
220
+ **OpenCode:**
221
+ ```bash
222
+ /ak_cm_fix "Login fails on Safari"
223
+ ```
224
+
225
+ ### Code Review
226
+
227
+ **Claude Code:**
228
+ ```bash
229
+ /code-review
230
+ ```
231
+
232
+ **OpenCode:**
233
+ ```bash
234
+ /ak_sk_code-review
235
+ ```
236
+
237
+ ### One-Shot Automation
238
+
239
+ **Claude Code:**
240
+ ```bash
241
+ /one-shot "Add dark mode toggle to settings"
242
+ ```
243
+
244
+ **OpenCode:**
245
+ ```bash
246
+ /ak_cm_one-shot "Add dark mode toggle to settings"
247
+ ```
248
+
249
+ ### Creating Branches
250
+
251
+ **Claude Code:**
252
+ ```bash
253
+ /branch "user-oauth"
254
+ ```
255
+
256
+ **OpenCode:**
257
+ ```bash
258
+ /ak_cm_branch "user-oauth"
259
+ ```
260
+
261
+ ---
262
+
263
+ ## 🤝 Contributing
264
+
265
+ We love contributions! 💜
266
+
267
+ **[📖 Contributing Guide](CONTRIBUTING.md)**
268
+
269
+ ### Ways to Contribute
270
+
271
+ - 🐛 [Report bugs](https://github.com/tdsoft-technology/aikit/issues)
272
+ - 💡 [Suggest features](https://github.com/tdsoft-technology/aikit/issues)
273
+ - 📝 [Improve docs](https://github.com/tdsoft-technology/aikit/pulls)
274
+ - 🔧 [Submit PRs](https://github.com/tdsoft-technology/aikit/pulls)
275
+ - 🌟 [Star the repo](https://github.com/tdsoft-technology/aikit) ⭐
276
+
277
+ ---
278
+
279
+ ## ❤️ Support AIKit
280
+
281
+ If you find AIKit useful, please consider supporting us! Your support helps us:
282
+ - 🛠️ Maintain and improve AIKit
283
+ - 🐛 Fix bugs faster
284
+ - ✨ Add new features
285
+ - 📚 Keep documentation up to date
286
+ - 🌍 Support the community
287
+
288
+ ### Ways to Support
289
+
290
+ | Support Type | Link | Description |
291
+ |--------------|------|-------------|
292
+ | ⭐ **Star on GitHub** | [Star this repo](https://github.com/tdsoft-technology/aikit) | It's free and helps others discover AIKit! |
293
+ | ☕ **Buy Me a Coffee** | [Support development](https://ko-fi.com) | One-time donation (link coming soon) |
294
+ | 💬 **Join Discussions** | [GitHub Discussions](https://github.com/tdsoft-technology/aikit/discussions) | Ask questions, share ideas |
295
+
296
+ ---
297
+
298
+ ## 📊 Changelog
299
+
300
+ See [CHANGELOG.md](CHANGELOG.md) for version history and updates.
301
+
302
+ ### Recent Highlights
303
+ - **v0.1.20** - Latest stable release
304
+ - **v0.1.18** - Fixed agent tab switching
305
+ - **v0.1.15** - Command prefix separation
306
+ - **v0.1.11** - One-Shot mode (beta)
307
+
308
+ ---
309
+
310
+ ## 📜 Licensing
311
+
312
+ AIKit is available under a dual-license model:
313
+
314
+ ### Non-Commercial License (Free)
315
+ - Free for personal, educational, and research use
316
+ - Open source learning and experimentation
317
+ - [View Non-Commercial License](LICENSE)
318
+
319
+ ### Commercial License (Paid)
320
+ - Required for any commercial or revenue-generating use
321
+ - SaaS platforms, paid APIs, enterprise systems
322
+ - [View Commercial License](COMMERCIAL_LICENSE.md)
323
+
324
+ **For commercial licensing inquiries:**
325
+ 📧 dev@tdsoft.tech or duypnt23@gmail.com
326
+ 🌐 https://tdsoft.tech
327
+
328
+ ---
329
+
330
+ ## 🙏 Acknowledgments
331
+
332
+ Built with ❤️ by the open-source community.
333
+ ---
334
+
335
+ <div align="center">
336
+
337
+ ###Built for Developers • Open Source Forever
338
+
339
+ [🔝 Back to Top](#-aikit)
340
+
341
+ [Documentation](https://aikit.tdsoft.tech/docs/intro) •
342
+ [Issues](https://github.com/tdsoft-technology/aikit/issues) •
343
+ [Discussions](https://github.com/tdsoft-technology/aikit/discussions) •
344
+ [Releases](https://github.com/tdsoft-technology/aikit/releases)
345
+
346
+ Made with 💜 by [TDSoft Technology](https://github.com/tdsoft-technology)
347
+
348
+ </div>