AI Factory CLI
A CLI that sets a project up for an agent in one command: skills, MCP and plan-driven development via /aif.
- 1,164 ★ on the repository
- Last commit
Extended access
Why this level
- The `init` wizard adds skills and MCP configuration to the project, and MCP servers gain access to services such as GitHub.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/ai-factoryDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The `init` wizard adds skills and MCP configuration to the project, and MCP servers gain access to services such as GitHub.
This is third-party code. Review the repository files before installing.
What it does
AI Factory sets up an environment for AI development with `ai-factory init`. A wizard asks which agent you use, installs the right skills and connects MCP servers such as `playwright` and `github`, and flags do the same without questions: `--agents claude,codex --mcp playwright,github`. Claude Code, Cursor, Codex CLI and the Codex app, GitHub Copilot, Gemini CLI, OpenCode, Roo Code, Kilo Code, Warp and others are supported. Development follows a plan instead of guesswork. The agent gains commands: `/aif-explore` for requirements, `/aif-grounded` for a strictly verified answer, `/aif-plan` for a plan with a branch and code analysis, `/aif-improve` for deepening the plan, `/aif-implement` for step-by-step execution with commits at checkpoints, `/aif-fix` for fixes that accumulate experience, `/aif-ci` for CI setup, `/aif-docs` for documentation and `/aif-reference` for docs the agent does not know. Codex uses `$aif` instead of a slash. Skills can be taken without the CLI via `npx skills add lee-to/ai-factory --skill '*'`, but then there are no `init`, `update`, automatic MCP setup or wizard. Extensions bring commands, injections, MCP and agents.
Who it is for. Developers who work with several AI agents and want one project setup and a repeatable process from idea to code.
Good fit when
- A new project to prepare for Claude Code and Codex with skills and MCP in a minute.
- A task to split into a plan, run step by step and resume after a break.
- CI setup on GitHub Actions or GitLab CI with linters and tests.
- The agent lacks a library's documentation and you need a reference built from a URL.
- A team wants one shared set of rules and skills across projects.
Not a fit when
- You need one ready skill, where the CLI and wizard are overkill and `npx skills add` is enough.
- You do not want a tool changing skill directories and MCP settings in the project.
- The task is small and fits one request with no plan.
Example request
Run ai-factory init for Claude Code and Codex with the playwright and github MCP, then plan adding OAuth login with /aif-plan.Limitations
Node.js and npm are needed to install the package. `init` writes skill files and MCP configuration into the project, so review the changes in git. Installing only skills through skills.sh leaves out the CLI commands, automatic MCP setup, agent transformers and the wizard. The license is not detected in GitHub metadata, so check the LICENSE file. A full command breakdown is in `docs/skills.md` and `docs/getting-started.md`.
How to disable. Run `npm uninstall -g ai-factory`, then delete the agent skill directories and MCP entries that `init` added to the project.
FAQ
Which commands does AI Factory give?
`/aif-explore`, `/aif-grounded`, `/aif-plan`, `/aif-improve`, `/aif-implement`, `/aif-fix`, `/aif-ci`, `/aif-docs` and `/aif-reference`. Codex calls them through `$aif`.
Can I take only the skills?
Yes: `npx skills add lee-to/ai-factory --skill '*'`. Then the CLI, automatic MCP setup and wizard are unavailable.
Which agents does it work with?
Claude Code, Cursor, Codex CLI and the Codex app, GitHub Copilot, Gemini CLI, OpenCode, Roo Code, Kilo Code, Warp and others.
What does the wizard do on init?
Asks for the agent, installs skills and connects MCP servers. The same choices can be set with the `--agents`, `--skills` and `--mcp` flags.
How do I update?
Through `ai-factory update` and `upgrade`, with details in `docs/getting-started.md`.
Discussion
No questions or reviews yet.
Related
CLI toolsOver twenty skills for coding agents: MCP and hooks, plan mode, a bug-fix protocol, prompting and a bash safety hook
A skill that analyzes a repository and generates files for AI agents: AGENTS.md, pointers, reviewers, CI and templates
AI Code Toolkit
aicode-toolkit
Plugins and MCP servers for coding agents: template-based projects, patterns before a file edit and review against YAML rules.
Agent, skill, rule and template sets for 19 AI tools, from the software lifecycle to incident analysis
An Emacs package that gives Codex, Claude Code, Gemini CLI and other agents one shared menu and the same commands
Kode CLI is a terminal coding agent that reads AGENTS.md and CLAUDE.md, connects MCP servers and works with many models.
README in short
The authors present AI Factory as one-command setup: the right skills, MCP and spec-driven development instead of random exploration. Installs through npm or mise.