Get Started

Install FanOn, then let your coding agent use it.

FanOn is a local AI execution layer for coding agents. Install it, prepare local AI, connect your assistant, and initialize Repository Knowledge so your agent can ask FanOn what it knows and what happened.

Platform The installer detects your OS and CPU architecture automatically. Install method Contributor Setup Optional: Connect a coding assistant Integration status Instruction Flavor Integration/instruction style, not an install path.

Setup wizard

Install FanOn

Platform: macOS | Distribution: Installer Alpha | Assistant: None / CLI only | Flavor: Recommended

Step 1 - Install FanOn

Step 2 - Prepare local AI

fanon doctor --fix

Step 3 - Connect your coding agent

fanon agent install
fanon agent context

Step 4 - Initialize Repository Knowledge

fanon app init repository-knowledge --mode shared
fanon repo activate
fanon automation run repository-knowledge -y

Step 5 - Watch and explain FanOn activity

fanon log --tail
fanon log --explain --last

Ask your agent

How the pieces fit

Developer → Cursor / Codex / Claude Code → FanOn → Repository Knowledge / Logs / Local Models → Ollama

Connect assistant manually

Step 4 - Copy generated instructions

Troubleshooting

You're ready

✓ FanOn is installed
✓ Local AI is prepared or has clear doctor guidance
✓ Your coding agent can read fanon agent context
✓ Repository Knowledge is initialized for this repo
✓ fanon log can show what FanOn did

Alpha user guide MCP setup