AI-powered IDE for creating, managing, and testing bl1nk AI skills, agents, and MCP tools. This repository contains the complete platform code and design specification.
bl1nk Skill Builder is a comprehensive desktop IDE specifically designed for AI development. It is built as a Monorepo using pnpm and consists of a Desktop Client (apps/client) and a Backend Server (apps/server).
Think "VS Code but for AI development"
- ✅ 68 Total Endpoints (Designed API)
- ✅ 9 Major Modules (Project, Skill, Agent, Provider, etc.)
- ✅ 6 Agent Categories (501 pre-built agents)
- ✅ 15 Skill Categories
- ✅ 6 LLM Providers integrated
This project is fully documented with detailed design specifications.
| Document | Description | Target Audience |
|---|---|---|
| SKILL.md | Platform overview, core modules, skill workflows, and use cases. | Designers, Product Managers |
| API_SPECIFICATION.yaml | Complete REST API specification in OpenAPI 3.1 format (68 endpoints). | API Developers |
| ENDPOINTS_SUMMARY.md | Quick lookup table for all 68 endpoints, organized by module. | API Developers |
| MODULES_ARCHITECTURE.md | Complete architecture for all 9 modules, including database schema and data flow. | Backend Engineers |
| IMPLEMENTATION_GUIDE.md | Developer guide, quick start, API development workflow, and testing strategy. | Backend Engineers |
| Component | Technology | Details |
|---|---|---|
| Monorepo | pnpm | Efficient dependency management |
| Frontend (IDE) | Electron 38.2, Next.js 15, React 19 | Desktop application framework and UI |
| Backend (API) | Express.js / Hono, Node.js 20+ | High-performance API server |
| Database | SQLite (Phase 1), PostgreSQL (Phase 2) | Persistence layer |
| ORM | Drizzle ORM | Type-safe database access |
| Testing | Jest, Playwright, SuperTest | Unit, E2E, and API testing |
| AI Integration | AWS Bedrock, OpenAI, Anthropic, Google, OpenRouter | Multi-provider LLM support |
- Node.js >= 20.0.0
- pnpm (latest version)
- Git
# Clone repository
git clone https://github.com/bl1nk-org/bl1nk-skill-platform.git
cd bl1nk-skill-platform
# Install dependencies (Monorepo)
pnpm install
# Copy environment variables
cp .env.example .env
# Start development (Client and Server)
pnpm dev| Command | Description |
|---|---|
pnpm dev |
Start all services (Client IDE and Server API) |
pnpm build |
Build all packages |
pnpm test:e2e |
Run End-to-End tests (Playwright) |
pnpm test:unit |
Run unit tests |
pnpm validate |
Run all checks (format, lint, type-check) |
pnpm validate:agents |
Validate 501 agent configurations |
pnpm health |
Project health check |
The platform is designed with security in mind, especially for credential management:
- ✅ AES-256-GCM encryption for API credentials
- ✅ JWT authentication for API access
- ✅ Input validation with Zod schemas
- ✅ Rate limiting on sensitive endpoints
- ✅ Context isolation in the Electron client
- ✅ Path traversal and Symlink loop protection
See SECURITY.md for detailed guidelines.
| Phase | Status | Key Milestones |
|---|---|---|
| Phase 1 | ✅ Complete | Core skill management, 501 agent library, Multi-provider AI, SQLite + Drizzle, Electron packaging. |
| Phase 2 | 🔄 Current | REST API v1 with OpenAPI spec, Comprehensive design documentation, PostgreSQL + Redis migration, CI/CD automation, Cloud synchronization. |
| Phase 3 | 📅 Planned | Multi-user authentication, Advanced skill organization, Observability dashboard, Automated backups. |
| Phase 4 | 📅 Future | Cloud sync for skills, Skill marketplace, Advanced access controls, Enterprise features. |
We welcome contributions! Please see CONTRIBUTING.md for development setup, code standards, and the pull request process.
MIT License - see LICENSE file for details.
Made with ❤️ by the bl1nk team