GPT Engineer CLI Cheatsheet - gpte Code Generation Full Reference

GPT Engineer sits in a different category from Copilot-style tools. It does not complete the function you are typing; it accepts a written requirement and materialises a whole runnable project directory on disk. The test for choosing it is whether your goal is a working skeleton from nothing - if so it removes the mechanical work of creating directories, declaring dependencies and writing a README. If you only need to change three lines in an existing file, the prompt overhead outweighs the benefit. This sheet is split into install and create, improve and feedback, and model and flags. Start with --steps, because it decides the internal workflow: clarify asks questions first, tdd writes tests first, and evaluate reviews an implementation without rewriting it, so the flow should follow the nature of the task rather than defaulting blindly. When improving an existing codebase, -i lets you select which files enter the context window, and selecting too much is the most common source of context overflow and drift. For a new project, drop the requirement into a file named prompt inside the project directory and pass only the path.

AI CLI·20 commands·Last updated 2026-09-10
gpt-engineergpteaicode-generationcliagentscaffold

Install and Create 4

pip install gpt-engineer
Install GPT Engineer
gpt-engineer projects/my-new-project
Generate a new project from prompt
gpte projects/my-new-project
Generate via the gpte alias (better UX)
gpt-engineer --help
Show all flags

Improve and Feedback 4

gpt-engineer -i projects/my-old-project
Improve an existing codebase
gpt-engineer --steps use_feedback
Iterate with feedback
gpt-engineer --use-custom-preprompts
Use project custom preprompts
gpt-engineer projects/x -i
Improve inside a project dir

Model and Flags 12

gpt-engineer projects/x --model gpt-4o
Select the generation model
gpt-engineer projects/x --model anthropic/claude-3-5-sonnet
Use an Anthropic model
gpt-engineer projects/x --temperature 0.1
Set generation randomness
gpt-engineer projects/x --steps tdd
Test-driven workflow
gpt-engineer projects/x --steps clarify
Clarify before coding
gpt-engineer projects/x --steps simple
Minimal steps for quick prototype
gpt-engineer projects/x -s default
Default workflow (short -s)
gpt-engineer projects/x --steps evaluate
Evaluate an existing implementation
gpt-engineer projects/x --verbose
Verbose logs
gpt-engineer projects/x -v
Short verbose logs
export OPENAI_API_KEY=sk-xxxx
Set the API key
gpt-engineer --version
Show version

Tips

  • Put a prompt file (no extension) named prompt in the project dir; the command only needs the directory path.
  • Improve mode (-i) lets you pick files for context, controlling scope precisely.
  • --steps sets the workflow: tdd, clarify, simple, or use_feedback, by task complexity.

FAQ

How is GPT Engineer different from IDE tools like Cursor?

It generates a whole codebase into a workspace dir, biased toward bootstrapping projects; IDE tools assist incrementally inside the editor.

Is OpenAI the only option?

OpenAI by default, but also Azure OpenAI, Anthropic, and local open models via --model and config.

Official References

Each command links to its official documentation below, so you can verify the latest usage and read deeper.

Maintained by LaoHand

Publicly updated on Sep 10, 2026, continuously proofread against official docs.

Contact Us

Wrong command or description? Send us corrections, business inquiries or product feedback by email.

Contact Us