https://github.com/nonrational/short-sheet
Synchronize Shortcut ←→ Google Sheets
https://github.com/nonrational/short-sheet
google-sheets productivity project-management repl ruby shortcut
Last synced: about 2 months ago
JSON representation
Synchronize Shortcut ←→ Google Sheets
- Host: GitHub
- URL: https://github.com/nonrational/short-sheet
- Owner: nonrational
- Created: 2023-03-06T19:34:27.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-02-27T05:06:08.000Z (2 months ago)
- Last Synced: 2025-02-27T06:20:17.400Z (2 months ago)
- Topics: google-sheets, productivity, project-management, repl, ruby, shortcut
- Language: Ruby
- Homepage:
- Size: 216 KB
- Stars: 1
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# ShortSheet
A REPL wrapper for [Shortcut](https://shortcut.com/) and [Google Workspace](https://workspace.google.com/) to help product and project management.
## Summary
```
$ rake -T
rake config:check # Check config is valid
rake config:export # Export the config.yml file as a base64 encoded string
rake monthly_chores:create_current # Create the next monthly chores epic
rake monthly_chores:create_next # Create the next monthly chores epic
rake planning:prioritize_shortcut # Sort epics by sheet order and ready stories by priority
rake planning:review # Interactively review any out-of-sync initiatives and choose whether to update shortcut or the sheet
rake planning:update_sheet # Fetch information from shortcut and update the sheet with it
rake shortcut:iteration:create_next # Create the next iteration
rake shortcut:project_sync:run # Ensure that all stories with a project have the correct product area set
```
## Development
```shell
asdf plugin-add ruby
asdf install
gem install bundler
bundle
```
## Configuration
See `config.yml.example`
### Shortcut Credentials
Set `shortcut-api-token` in `config.yml` or `SHORTCUT_API_TOKEN` in `.env`.
### Google Workspace Credentials
1. Generate an OAuth2 Client at https://console.cloud.google.com/apis/credentials with the required scopes and permissions to access the Drive and Sheets APIs.
1. Download its JSON config to `client_secrets.json`.
1. Run `make serve` and visit http://localhost:4567 to fetch access and refresh tokens, saving them to `google_credentials.json`.
1. The refresh token will then automatically be used to refresh your credentials as necessary.
## Rake Completion via Homebrew
Tab completion for `rake` is really handy.
```sh
brew install bash bash-completion
curl -o "$(brew --prefix)/etc/bash_completion.d/rake" \
"https://raw.githubusercontent.com/ai/rake-completion/e46866ebf5d2e0d5b8cb3f03bae6ff98f22a2899/rake"
```
## Automation via GitHub Actions
Once you've got everything configured in `config.yml`, run `rake config:export` to produce a base64'd version suitable to drop into your ENV.