ai-factory
v2.13.2
Published
CLI tool for automating AI agent context setup in projects
Maintainers
Readme

AI Factory
Stop configuring. Start building.
You want to build with AI, but setting up the right context, prompts, and workflows takes time. AI Factory handles all of that so you can focus on what matters — shipping quality code.
One command. Full AI-powered development environment.
ai-factory initWhy AI Factory?
- Zero configuration — installs relevant skills, configures integrations
- Best practices built-in — logging, commits, code review, all following industry standards
- Spec-driven development — AI follows plans, not random exploration. Predictable, resumable, reviewable
- Community skills — leverage skills.sh ecosystem or generate custom skills
- Stack-agnostic — works with any language, framework, or platform
- Multi-agent support — Claude Code, Cursor, Windsurf, Roo Code, Kilo Code, Antigravity, OpenCode, Warp, Zencoder, Codex CLI, Codex app, GitHub Copilot, Gemini CLI, Junie, Qwen Code, or any agent
Installation
Using npm
npm install -g ai-factoryUsing mise
mise use -g npm:ai-factoryQuick Start
# In your project directory (interactive wizard)
ai-factory init
# Or non-interactive with flags
ai-factory init --agents claude,codex --mcp playwright,githubThis will:
- Ask which AI agent you use (or use
--agentsflag) - Install relevant skills (or use
--skillsflag) - Configure MCP servers (or use
--mcpflag)
Then open your AI agent and start working:
/aifCodex CLI and Codex app use $aif style invocations after installation.
Need CLI flags, update/upgrade details, or extension commands? See Getting Started. Need slash-command reference? See Core Skills.
Example Workflow
# Explore options and requirements before planning (optional)
/aif-explore Add user authentication with OAuth
# Need a strictly verified answer before changing anything?
/aif-grounded Does this repo already support OAuth providers?
# Plan a feature — creates branch, analyzes codebase, builds step-by-step plan
/aif-plan Add user authentication with OAuth
# Optionally refine the plan with deeper analysis
/aif-improve
# Execute the plan — implements tasks one by one, commits at checkpoints
/aif-implement
# Create a knowledge reference from docs AI doesn't know about
/aif-reference https://docs.example.com/api-reference --name example-api
# Fix a bug — AI learns from every fix and gets smarter over time
/aif-fix TypeError: Cannot read property 'name' of undefined
# Set up CI pipeline — GitHub Actions or GitLab CI with linting, SA, tests
/aif-ci github
# Generate project documentation — README + docs/ with topics
/aif-docsSee the full Development Workflow with diagram and decision table.
Documentation
| Guide | Description |
|-------|-------------|
| Getting Started | What is AI Factory, supported agents, CLI commands |
| Development Workflow | Workflow diagram, when to use explore vs grounded, spec-driven approach |
| Reflex Loop | Iterative generate → evaluate → critique → refine workflow |
| Subagents | Bundled Claude subagents and the baseline Codex native agent-file bundle, including managed Codex config |
| Core Skills | All slash commands — explore, grounded, plan, fix, implement, evolve, docs, and more |
| Quality Gates | Machine-readable aif-gate-result summaries for verify, review, security, and rules gates |
| Skill Evolution | How /aif-fix patches feed into /aif-evolve to generate smarter skill rules |
| Plan Files | Plan files, self-improvement patches, skill acquisition |
| Security | Two-level security scanning for external skills |
| Extensions | Writing and installing extensions — commands, injections, MCP, agents |
| Configuration | .ai-factory.json, MCP servers, project structure, best practices |
| Config Reference | Full config.yaml key reference and skill read/write matrix |
Links
- Official Website - AI Factory website
- aif-handoff - Autonomous Kanban board built on AI Factory
- If AI Factory feels too simple for your goals, try HLV
- skills.sh - Skill marketplace
- Agent Skills Spec - Skill specification
- Claude Code - Anthropic's AI coding agent
- Cursor - AI-powered code editor
- OpenCode - Open-source AI coding agent
- Roo Code - AI coding agent for VS Code
- Kilo Code - Open-source agentic coding platform
- Windsurf - AI-powered code editor by Codeium
- Warp - Intelligent terminal with AI agent
- Zencoder - AI coding agent for VS Code and JetBrains
- Codex CLI - OpenAI's coding agent
- Codex app - OpenAI's coding agent app
- Gemini CLI - Google's coding agent
- Antigravity - AI coding agent
- Junie - JetBrains' AI coding agent
License
MIT
