Unify customer data, automate workflows, and scale experiences with Einstein AI, Copilot, and Data Cloud in one CRM platform.
PostOwl CLI
About PostOwl CLI
PostOwl CLI is a command-line interface for scheduling and publishing social media content across multiple platforms. It allows users to draft posts, generate drafts using AI voice models trained on their own writing, and schedule or publish content directly from the terminal. The tool supports platforms including X (Twitter), LinkedIn, Instagram, TikTok, Threads, and Facebook. Commands accept plain-English scheduling such as “tomorrow 9am” or ISO timestamps, and can attach local media files during posting. The CLI integrates with scripts and CI pipelines through JSON output and environment variables, enabling automation workflows like cron jobs or GitHub Actions. Users can manage their posting queue, cancel scheduled posts, and view usage statistics entirely from the command line. Authentication is handled via a browser-based login that generates a local API key, avoiding terminal exposure of credentials.
Key features
- Draft posts in terminal
- Schedule posts with natural language dates
- Publish immediately or at scheduled time
- Attach local images or videos during posting
- Generate drafts using AI voice models
- Manage posting queue and cancel scheduled posts
- List connected social accounts
- Machine-readable JSON output for scripting
Use cases
- Automate social media posting via cron or CI pipelines
- Draft and schedule content without leaving the terminal
- Generate AI-assisted posts in a consistent personal voice
Pros
- Supports multiple social platforms (X, LinkedIn, Instagram, TikTok, Threads, Facebook)
- Plain-English scheduling without date pickers
- AI draft generation using user-trained voice models
- JSON output and environment variable support for automation
- Free and MIT-licensed
Cons
- Requires Node.js 18+
- No native mobile or GUI interface
- Depends on PostOwl account for posting limits
- Browser login required for initial setup
Frequently asked questions about PostOwl CLI
How do I install the PostOwl CLI?
Install the CLI by running 'npm install -g postowl'. Ensure you have Node.js 18 or newer and a free PostOwl account. After installation, use 'postowl login' to connect the CLI to your account via a browser-based authorization flow.
How do I queue or schedule a post from the terminal?
Use the 'postowl post create' command with the '--schedule' flag, such as 'postowl post create "Weekly update" --schedule "friday 9am"'. The CLI supports natural language dates like 'tomorrow 9am' as well as ISO timestamps. Scheduled posts publish even if your machine is offline.
How do I attach an image or video to a post?
Pass local media files using the '-m' flag, for example 'postowl post create "Demo time" -m ./demo.mp4'. The CLI uploads and attaches the file in one step. You can repeat the '-m' flag for multiple files or use a pre-uploaded media ID.
How do I post something I generated using AI?
Add the '--post' flag to the 'generate' command: 'postowl generate "launch recap" --post'. The CLI displays the draft and then prompts to publish or schedule it without requiring copy-paste. In scripts, you can pipe the output directly into a post creation command.
Which social platforms does the CLI support?
The CLI supports all platforms connected to your PostOwl account, including X (Twitter), LinkedIn, Instagram, TikTok, Threads, and Facebook. Accounts are connected once in the PostOwl dashboard and are automatically available in the CLI.
Can I use the PostOwl CLI in scripts and CI pipelines?
Yes. Every command supports '--json' for machine-readable output, and you can authenticate non-interactively by setting the 'POSTOWL_TOKEN' environment variable to an API key. This enables integration with GitHub Actions, cron jobs, or release scripts.