🚀 UltraPilot

A Knowledge-Base-Driven AI Toolchain Generator

UltraPilot is a powerful CLI and Web UI tool that automatically generates AI toolchain configurations (.agents/skills, AGENTS.md, CLAUDE.md, .cursorrules) for any software project. It syncs the best Agent Skills from GitHub, lets you pick your AI tools via a browser dashboard, and sets up your project in seconds.

✨ Why UltraPilot?

Developers using multiple AI coding tools (Claude Code, Cursor, Kimi, Codex, Gemini, Copilot) currently maintain separate configuration files that quickly diverge.

UltraPilot solves this by enforcing a Single Source of Truth pattern. It generates a central AGENTS.md and .agents/skills/ directory, and automatically creates all necessary symlinks and adapter files for your chosen tools.

🛠 Features

• 🧠 Knowledge-Base Driven: Automatically syncs curated SKILL.md files from authoritative GitHub repositories (e.g., VoltAgent/awesome-agent-skills, dotnet/skills).
• 🖥️ Web UI Configuration: A sleek local React dashboard to visually select your tech stack, AI tools, and preferred workflows.
• 🤖 RAG Composition: Uses an OpenAI-compatible LLM to read selected skills and generate a context-aware, project-specific AGENTS.md.
• 🔗 Multi-Tool Adapter: Native support for generating configurations for Claude Code, Cursor, Kimi, Codex, Gemini, and GitHub Copilot.
• 🔄 Workflow Toggles: Easily enforce TDD, Conventional Commits, Feature Planning, and CHANGELOG generation.

🚀 Quick Start

1. Installation

(Note: Package is currently under development. Installation instructions will be updated upon release.)

npm install -g ultrapilot

2. Launch the Web UI

Navigate to your project's root directory and run:

cd my-awesome-project
skill-gen ui

This will start the local Express server and open the React dashboard at http://localhost:3000.

3. Configure Your Toolchain

1. Select Tools: Check the boxes for the AI agents you use (e.g., Claude Code, Cursor).
2. Select Language/Framework: Choose your stack (e.g., TypeScript + React). UltraPilot will fetch relevant skills from its local registry.
3. Select Workflows: Toggle optional rules like TDD or Feature Planning.
4. Generate: Click generate. UltraPilot will write the files and symlinks directly into your project.

🏗 Architecture

UltraPilot is built as a monorepo with a Node.js CLI backend and a React (Vite) frontend.

• src/server/: Express REST API and CLI entry points.
• src/client/: React + TailwindCSS Web UI.
• src/core/knowledge/: Registry syncing and SKILL.md parsing.
• src/core/adapter/: Multi-tool symlink and file generation.
• src/core/llm/: OpenAI-compatible gateway for RAG composition.

For detailed design decisions, see docs/specs/2026-04-17-ultrapilot-design.md.

🤝 Contributing

We welcome contributions! If you are using an AI coding agent (like Claude Code) to contribute to this project, it will automatically read the rules defined in AGENTS.md and the skills in .agents/skills/.

Development Setup

# Clone the repository
git clone https://github.com/idadawn/ultrapilot.git
cd ultrapilot

# Install dependencies
pnpm install

# Start the development servers
pnpm dev:server  # Terminal 1
pnpm dev:client  # Terminal 2

Please review our Implementation Plan before picking up a task.

📄 License

This project is licensed under the MIT License.