# Install klog with Homebrew, apt, dnf, MacPorts, Nix, winget, zypper

Command-line tool for time tracking in a human-readable, plain-text file format. Version 7.1 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:klog
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install klog
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install klog
```

  Evidence: MacPorts ports tree: office/klog/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- Debian apt (92%):

```sh
sudo apt install klog
```

  Evidence: Debian stable package indexes: klog from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- dnf (92%):

```sh
sudo dnf install klog
```

  Evidence: Fedora Rawhide package metadata: klog from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst

- Nix (92%):

```sh
nix profile install nixpkgs#klog
```

  Evidence: nixpkgs package indexes: pkgs/by-name/kl/klog/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- zypper (92%):

```sh
sudo zypper install klog
```

  Evidence: openSUSE Tumbleweed package metadata: klog from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

### Windows

- winget (92%):

```sh
winget install --id EA4K.KLog -e
```

  Evidence: Windows Package Manager source index: EA4K.KLog from https://cdn.winget.microsoft.com/cache/source.msix

## Package facts

- **Package key:** brew:klog
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/klog>
- **Version:** 7.1
- **Source summary:** Command-line tool for time tracking in a human-readable, plain-text file format
- **Homepage:** <https://klog.jotaen.net>
- **Repository:** <https://github.com/jotaen/klog>
- **Upstream docs:** <https://github.com/jotaen/klog/blob/main/Specification.md>
- **License:** MIT
- **Source archive:** <https://github.com/jotaen/klog/archive/refs/tags/v7.1.tar.gz>
- **Generated:** 2026-07-08T18:08:21+00:00

## Executables

- klog (cli)
- klog (alias)

## Build dependencies

- go

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 7.1
- Local data: ok
- Upstream repository: https://github.com/jotaen/klog
- Upstream latest detected: v7.1 (current)
- info: No package-manager update timestamp was available.
## Project history and usage

klog is both a command-line time tracker and a plain-text time-tracking file format. Its documentation frames the format as a notebook-like way to keep work logs editable in any text editor while still supporting terminal queries and reports.

### Project history

Jan Heuermann created klog as a small Go tool and file format for human-readable `.klg` files. Version 1.0 was released on 2021-02-06 with commands for totals, reports, tags, and bookmarks; version 2.0 followed in March 2021 with commands for creating records and starting or stopping open-ended time ranges.

The file-format side became more explicit in version 2.6 on 2021-07-25, when the changelog records the first version of the formal file format specification. The repository notes that the command-line tool and the file-format specification use independent version numbering and different license terms.

### Adoption history

klog's adoption has been strongest among plain-text productivity users rather than large platform deployments. The project documentation lists installs through Homebrew, AUR, Nix, openSUSE, Go, and downloadable binaries, which is typical for a small cross-platform Go CLI that appeals to users already comfortable storing data in versionable text files.

### How it is used

A user writes records in `.klg` files, with dates, summaries, time ranges, durations, tags, open-ended ranges, and should-total annotations. The `klog` command then searches, totals, reports, edits bookmarks, and supports workflows where the same file remains readable without the tool.

### Why package nerds care

klog is package-nerd catnip because it treats the data format as the product, not merely as an implementation detail. It belongs in the lineage of Ledger, todo.txt, Markdown, and other small tools where durable text, predictable CLI output, and easy packaging matter more than a service backend.

### Timeline

- 2021-02-02: v1.0-rc release published on GitHub.
- 2021-02-06: v1.0 release added report, tags, bookmark, and renamed `eval` to `total`.
- 2021-03-16: v2.0 release added create, track, start, and stop commands.
- 2021-03-19: v2.1 release provided a native Windows binary.
- 2021-07-25: v2.6 release published the first file-format specification version.
- 2021-10-07: v3.0 release added named bookmarks, editor integration, and more report aggregation options.

### Related projects

- klog is related to plain-text accounting and productivity tools such as Ledger, hledger, todo.txt, Timewarrior, and Taskwarrior, but it keeps the domain focused on human-readable time logs.

### Sources

- <https://github.com/jotaen/klog>
- <https://github.com/jotaen/klog/blob/main/CHANGELOG.md>
- <https://github.com/jotaen/klog/blob/main/Specification.md>
- <https://klog.jotaen.net/>


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** klog
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- Debian apt - klog - 2.4.1-1.1: normalized package name match | Debian stable package indexes: klog from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | Multiplatform ham radio logging program | https://github.com/ea4k/klog
- Nix - klog: normalized package name match | nixpkgs package indexes: pkgs/by-name/kl/klog/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - klog - 2.3.3-2build2: normalized package name match | Ubuntu 24.04 LTS package indexes: klog from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | Multiplatform ham radio logging program | https://www.klog.xyz
- dnf - klog - 2.5.1-1.fc45: normalized package name match | Fedora Rawhide package metadata: klog from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | A Ham radio logging program for KDE | https://www.klog.xyz/
- zypper - klog - 7.1-1.3: normalized package name match | openSUSE Tumbleweed package metadata: klog from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Time tracking in a human-readable, plain-text file format | https://github.com/jotaen/klog
- zypper - klog-bash-completion - 7.1-1.3: normalized package name match | openSUSE Tumbleweed package metadata: klog-bash-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Bash Completion for klog | https://github.com/jotaen/klog
- zypper - klog-fish-completion - 7.1-1.3: normalized package name match | openSUSE Tumbleweed package metadata: klog-fish-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Fish Completion for klog | https://github.com/jotaen/klog
- zypper - klog-zsh-completion - 7.1-1.3: normalized package name match | openSUSE Tumbleweed package metadata: klog-zsh-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Zsh Completion for klog | https://github.com/jotaen/klog
- MacPorts - klog: normalized package name match | MacPorts ports tree: office/klog/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
- winget - EA4K.KLog: normalized package name match | Windows Package Manager source index: EA4K.KLog from https://cdn.winget.microsoft.com/cache/source.msix


## Related links

- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Language runtime packages](https://www.automicvault.com/pkg/language-runtime-packages/) - Matched language runtime, compiler, or interpreter metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [timewarrior](https://www.automicvault.com/pkg/brew/timewarrior/) - Shares av.db curated category or tags: cli, productivity, time-tracking.
- [tock](https://www.automicvault.com/pkg/brew/tock/) - Shares av.db curated category or tags: cli, go, productivity, time-tracking.
- [watson](https://www.automicvault.com/pkg/brew/watson/) - Shares av.db curated category or tags: cli, productivity, time-tracking.
- [utimer](https://www.automicvault.com/pkg/brew/utimer/) - Shares av.db curated category or tags: cli, productivity, time-tracking.
- [ata](https://www.automicvault.com/pkg/brew/ata/) - Shares av.db curated category or tags: cli, productivity, time-tracking.
- [beancount](https://www.automicvault.com/pkg/brew/beancount/) - Shares av.db curated category or tags: cli, plain-text, productivity.
- [cdargs](https://www.automicvault.com/pkg/brew/cdargs/) - Shares av.db curated category or tags: cli, productivity.
- [cloudpan189-go](https://www.automicvault.com/pkg/brew/cloudpan189-go/) - Shares av.db curated category or tags: cli, go, productivity.

## Combined YAML source

View the package source record on GitHub. [combined/klog.yml](https://github.com/automic-vault/db/blob/main/combined/klog.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
