https://github.com/studiometa/alfred-productive-workflow
An Alfred workflow to interact with your Productive organization
https://github.com/studiometa/alfred-productive-workflow
alfred alfred-workflow productive productive-io
Last synced: 3 months ago
JSON representation
An Alfred workflow to interact with your Productive organization
- Host: GitHub
- URL: https://github.com/studiometa/alfred-productive-workflow
- Owner: studiometa
- License: mit
- Created: 2024-03-06T15:14:02.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-09-18T20:49:39.000Z (9 months ago)
- Last Synced: 2025-09-18T22:59:33.317Z (9 months ago)
- Topics: alfred, alfred-workflow, productive, productive-io
- Language: PHP
- Homepage:
- Size: 15.7 MB
- Stars: 2
- Watchers: 4
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# alfred-productive-workflow
An [Alfred](https://alfred.app/) workflow to quickly interact with your [Productive.io](https://productive.io) organization.
## Installation
Download the workflow from the [latest release](https://github.com/studiometa/alfred-productive-workflow/releases/) 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_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](https://github.com/crazywhalecc/static-php-cli) for the static PHP executables and to [brandlabs/productiveio](https://github.com/brandlabs/productiveio) for the [Productive.io](https://productive.io) SDK
## To-do
- [ ] Clean log files periodically (daily ?)
- [ ] Display error notification when starting a timer has failed