Unofficial CLI for Toggl Track written in Rust, using the v9 API.
Building the binary.
cargo build # or cargo build --releaseInstalling the binary.
cargo install --path .This places the release optimized binary at
~/.cargo/bin/toggl. Make sure to add~/.cargo/binto your$PATHso that you can run the binary from any directory.
You can invoke the binary using the toggl command now. Alternatively you can also run the command directly using cargo run
cargo run [command]
# To list the last 3 time-entries
cargo run list -n 3The first command you need to run is auth to set up your Toggl API token.
cargo run auth [API_TOKEN] # or toggl auth [API_TOKEN]The API token is stored securely in your Operating System's keychain using the keyring crate.
Run the help command to see a list of available commands.
$ toggl help
toggl 0.3.0
Toggl command line app.
USAGE:
toggl [FLAGS] [OPTIONS] [SUBCOMMAND]
FLAGS:
--fzf Use fzf instead of the default picker
-h, --help Prints help information
-V, --version Prints version information
OPTIONS:
--proxy <proxy> Use custom proxy
SUBCOMMANDS:
auth
config Manage auto-tracking configuration
continue
current
help Prints this message or the help of the given subcommand(s)
list
running
start Start a new time entry. Call with no arguments to start in interactive mode.
stopYou can also run the help command on a specific subcommand.
$ toggl help start
toggl-start 0.1.0
Start a new time entry. Call with no arguments to start in interactive mode.
USAGE:
toggl start [FLAGS] [OPTIONS] [description]
FLAGS:
-b, --billable
-h, --help Prints help information
-V, --version Prints version information
OPTIONS:
-p, --project <project>
ARGS:
<description>To run the unit-tests
cargo testCommon lint tools
cargo fmt # Formatting the code to a unified style.
cargo clippy --fix # To automatically fix common mistakes.The CI will also run the lint commands for all pull-requests. See pull_request.yml for more details.
Built by the Watercooler Studio
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent