Quickstart

Install the plugin, publish content, get a link.

What is pubthis?

pubthis is a publishing primitive for AI coding agents. You give it content — markdown, HTML, images, PDFs, plain text — and it gives you back a temporary, shareable URL.

The primary interface is natural language through your coding agent. You say "share this as a link" and pub handles the rest.

Setup with Claude Code

The fastest way to start using pub is with Claude Code. There are two ways to set it up:

Option A — Install the plugin

The plugin gives you both the publish MCP tool and the /pub slash command.

claude plugin marketplace add coreyrab/pubthis
claude plugin install pubthis

Option B — Add the MCP server directly

If you prefer to skip the plugin and add the MCP server yourself:

claude mcp add pubthis -- npx -y @pubthis/mcp-server

This gives you the publish tool but not the /pub slash command. The slash command is only available through the plugin install.

Then publish something

> Generate a summary of this project and share it as a link

I've generated a project summary and published it with pub.

Here's your link:

https://pubthis.co/a/01JABCDEFG

Expires in 7 days. Anyone with the link can view it.

Things you can say

"Share this report as a link"

"Publish this HTML preview"

"Give me a link to this markdown"

"Make this viewable for my team"

"Put this somewhere I can send it"

"Preview this in the browser"

Alternative: CLAUDE.md (zero-install)

If you prefer not to install a plugin, you can drop a CLAUDE.md file into your project root. Claude Code reads it automatically and will use the pub API directly — no plugin or MCP server required.

curl -o CLAUDE.md https://raw.githubusercontent.com/coreyrab/pubthis/main/CLAUDE.md

Self-hosting

pub is open source. To run your own instance:

git clone https://github.com/coreyrab/pubthis.git
cd pubthis
npm install
npm run dev

# → pub listening on http://localhost:3000

Set PUB_BASE_URL to your domain. To point the plugin at your instance, set the PUBTHIS_API_URL environment variable in your MCP server config.

Supported content types

text/plaintext/markdowntext/htmlapplication/pdfimage/pngimage/jpegimage/webp

Claude handles encoding and formatting automatically — just ask it to publish.