PostDovo · Command-Line Tool

PostDovo CLI: Schedule Social Media Posts from Your Terminal

List your social accounts, save drafts with images or videos, and manage your posting schedule from a terminal or script.

Install the PostDovo CLI, sign in through your browser and use the postdovo command from any folder. On a server or in CI, use an access token instead.

Starter is $0/month and includes AI agents and full automation; Analytics is excluded.

Local Media UploadsAttach an image or video from your computer.
JSON ResponsesUse command results in scripts and with jq.
Browser or TokenSign in locally or supply a token for automation.

Quick Start

With Node.js and npm installed, run:

Install, sign in and list accounts
npm install -g postdovo
postdovo auth login
postdovo accounts

Choose an account_id from the response, then create a draft and schedule it using the detailed steps below.

What Is the PostDovo CLI?

The CLI is PostDovo’s own command-line tool. You give it explicit account ids, captions, media and scheduling details. It saves changes in the same PostDovo account you use in the web app.

It can create and edit drafts, attach media, schedule posts and take scheduled posts back to drafts. The current published package, 0.1.0, does not include an immediate-publish command, multi-post plan import from a file or analytics commands. Scheduled posts are published by PostDovo at their scheduled times.

Different from an AI agent CLI: this tool runs explicit PostDovo commands. An AI agent such as Claude Code or Codex can run those commands too, but installing this CLI does not itself add an MCP connector to that agent.

Install the CLI and Schedule Your First Post

01

Install the PostDovo CLI

The package requires Node.js 18.3 or newer. Use a currently supported Node.js release that meets this minimum. Check Node and npm in your terminal:

Check Node.js and npm
node --version
npm --version

Install PostDovo globally:

Install or update PostDovo
npm install -g postdovo

Run the same install command to update later. After installation, use postdovo from any folder.

02

Sign In Through Your Browser

Run:

Sign in to PostDovo
postdovo auth login

Your browser opens PostDovo. Sign in if asked, review the requested permissions and click Approve. Return to the terminal and wait for completion.

The CLI saves the sign-in on this computer and refreshes it when needed. Sign in again if the CLI requests it.

Check or End the Saved Sign-In

Check the active authentication
postdovo auth status
Forget the saved local sign-in
postdovo auth logout

Logout removes the saved sign-in on this computer. To revoke the authorization itself, disconnect PostDovo CLI in PostDovo’s Connected Agents settings. If a POSTDOVO_TOKEN environment variable is set, it takes precedence over the saved login and must be removed separately.

03

Check Your Identity and Social Accounts

Check the account, workspace and plan you are acting as, then list your connected social accounts:

Check identity and connected accounts
postdovo whoami
postdovo accounts

Each connected social account has an account_id. Copy the exact id for every account you want the post to target. The CLI does not select accounts for you.

Before choosing a format, inspect platform requirements and enabled permissions:

Check platform capabilities
postdovo accounts capabilities
04

Save a Post as a Draft

Replace YOUR_ACCOUNT_ID with an id from the accounts response:

Create a text draft
postdovo posts create --accounts YOUR_ACCOUNT_ID --caption "Hello from the terminal"

For several accounts, separate their ids with commas:

Create one shared post for multiple accounts
postdovo posts create --accounts FIRST_ACCOUNT_ID,SECOND_ACCOUNT_ID --caption "Our latest update"

The response contains the saved post details, its single_post_id and a link to review it in PostDovo. The post stays a draft unless you explicitly schedule it. Save the returned ids for later commands.

05

Schedule the Draft

Replace YOUR_SINGLE_POST_ID with the returned Single Post id. Choose your own future date, local time and timezone:

Schedule a Single Post
postdovo posts schedule YOUR_SINGLE_POST_ID --at 2026-12-01T09:30:00 --timezone Europe/Berlin

–at is the local date and time in the selected IANA timezone. If you omit –timezone, PostDovo uses the workspace’s timezone. The date above is an example; change it before running the command.

Create and Schedule in One Command

Create a draft and schedule it
postdovo posts create --accounts YOUR_ACCOUNT_ID --caption "Our December update" --schedule --at 2026-12-01T09:30:00 --timezone Europe/Berlin

The –schedule option requires –at. PostDovo does not choose a time for you.

Take a Single Post Back to Draft

Unschedule the whole Single Post
postdovo posts unschedule YOUR_SINGLE_POST_ID --single-post

This removes the schedule and returns the posts to draft; it does not delete them.

Add Images or Videos to Your Drafts

Use –image or –video with a local file or a public media URL. A public URL is not required when uploading a file from your computer.

Create a draft with a local image
postdovo posts create --accounts YOUR_ACCOUNT_ID --caption "Meet our latest product" --image "./launch.png"
Create a draft with a local video
postdovo posts create --accounts YOUR_ACCOUNT_ID --caption "Watch our latest update" --video "./launch.mp4"

Choose either image or video in one create command. Check each destination’s media requirements with accounts capabilities.

Attach Media to an Existing Draft

Attach an image using a post id
postdovo posts attach YOUR_POST_ID --image "./launch.png"

Know Which Id a Command Needs

IdUsed for
account_idThe connected social account receiving the post.
single_post_idThe combined Single Post; use for update and schedule.
post_idAn individual post; use for attach, get or delete as documented.

With posts get and posts unschedule, add –single-post when the supplied id refers to the whole Single Post.

Review or Edit a Draft

