gptme CLI Cheatsheet - Terminal AI Agent Full Reference

gptme is a personal agent that lives in the terminal and carries its own shell, Python, web and vision tools. It reads files, runs commands and fans out to sub-agents without pinning you to one provider. What separates it from a chat assistant is that it acts rather than advises, which means the two things that decide whether it helps are context and permissions. Index the project so retrieval carries your codebase into the conversation, and grant or revoke individual tools with +tool and -tool rather than enabling everything, especially anywhere the run is unattended. For scripting, -y removes the interactive confirmation and --output-format json returns structured output; together they are the prerequisite for wiring it into CI or a long-running job. Sections cover basic conversation, tools and context, and session and tool management. Because it runs commands, treat prompts as input to a program under your control: prefer narrow tool grants, and read the output before piping it into anything else.