CLI overview¶
Run apogee --help to see the live list. The commands fall into seven groups.
| Group | Commands | What it does |
|---|---|---|
| Project | new |
Generates a brand-new project scaffold |
| Code generation | make:entity, make:value-object, make:use-case, make:repository, make:ai, make:rag |
Adds code to an existing project |
| Docker lifecycle | up, down, build, stop, restart, rebuild, logs, status, ps, shell, env:list |
Wraps docker-compose for the generated project |
| Database | db-context-create, db-context-migrate, db-context-seed |
Runs Alembic migrations and seeds inside the container |
| Infrastructure | add:*, remove:*, infra:* |
Adds/removes services (Postgres, Mongo, Redis, etc.) to/from docker-compose.yml |
| Frontend | fe:* |
Wraps the apogee-fe binary (React SPA generator) |
| Listings & utilities | info, ai:list, rag:list, setup, test, lint, bench, asgi, gil, framework:install |
Diagnostics and dev utilities |
Quick reference¶
Bash
# create a project
apogee new my-project
# code generation (run inside a project)
apogee make:entity Customer --field name:str --field email:str
apogee make:rag NaiveRag --vector qdrant --embedder openai
apogee make:ai assistant --provider openrouter --model claude-opus-4
# docker lifecycle
apogee up # docker-compose up -d
apogee logs # follow app logs
apogee shell # exec into the app container
apogee down --volumes # stop and remove volumes
# database
apogee db-context-create new_users
apogee db-context-migrate
# add infrastructure
apogee add:mongo
apogee add:redis
apogee add:qdrant
# frontend
apogee fe:new web --ui shadcn --bundler vite --lang ts