Quick start

Install Statuz, connect Bluesky and schedule your first post in two minutes.

1. Install

With Homebrew, on macOS or Linux:

brew install intenseloop/tap/statuz

Or with npm:

npm i -g statuz-cli

Bun and a shell script work too: Install.

2. Set up

statuz init

Creates ~/.statuz and an agent guide (AGENTS.md, skills), then lists the agent apps it finds (Claude Code, Codex, Cursor, Gemini CLI, Claude Desktop and more) so you can pick which ones use Statuz. Safe to rerun.

3. Connect an account

statuz accounts connect --platform bluesky

Approve in the browser. The token goes into your OS keychain.

  • Mastodon: add --server mastodon.social (your server).
  • X and LinkedIn: need your own developer app first. See Accounts. Statuz Cloud brings its own.

4. Schedule a post

statuz posts create --text "Hello from Statuz" --to bluesky --at "tomorrow 9am"

Leave out --at to publish now. More in Scheduling.

5. Start the daemon

Terminal
statuz start
statuz status

The daemon sends scheduled posts and survives reboots. status shows what's next and what needs you.

Computer often off at post time? Use Statuz Cloud.

Next