Start an interactive session in your project
getting started
// what it does
Running gemini with no arguments opens the interactive TUI in the current directory, which becomes the agent's workspace root. On first launch it walks you through authentication and theme, then loads any GEMINI.md context files it finds. Type a prompt and press Enter; the agent can read, edit, and run commands with your approval.
// shell
$ gemini// gotcha
The directory you launch from is the workspace boundary — the agent will not read files above it unless you pass --include-directories. Launch from your project root, not your home directory, or context discovery scans the wrong tree.