gptme

Name: gptme
Author: gptme

Verified

Your agent in your terminal, equipped with local tools: writes code, uses the terminal, browses the web. Make your own persistent autonomous agent on top!

4,411stars

425forks

Python

Installation

# Add to your Claude Code skills
git clone https://github.com/gptme/gptme

Getting Started

Guides for using ai agents skills like gptme.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Security ReportVerified

Last scanned: 4/20/2026

{
  "issues": [],
  "status": "PASSED",
  "scannedAt": "2026-04-20T06:14:57.101Z",
  "semgrepRan": false,
  "npmAuditRan": true,
  "pipAuditRan": true
}

README.md

Frequently Asked Questions

What is gptme?

gptme is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by gptme. Your agent in your terminal, equipped with local tools: writes code, uses the terminal, browses the web. Make your own persistent autonomous agent on top!. It has 4,411 GitHub stars.

Is gptme safe to use?

Yes. gptme passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install gptme?

Clone the repository with "git clone https://github.com/gptme/gptme" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is gptme written in?

gptme is primarily written in Python. It is open-source under gptme on GitHub, so you can review or fork the full source.

Are there alternatives to gptme?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh gptme against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

ECC

by affaan-m

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

255,402

awesome-openclaw-usecases-zh ArcReel

⚠️ Third-Party Software Notice

This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.

Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.

Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.

Read the Terms of Service

📢 News

2026-07 - v0.32.1: Desktop app for Linux (AppImage), macOS, and Windows with auto-updates — download here; gptme.ai cloud service
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

[!NOTE] The screencasts below are from 2023. gptme has evolved a lot since then! For up-to-date examples and screenshots, see the [Documentation][docs-examples]. We're working on automated demo generation: #1554.

You can find more [Demos][docs-demos] and [Examples][docs-examples] in the [documentation][docs].

🌟 Features

💻 Code execution
- Executes code in your local environment with the [shell][docs-tools-shell] and [python][docs-tools-python] tools.
🧩 Read, write, and change files
- Makes incremental changes with the [patch][docs-tools-patch] tool.
🌐 Search and browse the web
- Can use a browser via Playwright with the [browser][docs-tools-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][docs-lessons]
- Contextual guidance and best practices automatically included when relevant.
- Keyword, tool, and pattern-based matching.
- Adapts to interactiv