# Tkcli > AI coding context that stays accurate for the life of your project — scaffold 14 stacks (incl. MCP servers) with per-stack CLAUDE.md/AGENTS.md/cursor/windsurf/copilot rules, then keep them synced as the project evolves. - **Type:** MCP server - **Install:** `agentstack add mcp-faruheaisha-tkcli` - **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior - **Seller:** [faruheaisha](https://agentstack.voostack.com/s/faruheaisha) - **Installs:** 0 - **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [faruheaisha](https://github.com/faruheaisha) - **Source:** https://github.com/faruheaisha/tkcli - **Website:** https://www.npmjs.com/package/@faruhe/tkcli ## Install ```sh agentstack add mcp-faruheaisha-tkcli ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About **English** | [简体中文](README.zh.md) # tk - AI-ready project scaffolding that stays in sync [](https://github.com/faruheaisha/tkcli/actions/workflows/ci.yml) [](https://www.npmjs.com/package/@faruhe/tkcli) [](LICENSE) [](https://nodejs.org) `tk` scaffolds real projects and the AI context files that help coding agents work inside them: `CLAUDE.md`, `AGENTS.md`, Cursor rules, Windsurf rules, GitHub Copilot instructions, and Claude Code permissions. The important part is what happens after day one: `tk sync` refreshes the managed region of `CLAUDE.md` from your real project structure and commands, while preserving your own notes. ## Quick Start ```bash npx @faruhe/tkcli quick my-app --stack nextjs npx @faruhe/tkcli quick my-api --stack express --addons docker,ci npx @faruhe/tkcli quick my-tool --stack mcp-server --ai-tool claude,cursor ``` Install globally if you use it often: ```bash npm install -g @faruhe/tkcli tk quick my-app --stack node-ts ``` ## What tk Generates ```text my-app/ |-- src/ or app/ # Stack-specific source layout |-- tests/ # Starter tests where the stack uses them |-- CLAUDE.md # Managed project context + user notes |-- AGENTS.md # Agent operating instructions |-- .claude/settings.json # Claude Code permissions |-- .cursorrules # Cursor rules |-- .windsurfrules # Windsurf rules |-- .github/copilot-instructions.md |-- .gitignore |-- .editorconfig `-- package.json / pyproject.toml / Cargo.toml / go.mod / pubspec.yaml ``` Use `--ai-tool` to keep only the rule files you actually need: ```bash tk quick my-app --stack express --ai-tool claude tk quick my-app --stack express --ai-tool cursor tk quick my-app --stack express --ai-tool claude,copilot ``` ## Supported Stacks tk supports 13 primary stacks, plus component/add-on modules such as `express-prisma`, `docker`, `ci`, and `security`. | Stack | Dev command | Best for | |-------|-------------|----------| | `node-ts` | `npm run dev` | TypeScript services | | `react-spa` | `npm run dev` | React + Vite apps | | `vue` | `npm run dev` | Vue 3 apps | | `nuxt` | `npm run dev` | Nuxt apps | | `express` | `npm run dev` | Express APIs | | `nextjs` | `npm run dev` | Next.js full-stack apps | | `fastapi` | `uvicorn src.main:app --reload` | Python APIs | | `rust` | `cargo run` | Rust CLIs and services | | `go` | `go run ./cmd/server` | Go services | | `flutter` | `flutter run` | Flutter apps | | `cli-ts` | `npm run dev -- hello` | TypeScript CLIs | | `mcp-server` | `npm run dev` | Model Context Protocol servers | | `python` | `python src/main.py` | Python scripts and libraries | ## Commands ```text tk quick [name] Scaffold a new project tk init Add AI context files to an existing project tk add Add a component or infra module tk update Re-render maintained template files tk sync Refresh CLAUDE.md from real structure tk refresh Run update + sync together tk diff Preview what tk update would change tk doctor Diagnose a tk-managed project tk list List stacks and modules tk info Show version and system info ``` ## Context That Stays Accurate `CLAUDE.md` is split into two regions: ```markdown **Stack:** Next.js | **Dev:** `npm run dev` | **Test:** `npm test` ## Commands ## Project Structure ## Project Notes - Your domain rules, decisions, gotchas, and local context live here. ``` Run `tk sync` whenever the project changes, or opt into automatic syncing for Claude Code: ```bash tk quick my-app --stack express --auto-sync ``` That writes a per-developer `.claude/settings.local.json` SessionStart hook. The file is meant to stay local, so teammates can opt in independently. ## Why It Helps Most scaffolders generate files once. tk treats AI context as something that should be maintained, because agents work better when their project map is current. Compared with generic scaffolding tools, tk focuses on: - AI context files for Claude Code, Codex-compatible `AGENTS.md`, Cursor, Windsurf, and GitHub Copilot. - Per-stack Claude Code permissions, so generated settings match the project toolchain. - A sync loop that refreshes commands and structure from real files. - Existing-project support through `tk init`, `tk update`, `tk sync`, and `tk doctor`. ## Development ```bash npm run dev -- quick my-test-app npm run build npm test ``` Node.js 20 or newer is required. ## License MIT ## Source & license This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [faruheaisha](https://github.com/faruheaisha) - **Source:** [faruheaisha/tkcli](https://github.com/faruheaisha/tkcli) - **License:** MIT - **Homepage:** https://www.npmjs.com/package/@faruhe/tkcli 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-faruheaisha-tkcli - Seller: https://agentstack.voostack.com/s/faruheaisha - 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%.