Can I use it in CI/CD pipelines?

Yes. Set OPENTWEET_API_KEY as an environment variable in your pipeline and use the opentweet tweet command to post on deploy, release, or any trigger. Works with GitHub Actions, GitLab CI, CircleCI, and any other CI system.

Do I need an OpenTweet subscription to use the CLI?

You need an OpenTweet account to use the CLI. A free trial is included. Scheduling, analytics, and evergreen features require a paid plan.

OpenTweet CLI

Post to X/Twitter
From Your Terminal

Schedule tweets, check analytics, and manage your evergreen queue without ever opening a browser. One npm install and you are done.

terminal

$npm install -g @opentweet/cli# install once

$opentweet auth# connect your account

$opentweet tweet "just shipped v2.0" --now# post immediately

$opentweet tweet "big announcement" --schedule "2026-05-15 09:00"# schedule it

$opentweet analytics# check your stats

$opentweet evergreen list# manage your queue

npm install -g @opentweet/cli

Requires Node.js 18+ • macOS, Linux, Windows

Up and Running in 60 Seconds

Three commands. No config files, no dashboards, no setup headaches.

Install the CLI

Run npm install -g @opentweet/cli once and the opentweet command is available everywhere on your machine.

npm install -g @opentweet/cli

Authenticate

Run opentweet auth, paste your API key from the OpenTweet dashboard, and you are connected. The key is saved locally so you never need to enter it again.

opentweet auth

Start Posting

Tweet immediately, schedule for later, or pipe it into a script. The interface stays out of your way.

opentweet tweet "hello world" --now

Schedule Tweets From the Command Line

Whether you are automating releases, batching content, or just prefer the terminal, the CLI fits into your workflow.

Tweet on deploy

Add one line to your GitHub Actions workflow and announce every release automatically.

$ opentweet tweet "v${{ github.ref_name }} is live" --now

Schedule a content batch

Write a week of tweets in your editor, schedule them all from the command line in seconds.

$ opentweet tweet "Monday tip: ..." --schedule "2026-05-12 09:00"

Morning analytics check

Pipe your stats into a cron job and get a terminal summary every morning.

$ opentweet analytics --tweets

Built for CI/CD Pipelines, Scripts, and Cron Jobs

Every feature in the OpenTweet dashboard is available from the terminal. Use it interactively or wire it into any automated workflow.

One Command to Post

Type your tweet and hit enter. No browser, no dashboard, no context switching.

Schedule From Anywhere

Pass a date and time and your tweet queues up automatically. Works in scripts too.

CI/CD Ready

Set OPENTWEET_API_KEY as an env var and tweet on every deploy, release, or tag.

Analytics in the Terminal

Check your posting stats, streaks, and top posts without leaving your workflow.

Evergreen Queue Control

Add posts to your evergreen rotation, pause them, or check what is queued up next.

Multi-Account Support

Pass --account to target any connected X account. Great for managing multiple handles.

All the Commands You Need

Everything is available from the opentweet command. Run opentweet --help at any time.

opentweet auth

Connect your API key

opentweet me

View account and plan details

opentweet tweet [text]

Create or schedule a tweet

opentweet list

List drafts, scheduled, or posted

opentweet publish <id>

Publish a draft immediately

opentweet schedule <id>

Set a scheduled time for a post

opentweet delete <id>

Delete a post (optionally from X)

opentweet analytics

Stats, streaks, and top posts

opentweet evergreen

Manage your evergreen queue

opentweet search <query>

Find tweet inspiration

opentweet accounts

List connected X accounts

Frequently Asked Questions

What is OpenTweet CLI?

It is an npm package that puts your entire OpenTweet account in the terminal. Post, schedule, check analytics, and manage your evergreen queue with a single command. No browser required.

How do I install the Twitter CLI?

Run npm install -g @opentweet/cli to install it globally. Then run opentweet auth and paste your API key from the OpenTweet dashboard. That is it. Requires Node.js 18 or later.

Can I use it in GitHub Actions or other CI/CD systems?

Yes. Set OPENTWEET_API_KEY as a secret environment variable in your pipeline and call opentweet tweet as a step. Works with GitHub Actions, GitLab CI, CircleCI, Buildkite, and anything that runs Node.

Does it support scheduling tweets?

Yes. Pass --schedule "2026-05-12 10:00" to any tweet command and it will be queued in your OpenTweet account and posted at that time automatically.

Does it support threads?

Yes. Use the interactive prompt (just run opentweet tweet with no text) to compose threads, or pass multiple lines. Threads schedule and post just like single tweets.

Do I need a paid plan?

You need an OpenTweet account. Drafts and basic posting work on the free trial. Scheduling, analytics, and evergreen features require a Pro or Advanced plan.

Does it work on Windows?

Yes. The CLI runs on macOS, Linux, and Windows. Any machine with Node.js 18 or later installed can run it.

Your Twitter Workflow,
Finally in the Terminal

Get your API key, install the CLI, and post your first tweet in under a minute.