Review all posts in a Single Post
postdovo posts get YOUR_SINGLE_POST_ID --single-post
Update the draft caption
postdovo posts update YOUR_SINGLE_POST_ID --caption "An updated caption"

The CLI edits drafts. It does not rewrite content that has already been published.

Use an Access Token on a Server, in Scripts or in CI

When browser sign-in is unsuitable, create a dedicated access token in PostDovo. Supply it through the CLI’s environment; it overrides any saved browser sign-in.

Create an Access Token
Bash / Zsh — macOS, Linux or WSL
export POSTDOVO_TOKEN="YOUR_TOKEN"
Windows PowerShell
$env:POSTDOVO_TOKEN = "YOUR_TOKEN"

Replace the placeholder privately. In CI, store the token in the platform’s secret settings and expose it as POSTDOVO_TOKEN for the job. Avoid committing it or printing it in logs.

Verify the active account
postdovo whoami

Choose a Workspace

List available workspaces
postdovo workspaces
List accounts in another workspace
postdovo accounts --workspace YOUR_WORKSPACE_ID

Use –workspace on commands when you want a specific workspace, or set POSTDOVO_WORKSPACE in the environment.

Read JSON in a Script

Command responses are JSON, so you can pipe successful results into tools such as jq:

Format the accounts response
postdovo accounts | jq .

Check the command’s exit status when scripting. A draft can already exist if a later media upload or scheduling step fails; inspect the returned data before retrying creation.

PostDovo CLI Command Reference

CommandPurpose
postdovo auth loginBrowser sign-in and approval.
postdovo auth statusCurrent identity and authentication source.
postdovo auth logoutRemove the locally saved sign-in.
postdovo whoamiAccount, workspace, plan and limits.
postdovo workspacesAvailable workspaces.
postdovo accountsConnected social accounts and ids.
postdovo accounts capabilitiesPlatform requirements and enabled permissions.
postdovo posts listList posts; filter with –status, –platform, –from and –to.
postdovo posts get IDRead a post; add –single-post to use a Single Post id.
postdovo posts create …Create drafts; optional –image, –video or –schedule –at.
postdovo posts attach POST_ID …Add image or video media to a draft.
postdovo posts update SINGLE_POST_ID …Change draft caption, title or first comment.
postdovo posts schedule SINGLE_POST_ID –at TIMESchedule the drafts of a Single Post.
postdovo posts unschedule IDReturn scheduled posts to drafts; –single-post targets the whole group.
postdovo posts delete POST_IDDelete a draft when the account and plan permit it.
postdovo COMMAND –helpShow available command options.
Explore command options
postdovo --help
postdovo posts create --help
postdovo posts schedule --help

Environment Variables

VariablePurpose
POSTDOVO_TOKENToken authentication instead of saved browser sign-in.
POSTDOVO_WORKSPACEThe workspace to act in.
POSTDOVO_URLOverride the default server, https://app.postdovo.com.
POSTDOVO_CONFIG_DIROverride the saved sign-in location.

Exit Codes for Scripts

CodeMeaning
0Success.
1Error, including an action-specific plan limit.
2Invalid usage or choices still needed from the user.
3Not signed in.
4Access refused; read the server’s explanation.

Errors can include a PostDovo error code and a call reference. Include the reference when contacting support.

Watch the PostDovo CLI Tutorial

PostDovo CLI Video Tutorial
PostDovo CLI

Pricing, Permissions and Automation

$0/ month — PostDovo Starter

Starter includes up to five connected social accounts in one workspace, unlimited Single Post scheduling and publishing, and agent automation. Analytics is excluded.

The CLI follows your account’s assistant permissions and action-specific plan limits. PostDovo AI generation uses credits, and X publishing requires credits. The CLI does not silently choose an account, time or media item.

Several Posts in a Row

PostDovo can refuse a third separate creation within ten minutes when the posts should form one plan. If the new post is genuinely a separate matter, add –separate. Do not add it automatically to bypass grouping in a loop. Multi-post plan import is not included in this CLI version.

Want an AI agent to run these commands for you? Connect your terminal agent to PostDovo.

Troubleshooting and FAQs

Is a manually created access token required?

No. Browser sign-in is available on your own computer. Use an access token for a server, CI job or script where browser login is unsuitable.

Does logout revoke PostDovo CLI access?

No. It forgets the saved local sign-in. Disconnect PostDovo CLI in Connected Agents to revoke that authorization. A POSTDOVO_TOKEN environment variable is separate.

Why is postdovo not found after installation?

Open a new terminal and check that npm’s global executable directory is on PATH. Confirm installation completed and Node.js meets the package requirement.

Do images or videos need a public URL?

No. Supply a local file path with –image or –video. A public URL is an alternative if the media already has one.

Can this version publish immediately?

No. The current package supports drafts and scheduling, but does not provide an immediate-publish command. PostDovo publishes scheduled posts at their scheduled times.

Why did a scheduling or upload error still leave a draft?

Creation happens before attachment and scheduling. If a later step fails, inspect the saved Single Post id in the output before creating another draft.

Why is scheduling refused?

Check the selected timezone, future date, connected account, media requirements and the assistant scheduling permission. The server’s message explains any plan or access restriction.

Can Claude Code or Codex use the CLI?

Yes. An agent that can run commands can invoke the installed CLI. It uses the same token or saved sign-in and follows the same account permissions.

Schedule Your First Post from the Terminal

Install the CLI, sign in and choose your connected accounts. Create a draft, review it in PostDovo and schedule it for your chosen time.