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.
Quick Start
With Node.js and npm installed, run:
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
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:
node --version npm --version
Install PostDovo globally:
npm install -g postdovo
Run the same install command to update later. After installation, use postdovo from any folder.
Sign In Through Your Browser
Run:
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
postdovo auth status
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.
Check Your Identity and Social Accounts
Check the account, workspace and plan you are acting as, then list your connected social 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:
postdovo accounts capabilities
Save a Post as a Draft
Replace YOUR_ACCOUNT_ID with an id from the accounts response:
postdovo posts create --accounts YOUR_ACCOUNT_ID --caption "Hello from the terminal"
For several accounts, separate their ids with commas:
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.
Schedule the Draft
Replace YOUR_SINGLE_POST_ID with the returned Single Post id. Choose your own future date, local time and timezone:
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
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
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.
postdovo posts create --accounts YOUR_ACCOUNT_ID --caption "Meet our latest product" --image "./launch.png"
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
postdovo posts attach YOUR_POST_ID --image "./launch.png"
Know Which Id a Command Needs
| Id | Used for |
|---|---|
| account_id | The connected social account receiving the post. |
| single_post_id | The combined Single Post; use for update and schedule. |
| post_id | An 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
postdovo posts get YOUR_SINGLE_POST_ID --single-post
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 Tokenexport POSTDOVO_TOKEN="YOUR_TOKEN"
$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.
postdovo whoami
Choose a Workspace
postdovo workspaces
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:
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
| Command | Purpose |
|---|---|
| postdovo auth login | Browser sign-in and approval. |
| postdovo auth status | Current identity and authentication source. |
| postdovo auth logout | Remove the locally saved sign-in. |
| postdovo whoami | Account, workspace, plan and limits. |
| postdovo workspaces | Available workspaces. |
| postdovo accounts | Connected social accounts and ids. |
| postdovo accounts capabilities | Platform requirements and enabled permissions. |
| postdovo posts list | List posts; filter with –status, –platform, –from and –to. |
| postdovo posts get ID | Read 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 TIME | Schedule the drafts of a Single Post. |
| postdovo posts unschedule ID | Return scheduled posts to drafts; –single-post targets the whole group. |
| postdovo posts delete POST_ID | Delete a draft when the account and plan permit it. |
| postdovo COMMAND –help | Show available command options. |
postdovo --help postdovo posts create --help postdovo posts schedule --help
Environment Variables
| Variable | Purpose |
|---|---|
| POSTDOVO_TOKEN | Token authentication instead of saved browser sign-in. |
| POSTDOVO_WORKSPACE | The workspace to act in. |
| POSTDOVO_URL | Override the default server, https://app.postdovo.com. |
| POSTDOVO_CONFIG_DIR | Override the saved sign-in location. |
Exit Codes for Scripts
| Code | Meaning |
|---|---|
| 0 | Success. |
| 1 | Error, including an action-specific plan limit. |
| 2 | Invalid usage or choices still needed from the user. |
| 3 | Not signed in. |
| 4 | Access 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
Pricing, Permissions and Automation
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.