OpenKit

OpenKit is an AI engineering workflow platform. It gives agents a real execution loop: pick up tasks, work in isolated environments, run checks, and ship pull requests with clear visibility.

🌐 dawg-chi.vercel.app

✨ Features

• Task-driven development: Create and execute work from Jira, Linear, and local tasks in one consistent flow.
• Isolated environments: Each task runs independently on Git worktrees with automatic port conflict resolution.
• Agent tooling hub: Manage custom markdown agents (deployed to Claude/Cursor/Gemini CLI/VS Code/Codex), plugin subagents, MCP servers, skills, plugins, and workflow hooks in one place, with cache-first agent loading, unified Scan & Import flows, and MCP server creation via either form fields or pasted JSON config.
• Real-time visibility: Track execution across agents with live activity and high-signal blocker/approval notifications via the header bell feed and the dedicated per-project Activity page.
• Desktop auto-updates: Electron builds can check for new GitHub releases, show download/install state in-app, and install updates in one click.

🏗 Setup

Prerequisites:

• Node.js >= 18 (LTS recommended)
• pnpm >= 10

1. Enable Corepack

$ corepack enable pnpm

2. Install dependencies

$ pnpm install

3. Initialize local environment

$ pnpm run setup

4. Build once (recommended for first run)

$ pnpm build

🏃🏻‍♂️ Run the app

Run all first-class apps:

$ pnpm dev

Run specific app flows:

$ pnpm dev:cli
$ pnpm dev:server
$ pnpm dev:desktop-app
$ pnpm dev:mobile-app
$ pnpm dev:web-app
$ pnpm dev:website

Important

Make sure .env.local exists before running the app (pnpm run setup).

⚙️ Build

$ pnpm build
$ pnpm build:cli
$ pnpm build:server
$ pnpm build:web-app
$ pnpm build:desktop-app
$ pnpm build:website
$ pnpm build:mobile-app

Environment variables:

• OPENKIT_SERVER_PORT (default 6969) — backend server base port
• OPENKIT_WEB_APP_PORT (default 5173) — web-app Vite dev server port

🚀 Deploy

Everything is released from master.

• On pull requests targeting master, CI runs code quality, type checks, smoke tests, and build jobs with affected-target guards (so non-impacted jobs are skipped).
• On push/merge to master, the release workflow creates the release commit/tag and GitHub release automatically.
• A dedicated package workflow runs on release tag pushes (v*) and attaches macOS/Linux artifacts to that tag.
• The website Vercel project uses an ignoreCommand to skip deploys when commits do not change files under apps/website/.

📦 Package

$ pnpm package
$ pnpm package:mac
$ pnpm package:linux

📚 Docs

• API Reference
• Agents
• Architecture
• CLI Reference
• Configuration
• Development
• Electron
• Frontend
• Hooks
• Integrations
• MCP
• Notifications
• Port Mapping
• Project Structure
• Setup Flow