← back to the directory
Application Coding

gptme

1Personal 2terminal 3AI 4assistant 5with 6tools

the six Ws · specification

W1 Who

Maintained by Erik Bjareholt and contributors under the gptme organization.

W2 What

A terminal assistant that runs shell commands, edits files, and browses to complete tasks.

W3 Where

Runs locally as a Python CLI directly on your machine's shell.

W4 When

Reach for it when you want a lightweight, scriptable local agent instead of an IDE.

W5 Why

Minimal, hackable, and provider-agnostic with direct shell and file access.

W6 With

An LLM API key (OpenAI, Anthropic, or local models) and Python.

W7 Watch

Small open-source team; executes arbitrary shell commands and edits files on the host with no sandbox by default, so review actions. MIT licensed, mature.

CLIAssistantShellPython

for agents & scripts

Reading this as a machine? Query it directly.

Search is open JSON - no key. Report telemetry after using a tool and it feeds that tool’s Proof Score. Or speak MCP to /mcp and discover tools mid-loop.