User Docs

Use these docs to connect accounts, build or write account versions, schedule posts, track results, work with replies and messages, use the CLI, or grant an AI tool access through MCP.

Provider data, formats, and actions remain limited by the connected account and provider.

For a visual introduction, watch the OpenPost product demo.

Web app

The web app is the main place to work.

• Workspaces keep brands, accounts, prompts, schedules, and media separate.
• Settings explains the Personal, Workspace, Organization, and Instance split.
• Account Security covers authenticator setup, one-time recovery codes, passkeys, and secure replacement or removal.
• Accounts explains how connected social accounts appear in a workspace.
• Composing Posts covers built-in AI drafting, account selection, media, account versions, and the editor.
• Agent-Assisted Publishing shows how an external MCP tool can prepare account versions while a person reviews the work.
• Threads covers multi-post sequences.
• Scheduling covers posting times, status, and errors.
• Auto Reposts covers native repost rules, engagement gates, delays, per-post overrides, and cross-workspace account access.
• Analytics covers account growth, post results, platform access, and update times. Analytics is an optional feature per connected account and starts off.
• Engagement, Inbox, and Notifications covers comments, replies, messages, and alerts. Direct messages and Comments and replies are separate optional features per connected account and start off.
• Grow covers recommendations for Bluesky and Mastodon. Grow is an optional feature per connected account, starts off, and never follows automatically.
• Media covers reusable files, designs, templates, brand items, tags, file sources, use checks, and safe cleanup.
• OpenPost Image Editor covers the no-account editor, multi-page still-image designs, saved versions, background removal, export, and return to the post editor.
• OpenPost Video Editor covers disk-backed projects, multitrack editing, motion, color, audio, captions, local models, export, and Media handoff.
• Quick Cut covers verified keyframe cuts, exact cuts, stream selection, merged output, and lossless packet-copy export.
• Recorder covers separate synchronized screen, camera, and microphone capture, recovery, and timeline insertion.

CLI

Use the CLI from a terminal, CI, cron, or a script that connects to a running OpenPost server.

• CLI Overview explains the command model.
• Installation covers release binaries and source builds.
• Authentication covers browser login, device flow, and API-token login.
• Posting covers posts, threads, media, rich publications, and next-slot.
• Automation covers CI and recurring jobs.
• Command Reference is generated from the Cobra command tree.

MCP

MCP lets an AI tool use the access you grant. Use it when ChatGPT, Claude, Cursor, Codex, or another tool should read workspace data, create drafts, tailor account versions, or schedule posts.

• Use OpenPost With an AI Assistant explains MCP access and safe use.
• MCP and ChatGPT App Developer Notes cover implementation details for contributors.

Where not to look

• Server setup, backups, social app keys, and server settings live in Self-Hosting.
• Code structure, backend and frontend details, API generation, and tests live in Developer Docs.