slack-status-cli icon indicating copy to clipboard operation
slack-status-cli copied to clipboard

Lightning fast Slack status updates! :zap:

Slack Status CLI

Lightning fast Slack status updates!⚡

See it in action :fire:

Setting things up :hammer:

  • Create a new Slack app
  • Select from an app manifest
  • Select your workspace
  • Paste the following YAML app manifest:
display_information:
    name: slack-status-cli
    description: Lightning fast Slack status updates!
oauth_config:
    scopes:
        user:
        - dnd:write
        - emoji:read
        - users.profile:read
        - users.profile:write
        - users:read
        - users:write
  • Create :rocket:
  • Install to workspace
  • Go to OAuth and permissions
  • Copy User Auth Token

Download :inbox_tray:

Get the latest version from Releases

Make it executable

chmod +x st_<version_platform_arch>

Move to your $PATH

mv st_<version_platform_arch> <$PATH>/st

Create new profile :bear:

st profile --create  # shorthand -c
Add your profile name and OAuth token: image

Usage :rainbow:

Add new status :headphones:

Add your status, duration and emoji

st add

Select status :eyes:

st set

Set yourself away :sleeping:

st away

Enable Do Not Disturb (DND) while away :mask:

st away --dnd <time duration>

Set yourself active :surfer:

Remove any status, or DND settings

st active

Profile management :wrench:

Set default profile If you have multiple slack profiles, select default profile using:

st profile --default  # shorthand -d

Manage profile: change name, token, delete or update status

Uses default profile:

st profile --manage  # shorthand -m

Select profile to manage:

st profile --manage --select # shorthand -m -s

Show current/default profile

st profile --show

Setting time duration :alarm_clock:

Valid durations for time includes:

minutes, hours or days. DEFAULTS to minutes

NOTE: use single or double quotes around the time duration values.

OPTIONS for the duration:

  • minute: m, min, mins :: Example: "10 m", "10 mins", 10minute, "10 minutes"

  • hour: h, hr, hour, hours :: Example: "1 h", 1hr, "1 hour", "1 hours"

  • day: d, day, days :: Example: 2d, "2 day", 2days