CLI for time tracking and flex time balance.
- Time tracking
- Projects and tags
- Flex time balance
- Vacation, holiday, and sick day tracking
Each release has archives for Linux and macOS:
x86_64-unknown-linux-muslandaarch64-unknown-linux-muslfor Linux, linked statically, so they run on any distributionx86_64-apple-darwinandaarch64-apple-darwinfor Intel and Apple Silicon Macs
Download the archive for your system from the releases page, verify that it was built from this repository, and unpack it:
version=v0.3.0
target=aarch64-apple-darwin
curl -LO "https://github.com/woylie/ebb/releases/download/$version/ebb-$version-$target.tar.gz"
gh attestation verify "ebb-$version-$target.tar.gz" --repo woylie/ebb
tar -xzf "ebb-$version-$target.tar.gz"Without the GitHub CLI, you can compare the archive with the SHA256SUMS file of
the release instead, using sha256sum -c --ignore-missing SHA256SUMS on Linux
or shasum -a 256 -c --ignore-missing SHA256SUMS on macOS.
Then move the ebb binary to a directory on your PATH.
nix profile install github:woylie/ebb/v0.3.0If the binary can't be found, ensure your Nix profile is in your PATH.
export PATH="$HOME/.nix-profile/bin:$PATH"With Cargo:
git clone https://github.com/woylie/ebb.git --branch v0.3.0
cd ebb
cargo build --release
./target/release/ebbWith Nix:
nix build github:woylie/ebb/v0.3.0
./result/bin/ebbThe Nix package includes completions for bash, fish and zsh. With any other installation, you can generate shell completions with:
ebb generate-completions --shell <SHELL>To see a list of available shells, run:
ebb generate-completions --helpThe user guide describes configuration, time tracking, reporting, days off and data storage, and includes the command-line help.
The repo contains a flake.nix. You can get into a development shell with all
required packages with nix develop. If you have direnv installed, you can
also run direnv allow.
Run all checks via flake:
nix flake checkRun tests:
cargo testFormat Rust code:
cargo fmtFormat Nix code:
nixfmt flake.nixFormat anything else:
prettier . --writeLint Rust code with Clippy:
cargo clippy --all-targets --all-features --no-depsCheck licenses with cargo-deny:
cargo deny check licensesCheck Reuse compliance:
pipx run reuse lintAdd SPDX header to file:
pipx reuse annotate --copyright="YOUR NAME" --license="AGPL-3.0-or-later" <filename>Generate the command-line help in the book:
./gen-docs.shPreview the book:
mdbook serve bookGenerate THIRD_PARTY file:
./gen-third-party.shRelease a new version:
- Bump the version with
./bump.sh major,minor,patch,preor an explicit version, e.g../bump.sh 0.3.0. - Merge the change, tag the merge commit and push the tag, e.g.
git tag v0.3.0 && git push origin v0.3.0. - The tag starts the Release workflow, which creates a draft release for the tag and attaches the binaries. Once it has finished, add the release notes to the draft and publish it, which also publishes the book.