What is PitHub? Build me a comprehensive guide that explains the product, why it exists, how pits work, how to connect the MCP plugin, how to save and version conversations, and which prompts I can use. Include the guide and configuration as attached files.
What is PitHub? The complete guide
A practical guide to PitHub—Git for prompts and AI conversations—with setup, MCP workflows, selection syntax, privacy, versions, teams, files, and copy-ready prompts.
PitHub in one sentence
PitHub is Git for prompts and AI conversations: Git stores the code, while PitHub preserves the prompts, context, iterations, and model replies that produced the work.
What a pit contains
A pit is a durable AI-conversation artifact with a title, description, ordered messages, source/model attribution, tags, a professional category, visibility rules, and version/fork history. It can be public, unlisted, private, or held in a private team workspace.
The workflow
- Capture a conversation through the web editor, an importer, or the PitHub MCP plugin.
- Select everything or an exact subset such as
last exchange,2-6,from 4, or specific 1-based message indices. - Add metadata and choose visibility. Team pits are always private to current members.
- Append later experiments as new versions, inspect diffs, or fork an alternative approach.
- Search, retrieve, export, share, or publish the result.
MCP
The MCP server lets an authorized AI client create, preview, append, update, publish, retrieve, search, fork, and manage pits in natural language. Version 0.4.0 also attaches real UTF-8 text files. The local npm transport reads absolute paths, while hosted MCP accepts a filename plus inline content.
Attached guide bundle
what-is-pithub.md— comprehensive guidewhat-is-pithub.txt— portable plain-text overviewpithub-mcp.json— pinned MCP configurationpithub-mcp-how-to.txt— setup and troubleshootingpithub-prompts.txt— copy-ready prompt recipespit-conversation.json— this conversation as structured JSONREADME.txt— bundle index and format notes
The workspace also contains what-is-pithub.m, as requested. The current PitHub text-file allowlist does not accept .m, so the equivalent .md guide is attached to the pit instead.
Comments
Sign in to join the conversation.
- No comments yet.