Español GitHub

Review, approve and publish
your social content.

For your team and your AI agents. Comments on the exact frame, approvals bound to the exact file, and a calendar that publishes to nine networks.

Self-host Postbay Open source on GitHub
  • Instagram
  • Facebook
  • YouTube
  • TikTok
  • LinkedIn
  • X
  • Threads
  • Pinterest
  • Bluesky

Publishes to nine networks

Feedback on
the exact frame

Comment on a moment of a video, a point of an image or a page of a PDF, and draw on it. Every comment keeps the version it was made on, so nothing gets lost between rounds.

How review works

A moment or a span

Each comment keeps its time, or a whole stretch of it.

v1 against v2

Side by side, or with a wipe across the frame.

What each network covers

Where each network puts its buttons.

Images, carousels and PDFs

Pin a comment to a point on any slide or page.

Approvals that
mean something

An approval is bound to the fingerprint of the exact files someone looked at, for the accounts they chose. Change one byte and it no longer counts.

How approvals work

Bound to the exact file

A new cover, a reordered carousel or one changed byte voids it.

Never your own upload

Whoever uploaded it cannot approve it.

Open comments block it

Every thread gets an answer first.

Several approvers and a checklist

Each brand decides how many approvals a version needs and what has to be checked first.

A calendar that
publishes by itself

At the planned time Postbay publishes to Instagram, Facebook, YouTube, TikTok, LinkedIn, X, Threads, Pinterest and Bluesky, or gets everything ready for a person to post. Then it reads what each post earned.

How publishing works

Weekly slots and blocked days

Free slots ask for content, and nothing goes out on a blocked day.

Or by hand

At the hour, the files, the text and the first comment are ready to copy.

Results per network

Each network with its own numbers, never added together.

A pause button

In a crisis, nothing goes out until someone resumes.

Made for AI agents,
with guardrails

A request for changes can become a new version without anyone’s hands. Signed webhooks wake an agent runner; the agent works through the comments, uploads the next version and answers each one: fixed, cannot do, or needs a person.

How the agent works

A round, start to finish

Every run is in the ledger: what woke it, what it cost, what it answered.

Pairs with drawn-by-code

Videos made with code by Claude, not generated. When a piece comes from a drawn-by-code project, the agent edits it, renders it again and uploads the result.

Meet drawn-by-code

Budgets per piece and per month

Without both set, the agent does not start.

A limit of rounds

Three by default, then the piece goes to a person.

Comments for people only

A reviewer marks them, and the agent leaves them alone.

An agent never approves

Its token uploads and replies. Approving is for people.

Do it from Claude

Postbay is an MCP server. Ask Claude what is pending, leave comments, upload a folder of videos or plan the week. It signs in as you, with your role. No keys to copy.

Install the Claude Code plugin
$ claude plugin marketplace add \
    illodev/postbay
$ claude plugin install \
    postbay@postbay

Two commands

The plugin adds a skill for each workflow, from uploading a batch to working through a review.

Yours, on your own server.

One Docker Compose file runs it all: the app, a worker, PostgreSQL, S3-compatible storage and automatic TLS. Your files and your accounts never leave your machine.

Read the deployment guideGitHub
$ git clone https://github.com/illodev/postbay.git && cd postbay
$ cp deploy/.env.example deploy/.env   # your domains and secrets
$ docker compose -f deploy/docker-compose.yml \
    --env-file deploy/.env up -d --build