Getting Started with the CLI

Run this in your terminal (macOS / Linux):

curl -fsSL https://slack.green/install.sh | bash

Requires Python 3.11+. The script installs sg-cli via pip and adds it to your PATH. Re-run anytime to update.

Don't have Python? Install it first: macOS — brew install python · Ubuntu/Debian — sudo apt install python3 python3-venv · Fedora — sudo dnf install python3

VPS (remote server): SSH into your server and run the same command above.

Open your terminal and run:

sg-cli

That's the only command you need to remember. Everything else happens inside the interactive TUI (terminal UI).

The CLI automatically starts a background daemon — a lightweight process that keeps your Slack status active. You can close the terminal and it keeps running.

Laptop vs VPS: On a VPS, the daemon keeps running even after you disconnect — you set it up once and forget about it. On your laptop, it stops when you shut down, so you'll need to run sg-cli again after rebooting. Not a big deal, but if that sounds annoying, we also sell a hosted cloud plan (also lifetime) that just works without running anything.

The CLI is a one-time purchase of $45.99 — no subscription. Head to Dashboard → Billing and grab the lifetime license.

Your license key (SG-XXXX-XXXX-XXXX-XXXX) will show up on your CLI dashboard.

On first launch, the CLI asks for your license key. Paste it in, hit Enter, and you're activated.

Shutdown guarantee: If Slack Green ever shuts down, we will release an DRM-free version of the CLI that works without license activation. Your purchase is permanent — you'll never lose access.

Press a in the TUI to add a workspace. You'll see a modal with two options:

• Chrome Extension Token — paste the JWT from the Chrome extension. Recommended because it auto-fills both tokens. (guide)
• Manual tokens — paste your xoxc and xoxd tokens separately. (guide)

The CLI verifies the tokens with Slack, then opens a schedule editor for the new workspace.

After adding a workspace, the schedule editor pops up automatically. You can also open it later by selecting a workspace and pressing c.

• Press w for weekdays only, e for every day
• Type times like 9am, 9:30, or 14:00
• Click Always On to skip scheduling entirely

Outside scheduled hours, the daemon pauses the workspace automatically.

The TUI shows your workspaces, their presence status, and the daemon health. Here's what you can do from here:

The daemon runs in the background — you can close the terminal tab and it keeps working.