Skip to content

gptme/gptme-contrib

Repository files navigation

gptme-contrib

Community-contributed plugins, packages, scripts, and lessons for gptme.

Overview

This repository contains:

Plugins

Plugins extend gptme's capabilities with custom tools and hooks. See plugins/README.md for details.

Plugin Description
gptme-ace ACE-inspired context optimization
gptme-attention-tracker Attention routing + history tracking for context management
gptme-claude-code Claude Code subagent integration
gptme-consortium Multi-model consensus decision-making
gptme-gptodo gptodo delegation plugin for coordinator-only agent mode
gptme-gupp Work persistence for session continuity
gptme-hooks-examples Example hook implementations
gptme-imagen Multi-provider image generation
gptme-lsp Language Server Protocol integration
gptme-ralph Ralph Loop pattern — iterative execution with context reset
gptme-retrieval Automatic context retrieval via semantic/keyword search
gptme-warpgrep Enhanced search with Warp-style filtering
gptme-wrapped Year-end analytics for your gptme usage (Spotify Wrapped-style)

Plugin Usage

Add to your gptme.toml:

[plugins]
paths = ["path/to/gptme-contrib/plugins"]
enabled = ["gptme_attention_tracker", "gptme_imagen"]

Packages

Reusable Python packages. See packages/README.md.

Package Description
gptmail Universal email system for AI agents
gptodo Task management CLI and utilities
gptme-activity-summary Activity summarization for agents — journals, GitHub, sessions, tweets, email
gptme-sessions Session tracking, analytics, and trajectory extraction
gptme-voice Voice interface using OpenAI Realtime API
gptme-whatsapp WhatsApp integration for agents via whatsapp-web.js
gptme_lessons_extras Lesson validation and tools
gptme_runloops Agent run loop patterns
gptme_contrib_lib Shared utilities

Scripts

Standalone scripts for automation. See each directory's README for details.

Directory Description
context/ Context generation for agent system prompts
discord/ Discord bot integration
github/ GitHub context generation, repo status
linear/ Linear issue tracking integration
telegram/ Telegram bot integration
twitter/ Twitter automation and monitoring
bluesky/ Bluesky integration
status/ Agent infrastructure status monitoring
workspace_validator/ Agent workspace structure validation

Lessons

Shared lessons provide reusable prompts and workflow patterns. See lessons/README.md.

Dependencies

Some scripts require additional dependencies:

# Required for scripts with uv run shebangs
pipx install uv

# Install all packages
uv sync --all-packages

Contributing

See CONTRIBUTING.md for guidelines on contributing new tools, plugins, or lessons.

Plugins and packages here are community-contributed and may not be as mature or stable as core gptme functionality. They're a great place to experiment and share!

License

MIT License - feel free to use and modify as you like!

About

Tools, plugins, lessons, and scripts for gptme and gptme-powered agents

Resources

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors