gptme

AI assistant in your terminal

Runs as gptme|macOS, Linux, Windows|gptme.org

Command form

ai-draft · 3 tasks · 11 fields

Start or resume a gptme conversation, optionally non-interactive. Sub-commands such as gptme-util, server and agent tools, and context-budget options are left out.

Opens the form; the finished command lands at your prompt, unrun

Run in Otty

otty gui gptme

Chat with gptmeExample values, fixed in this page — nothing here reaches a terminal

Basic

Prompt and context files

string

Model

string

Workspace directory

directory

TasksEach one presets the form for one job

Start a chat

promptsmodelworkspace

One-shot, non-interactive run

promptsmodelworkspaceoutput_formattools

Resume last conversation

resumeworkspace

ParametersOnly these flags are editable in the form

Prompt and context files

Words become the first prompt; existing file paths are added as context.
string · positional 0 · repeatable

Model

For example anthropic/claude-sonnet-4-5 or just a provider name.
string

--model-m

Workspace directory

path

--workspace-w

Resume most recent conversation

boolean

--resume-r

Conversation name

string

--name

Non-interactive

Run the prompt to completion without asking questions; implies skipping confirmations.
boolean

--non-interactive-n

Skip confirmation prompts

Lets tools run without asking first.
boolean

--no-confirm-y

Output format (non-interactive)

enum

--output-formattextjson

Allowed tools

Comma-separated tool names to allow.
string

--tools-t

Skip workspace context

boolean

--no-workspace

Verbose

boolean

--verbose-v

SourcesEvery flag above is checked against these

src

"--name", help="Conversation ID (used to resume). Defaults to a random name.", "-m", "--model", help="Model to use, e.g. {model_examples}. If only provider given then a default is used.", "-w", "--workspace", help="Path to workspace directory, or '@log' to use the log directory.", "-r", "--resume", help="Load the most recent conversation in this workspace. U…

helpmaster 2026-10-27

github.com

Before it fills your prompt, Otty checks the installed gptme against its version. A form that does not match your version is not offered.