https://github.com/lauft/timew-bashcompletion
Bash completion for Timewarrior
https://github.com/lauft/timew-bashcompletion
bash-completion timewarrior
Last synced: 3 months ago
JSON representation
Bash completion for Timewarrior
- Host: GitHub
- URL: https://github.com/lauft/timew-bashcompletion
- Owner: lauft
- License: mit
- Created: 2017-09-02T19:33:15.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2024-05-29T12:55:42.000Z (about 1 year ago)
- Last Synced: 2025-02-23T06:50:18.917Z (3 months ago)
- Topics: bash-completion, timewarrior
- Homepage:
- Size: 25.4 KB
- Stars: 28
- Watchers: 3
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: ChangeLog
- License: LICENSE
Awesome Lists containing this project
README
# timew-bashcompletion
Bash completion for [Timewarrior](https://www.timewarrior.net)
## Installation
1. Clone the repository.
2. Copy or link the bash script to the appropriate place.
### Clone the repository
```
$ git clone https://github.com/lauft/timew-bashcompletion.git
```
### Copy/link the Bash script
You can either copy or symbolic link the bash script to install it.
For global installation the target directory is `/etc/bash_completion.d`:
```
$ cd /etc/bash_completion.d
$ ln -s /path/to/timew_bashcompletion_repo/timew
```
Alternatively you can source the completion script in your current shell.
## Usage
Type a (partial) Timewarrior command and hit `[TAB][TAB]`
List available commands:
```
$> timew[TAB][TAB]
cancel diagnostics help report stop untag
config export join shorten summary week
continue extensions lengthen show tag
day gaps month split tags
delete get move start track
```
Complete a partial command:
```
$> timew st[TAB][TAB]
start stop
```
For `timew tag` you can get a list of available tags after entering an id:
```
$> timew tag @2 [TAB][TAB]
TAG1 TAG2 TAG3
```
## Environment variables
With increasing size of your Timewarrior database the number of tags can also get quite large.
In consequence, the completion of tags can become quite slow.
With the environment variable `TIMEW_COMPLETION_TAGS_RANGE`, you can set a search range for your tags, e.g. `4w` for the last 4 weeks.
The default is `:all` for the complete database.
See `timew help ranges` and `timew help hints` for details on that.
## Limits
Currently, not all commands are fully supported - work in progress!
## License
This work is licensed under the [MIT licence](https://opensource.org/licenses/MIT).