https://github.com/thekuwayama/asaru
Asana Tasks Search CLI
https://github.com/thekuwayama/asaru
asana cli rust tui
Last synced: about 1 year ago
JSON representation
Asana Tasks Search CLI
- Host: GitHub
- URL: https://github.com/thekuwayama/asaru
- Owner: thekuwayama
- License: apache-2.0
- Created: 2021-12-25T12:45:18.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2022-03-02T14:31:36.000Z (over 4 years ago)
- Last Synced: 2025-04-23T23:04:59.079Z (about 1 year ago)
- Topics: asana, cli, rust, tui
- Language: Rust
- Homepage:
- Size: 8.18 MB
- Stars: 4
- Watchers: 0
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE-APACHE
Awesome Lists containing this project
README
# Asaru
[](https://crates.io/crates/asaru)
[](https://github.com/thekuwayama/asaru/actions?workflow=CI)
[](https://raw.githubusercontent.com/thekuwayama/asaru/main/LICENSE-APACHE)
Asaru (`漁る` - look for) is CLI to search Asana Tasks, by which you can do the interactive-search.
## Install
You can install `asaru` with the following:
```sh-session
$ cargo install asaru
```
or
```sh-session
$ brew tap thekuwayama/asaru
$ brew install asaru
```
## Usage
```sh-session
$ asaru --help
asaru 0.3.4
Asana Tasks Search CLI
USAGE:
asaru [file]
ARGS:
Globally unique identifier for the workspace or organization
Personal Access Tokens (PATs)
Output file
OPTIONS:
-h, --help Print help information
-V, --version Print version information
```
## Key Manual
| Key | Explanation |
|--------------------|-------------------------------------------------------------------------------------------------------------|
| Ctrl-c | Exit `asaru` command. |
| Ctrl-s | Move to Search Mode. |
| TAB | Select(check/uncheck) search results. |
| Enter | Search tasks if the cursor is at the prompt. Get task URLs if the cursor is at search results. |
| Backspace / Ctrl-h | Delete the character to the left of the cursor if the cursor is at the prompt. |
| ← / Ctrl-b | Move the cursor left. |
| → / Ctrl-f | Move the cursor right. |
| ↓ / Ctrl-n | Move the cursor down. |
| ↑ / Ctrl-p | Move the cursor up. |
| PageDown / Alt-v | Move the cursor to the bottom. |
| PageUp / Ctrl-v | Move the cursor to the top. |
| Ctrl-a | Move the cursor to the beginning of the text line. |
| Ctrl-e | Move the cursor to the end of the text line. |
| Ctrl-k | Delete all the text from the current cursor position to the end of the line if the cursor is at the prompt. |
| Ctrl-g | Redisplay the terminal. |
## Settings
You can read descriptions about Workspaces:
- https://asana.com/ja/guide/help/workspaces/basics
You can get all your accessible workspace IDs:
- https://app.asana.com/api/1.0/workspaces
You can issue your PATs:
- https://app.asana.com/0/my-apps
```sh-session
$ mkdir $HOME/.asaru
$ echo -n $WORKSPACE_GID > $HOME/.asaru/workspace_gid
$ echo -n $PATS > $HOME/.asaru/pats
$ echo "alias asaru='asaru \$(cat \$HOME/.asaru/workspace_gid) \$(cat \$HOME/.asaru/pats) \$HOME/.asaru/tmp && cat \$HOME/.asaru/tmp | xargs open && rm -f \$HOME/.asaru/tmp'" >> $HOME/.bashrc
$ source $HOME/.bashrc
```
## License
Licensed under either of
- Apache License, Version 2.0 ([LICENSE-APACHE](https://github.com/thekuwayama/asaru/blob/main/LICENSE-APACHE) or http://apache.org/licenses/LICENSE-2.0)
- MIT license ([LICENSE-MIT](https://github.com/thekuwayama/asaru/blob/main/LICENSE-MIT) or http://opensource.org/licenses/MIT)