Installation

Installation

Homebrew (macOS Apple Silicon, Linux arm64/x86_64)

brew tap imohsenb/tap
brew install git-task

From source

Works on any platform; requires a Rust toolchain.

git clone https://github.com/<you>/git-task && cd git-task && ./install.sh
# or, without the installer script:
cargo install --locked --path .

Either path installs two binaries built from the same codebase:

• git-task, so git task <command> works as a git subcommand.
• gtask, a standalone alias with the identical command set (gtask new "title").

Pick whichever matches how you like to invoke it; nothing else differs between them.

man page

git task --help with no subcommand is intercepted by git itself, which tries to run man git-task. Without a man page installed, that just prints an error instead of help text. git task -h, git task help, and git task <command> --help all work regardless of this. Run the following once to fix the bare form too:

git task man --install

Shell completions

git task completions bash > /path/to/completions/git-task.bash
# also available: zsh, fish, powershell, elvish

Verifying the install

git task --version
git task whoami

whoami is a good first command to run: it reads your git identity (this repo's .git/config, falling back to the global ~/.gitconfig) and reports what name/email would be recorded as the author of any task you create. git-task has no --author override; identity always comes from git config.

Next: Getting Started.