Skip to content

An Alfred workflow to interact with your Productive organization

License

Notifications You must be signed in to change notification settings

studiometa/alfred-productive-workflow

Repository files navigation

alfred-productive-workflow

An Alfred workflow to quickly interact with your Productive.io organization.

Screenshot of the workflow running in Alfred

Installation

Download the workflow from the latest release and install it. You will be prompted to configure 2 variables:

  • PRODUCTIVE_ORG_ID: the ID of your organization on Productive, you can find it in the URL when logging in https://app.productive.io/<PRODUCTIVE_ORG_ID>-.../...
  • PRODUCTIVE_AUTH_TOKEN: a personal access token for the API, generate one in Settings → API integrations
  • PRODUCTIVE_PERSON_ID: your account ID on Productive, it can be found in the URL when you visit your profile: https://app.productive.io/ORG_ID-.../people/PERSON_ID/overview

Once this is done, open Alfred and use the pp keyword to list all tasks from your organization.

Troubleshooting

You may need to allow the execution of the static PHP CLI shipped with the Workflow. To do so, right click on the workflow in Aflred and choose "Open in Finder", then, if you are on a M1 or greater, right on the bin/php-8.2.13-cli-macos-arm64 (otherwise use the one ending with x86_64) file and choose Open with → Terminal. You should be prompted by macOS to indicate if you trust this executable or not, choose as you prefer (if you refuse, the workflow will not work), then quit the Terminal app.

Usage

The following commands are available:

Keyword Action
ppt Get all tasks
ppp Get all projects
ppd Get all deals
ppc Get all companies
ppg Get all people (g for gens which means people in French)
pps Get all services

Credits

Thanks to crazywhalecc/static-php-cli for the static PHP executables and to brandlabs/productiveio for the Productive.io SDK

To-do

  • Clean log files periodically (daily ?)
  • Display error notification when starting a timer has failed