# Ai Coding Kit

> One-kit AI coding workflow — Agent Skills, MCP config sync, iOS engineering rules & RAG Gateway for Cursor, Codex, Claude Code, CodeBuddy, Gemini, Continue, Cline & Xcode

- **Type:** MCP server
- **Install:** `agentstack add mcp-i-stack-ai-coding-kit`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [i-stack](https://agentstack.voostack.com/s/i-stack)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [i-stack](https://github.com/i-stack)
- **Source:** https://github.com/i-stack/ai-coding-kit

## Install

```sh
agentstack add mcp-i-stack-ai-coding-kit
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# ai-coding-kit

[](skills-engineering/README.md)
[](skills-engineering/ios-engineer/SKILL.md)
[](sync/README.md)
[](https://github.com/i-stack/ai-coding-kit/actions/workflows/validate.yml)
[](https://github.com/i-stack/ai-coding-kit/actions/workflows/hardcoded-paths.yml)
[](LICENSE)

> **One kit. All your AI coding tools.** Agent Skills management, MCP configuration sync, and iOS engineering rules — unified for Cursor, CodeBuddy, Codex, Claude Code, Gemini CLI, Continue, Cline, and Xcode Coding Assistant.

**ai-coding-kit** is a local-first AI coding workflow toolkit. Define your MCP servers, API keys, Agent Skills, and platform settings once — auto-sync to every AI coding host you use.

面向 AI Coding / Agentic Coding / MCP（模型上下文协议）的多工具本地工程化工具包。为同时使用多个 AI 编码工具的开发者提供统一的 Agent Skill 维护、MCP 配置同步、iOS 工程规则和本地嵌入式知识库。

## Quick Start

```bash
git clone https://github.com/i-stack/ai-coding-kit.git
cd ai-coding-kit

# 唯一需要编辑的文件
cp env/secrets.json.example env/secrets.json
$EDITOR env/secrets.json

# 一键同步
bash sync.sh
```

## 平台支持

当前主要开发和测试环境为 **macOS**。部分平台模块（如 Codex 同步中的 Xcode 集成、`.zshrc` 导出）在 macOS 外不可用。

欢迎 Windows 用户在 Windows 上验证并提交 PR。核心同步逻辑已尽量保持跨平台，适配改动预计较小。

## 模块

各模块有独立的 README，按需深入：

| 模块 | 说明 | 文档 |
|------|------|------|
| **skills-engineering/** | Agent Skill 内容源、多端同步、受控演进 | [README](skills-engineering/README.md) |
| **sync/** | MCP 配置同步引擎，注入 secrets 渲染到各平台原生格式 | [README](sync/README.md) |
| **env/** | 配置数据源（secrets + MCP 定义 + 平台配置） | [README](env/README.md) |
| **skills-engineering/plan-reviews/** | Plan 知识库 —— 自动索引 plan-grill/cross-model-review 产物，语义搜索 + 实体图谱 | [README](skills-engineering/plan-reviews/README.md) |
| **hooks/** | 项目钩子脚本（xmcp 初始化等） | [README](hooks/README.md) |
| **.githooks/** | Git 提交/推送守卫（pre-commit + pre-push） | [README](.githooks/README.md) |

## Supported AI Coding Tools

| Tool | Synced Config |
|------|--------------|
| **Cursor** | `.cursor/mcp.json` |
| **CodeBuddy** | `.codebuddy/mcp.json`, `models.json`, `skills/` |
| **Claude Code** | `.claude.json`, `settings.json`, `skills/` |
| **Codex CLI** | `.codex/config.toml`, `mcp.generated.toml` |
| **Gemini CLI** | Environment variables |
| **Continue** | `.continue/config.yaml` |
| **Cline** (VSCode) | MCP settings JSON, `skills/` |
| **Xcode Coding Assistant** | Codex + Claude Agent config paths |

## 安装 Git 钩子

```bash
bash install-hooks.sh
```

启用 pre-commit（规则变更治理）、post-commit（evolution 历史自动 GC）和 pre-push（推送前强制同步校验）。详见 [.githooks/README.md](.githooks/README.md)。

## What is MCP?

[Model Context Protocol (MCP)](https://modelcontextprotocol.io/) is an open protocol that lets AI coding tools connect to external services — GitHub, Playwright, databases, APIs, design tools — through a standardized interface. **ai-coding-kit** gives you one place to define all your MCP servers and syncs them to every tool that supports MCP.

## Who This Is For

- **Developers using multiple AI coding tools** — define MCP servers and Agent Skills once, sync everywhere.
- **iOS / Swift engineers** — production-grade AI coding rules for Swift, SwiftUI, UIKit, concurrency, testing, and migration.
- **AI infrastructure builders** — local embedded knowledge base with semantic search and entity graph, zero external services.
- **Team maintainers** — single source of truth for MCP configuration, API keys, and model settings.

## License

[MIT](LICENSE)

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [i-stack](https://github.com/i-stack)
- **Source:** [i-stack/ai-coding-kit](https://github.com/i-stack/ai-coding-kit)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-i-stack-ai-coding-kit
- Seller: https://agentstack.voostack.com/s/i-stack
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.