The HourStack Slack app lets you tap into the power of HourStack from any Slack channel or direct message. The /hourstack command has actions to retrieve your scheduled tasks for the day, start and stop timers, complete tasks, create new tasks, and pull your stats. You can quickly turn a conversation into action by creating tasks right from Slack and efficiently track time on them.

You can also learn more via our listing in the Slack app marketplace.

How to Install the HourStack Slack App

When logged into the HourStack web app, navigate to your integrations list and click the Connect button on the Slack listing. You’ll be taken through the Slack authorization flow to approve the HourStack app to be installed into your Slack workspace.

Our app only needs permission for bot commands, which allow us to send responses back to you when you use the /hourstack command in Slack. We won’t have access to any of your information in Slack.

Once successfully authorized, Slack will be added to your list of connected integrations and the name of the Slack workspace you’ve installed it in will be shown. To disconnect the integration, click the manage link and select disconnect. This will revoke the permission you granted us in Slack and remove the integration from your list in HourStack.

HourStack Slack Slash Commands

Slash commands always start with /hourstack followed by the action you'd like to take. Some commands accept arguments as well to provide more context such as when creating a new task. The responses to commands are only visible to you, so you can safely post commands in any channel or direct message. Tip: you can send a direct message to yourself to keep your other channels clear.

Command Description
/hourstack help Lists all the actions available and a hint about how to use each action. This is handy as a reminder.
/hourstack list Lists all tasks for today. From this list, you can start timers, stop running timers, and complete any incomplete tasks.
/hourstack stats Provides daily and weekly stats including your total scheduled and logged time, the task you are currently running a timer on, and the scheduled and logged time for your active projects and labels.
/hourstack start Start a timer. Requires a name argument. Alternatively, use the list command to access a quick start button for each task.
/hourstack stop Stops any active timer you have running. No name is required since only one timer can run at a time to ensure tracking accuracy.
/hourstack complete Complete a task. Requires a name argument. Alternatively, use the list command to access a complete button for each task.
/hourstack new Creates a new task. Accepts name, duration, [project], and #label arguments, all of which are optional.
/hourstack workspaces List all of your workspaces. Click the switch to workspace button next to the workspace you'd like to use.
/hourstack workspace Switches your active workspace. Requires a name argument.

Usage Examples of HourStack Slack Slash Commands

Here are a few examples of how you can use the slash command with an action and include arguments when required.

Switching Workspaces

If you have multiple workspaces and one is named "Acme Design", to switch to that workspace, use the command /hourstack workspace Acme Design. or /hourstack workspaces and click the switch workspace button.

Creating Tasks Example

To create a new task called "Wireframes" that has a 1.5-hour duration under the project "Website redesign" with labels "UI" and "UX", use the command /hourstack new Wireframes 1h30m [Website redesign] #UX #UX. The duration accepts hours and minutes such as 1h30m, 75m, 1h, or 30m. Projects must be between brackets and labels require a hash tag before the first word.

Starting Timers Example

To start a timer for a task named "Homepage design", use the command /hourstack start Homepage design or /hourstack list and click the start timer button next to the task.