gptme：终端里的通用 AI 智能体

Your agent in your terminal, equipped with local tools: writes code, uses the terminal, browses the web. Make your own persistent autonom…

gptme /ʤiː piː tiː miː/ what does it stand for? Getting Started • Downloads • Website • Documentation 📜 A personal AI agent that runs anywhere a terminal runs — your laptop, ssh sessions, tmux, headless servers, CI pipelines. Provider-agnostic, local-first, and unconstrained: ships with shell, Python, web, vision, and everything else an agent needs. A great coding agent, but general-purpose enough to assist in all kinds of knowledge-work. Free and open-source. Works with Anthropic, OpenAI, Google, SpaceXAI, DeepSeek, OpenRouter, Requesty, your existing ChatGPT/SuperGrok subscription, or fully local via Ollama and any OpenAI-compatible server — your data, your models, your terminal. A capable alternative to Claude Code, Codex, and Grok Bot, and a development-focused peer to self-hosted agents like OpenClaw and Hermes Agent — one of the first agent CLIs (Spring 2023), still in very active development. 📚 Table of Contents 📢 News 🎥 Demos 🌟 Features 🛠 Tools 🔌 Extensibility: Plugins, Skills & Lessons 🔗 Integrations: MCP & ACP 🤖 Autonomous Agents 🛡 Guardrails 🛠 Use Cases 🛠 Developer Perks 🚧 In Progress 🚀 Getting Started 🛠 Usage 🌍 Ecosystem 🏷️ Repository Badge 💬 Community 📊 Stats 📝 Citation 🔗 Links ❓ FAQ 📢 News 2026-09 - v0.34.0: Cross-harness memory (gptme-util memory, Claude Code & Codex integration), skills as slash commands, gptme service init for headless agents, context-scout pre-pass 2026-08 - v0.33.0: Hashline edit format, sandboxed Python/shell execution (Docker, Wasmtime), non-interactive exit taxonomy, gptme explain, server auth hardening 2026-07 - v0.32.0 & v0.32.1: Desktop app for Linux (AppImage), macOS, and Windows, with auto-updates since v0.32.1 — download here; ACP support, MCP server, Textual TUI; gptme.ai cloud service 2026-05 - gptme-plugin-registry created: central registry for plugin discovery 2026-02 - Scheduled dev pre-releases begin 2026-01 - gptme-agent-template v0.4: Bob has run extensively as an autonomous agent, autonomous run loops, enhanced context generation 2025-12 - v0.31.0: Background jobs, form tool, cost tracking, content-addressable storage 2025-11 - v0.30.0: Plugin system, context compression, subagent planner mode 2025-10 - v0.29.0: Lessons system for contextual guidance, MCP discovery & dynamic loading, token awareness; Bob begins autonomous runs with GitHub monitoring 2025-08 - v0.28.0: MCP support, morph tool for fast edits, auto-commit, redesigned server API 2025-03 - v0.27.0: Pre-commit integration, macOS computer use, Claude 3.7 Sonnet, DeepSeek R1, local TTS with Kokoro 2025-01 - gptme-contrib created: community plugins including Twitter/X, Discord bot, email tools, consortium (multi-agent) 2024-12 - gptme-agent-template v0.3: Template for persistent agents 2024-11 - Ecosystem expansion: gptme-webui, gptme-rag, gptme.vim, Bob created (first autonomous agent) 2024-10 - First viral tweet bringing widespread attention 2024-08 - Show HN, Anthropic Claude support, tmux tool 2023-09 - Initial public release on HN, Reddit, Twitter 2023-03 - Initial commit - one of the first agent CLIs For more history, see the Timeline and Changelog. 🎥 Demos Terminal UI Web UI Features Textual-based gptme-tui (pipx install 'gptme[tui]') Queue prompts while the agent is working Collapsible tool output Status bar with model, token usage, and agent state Or use the plain gptme CLI for scripted and non-interactive use Features Chat with gptme from your browser Access to all tools and features Modern, responsive interface Self-hostable Available at chat.gptme.org Fibonacci Mandelbrot with curses Steps Create a new dir 'gptme-test-fib' and git init Write a fib function to fib.py, commit Create a public repo and push to GitHub Steps Render mandelbrot with curses to mandelbrot_curses.py Program runs Add color Note The terminal recordings above are from 2023 and show the classic CLI. More recordings are kept in the Demo archive, and more up-to-date walkthroughs are in the Examples. 🌟 Features 💻 Code execution Executes code in your local environment with the shell and python tools. 🧩 Read, write, and change files Makes incremental changes with the patch tool. 🌐 Search and browse the web Can use a browser via Playwright with the browser tool. 👀 Vision Can see images referenced in prompts, screenshots of your desktop, and web pages. 🔄 Self-correcting Output is fed back to the assistant, allowing it to respond and self-correct. 📚 Lessons system Contextual guidance and best practices automatically included when relevant. Keyword, tool, and pattern-based matching. Adapts to interactive vs autonomous modes. Extend with your own lessons and skills. 🗃️ Cross-harness memory One local Markdown-based memory store shared by gptme, Claude Code, Codex, and any other harness. gptme-util memory CLI — save, recall, search, supersede, and audit entries from any terminal. Claude Code hook and Codex AGENTS.md integration included. 🤖 Support for many LLM providers Anthropic (Claude), OpenAI (GPT), Google (Gemini), SpaceXAI (Grok), DeepSeek, and more. Use OpenRouter or Requesty for access to 100+ models, or serve locally with Ollama, LM Studio, vLLM, or llama.cpp. Bring your own subscription: use your existing ChatGPT Plus/Pro or SuperGrok plan instead of API keys (see providers). Pick the right model per task — fast/cheap for triage, powerful for coding. 🌐 Web UI and REST API Modern gptme-webui bundled with gptme-server and hosted at chat.gptme.org. Server with REST API. Standalone executable builds available with PyInstaller. 💻 Computer use Give the assistant access to a full desktop, allowing it to interact with GUI applications. 🧠 Code intelligence Structural code understanding with gptme-codegraph: call graphs, symbol extraction, and impact analysis powered by Tree-sitter. 10 MCP tools for codebase navigation. 🔊 Tool sounds — pleasant notification sounds for different tool operations. Enable with GPTME_TOOL_SOUNDS=true. 🛠 Tools gptme equips the AI with a rich set of built-in tools: Tool Description