Fonij CLI

The AI-first product builder CLI - from idea to the right architecture, a working project, and safe evolution as the product grows.

Documentation · Discussions · Issues

“What do we build for, if not to lessen each other’s hardship?”

What it does

Fonij turns product intent into a maintainable project:

Idea → Requirements → Architecture → Project → Evolution

It prefers the smallest architecture that satisfies the product, then lets the project grow when requirements change.

Core commands

fonij plan
fonij create
fonij add
fonij inspect
fonij doctor
fonij agent prepare

• plan — recommend an architecture without writing files
• create — generate a project from a validated blueprint
• add — evolve an existing project
• inspect — explain the current Fonij project
• doctor — check the local development environment
• agent prepare — generate AI coding-agent context

Quick start

pnpm dlx @fonijbuild/cli plan
pnpm dlx @fonijbuild/cli create my-product

For local development:

pnpm install
pnpm check
pnpm dev -- --help

Principles

• Product requirements before technology choices
• Deterministic planning after AI intent extraction
• Progressive architecture instead of premature complexity
• Safe, inspectable project migrations
• Independently maintainable foundations

Architecture knowledge lives in fonij-catalog.

Contributing

Read CONTRIBUTING.md before opening a pull request. Security issues must follow SECURITY.md.