# Install harsh with Homebrew, apk, Nix

Habit tracking for geeks. Version 0.14.5 via Homebrew; verified 2026-07-27. Also installable with nix: nix profile install nixpkgs#harsh.

## Install

```sh
sudo av install brew:harsh
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install harsh
```

  Evidence: local Homebrew formula metadata

### Linux

- apk (92%):

```sh
sudo apk add harsh
```

  Evidence: Alpine Linux edge package indexes: harsh from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

- Nix (92%):

```sh
nix profile install nixpkgs#harsh
```

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

## Package facts

- **Package key:** brew:harsh
- **Package manager:** Homebrew
- **Version:** 0.14.5
- **Source summary:** Habit tracking for geeks
- **Homepage:** <https://github.com/wakatara/harsh>
- **Repository:** <https://github.com/wakatara/harsh>
- **Last updated:** 2026-07-27T14:32:23+02:00
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- harsh (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 0.14.5
## Project history and usage

Harsh Taskmaster is Daryl Manning's minimalist Go command-line habit tracker, built around editable text files, daily prompts, todo urgency, statistics, and long-range consistency graphs.

### Project history

Manning publicly released Harsh on May 26, 2020 after using the Rust program habitctl and finding that project no longer active. He kept its simple text-file and Seinfeld-chart ideas, rewrote the concept in Go to reduce build and installation friction, and added skips, warnings, score fixes, and corrected sparklines.

The project continued beyond its initial release series. By 2026 it supported habit end dates for long-range records, structured JSON output for agents and scripts, filtering, statistics, notes and amounts, and shell completions while retaining human-editable storage.

### Adoption history

The launch shipped Homebrew and Snap installation plus cross-platform binaries. The current README adds Arch AUR, DEB, RPM, APK, Go installation, and a one-line installer; supplied metadata also records Homebrew, Alpine, and Nix packaging.

### How it is used

`harsh ask` records today's habits, `harsh log` renders the last 100 days, and `harsh todo` shows pending habits with urgency. Users own and can directly edit the `habits` and append-only `log` text files, relocate them with `HARSHPATH`, and request structured output with `harsh log --json`.

### Why package nerds care

Harsh is a durable example of Unix-style personal software: a single Go binary, plain-text state, scriptable JSON, shell completions, and broad binary/package-manager distribution. It is both interactive enough for daily use and transparent enough for backups, Git, editors, and data analysis.

### Timeline

- 2020: Harsh is released as open source on May 26 with Homebrew, Snap, and binary installation.
- 2020: v0.8.1 begins the recorded GitHub release series.
- 2026: End dates and longer-range habit tracking are documented by the maintainer.
- 2026: v0.14.5 is released in June.

### Related projects

- habitctl supplied the core text-file and consistency-graph inspiration for Harsh.
- Emacs org-habits was evaluated by the author but rejected as too complex for his intended workflow.

### Sources

- <https://daryl.wakatara.com/better-habit-tracking-in-harsh/>
- <https://daryl.wakatara.com/harsh-a-minimalist-cli-habit-tracker/>
- <https://github.com/wakatara/harsh#readme>
- <https://github.com/wakatara/harsh/releases>
- source_facts.package-manager


## Security Notes

No matching local secret-handling manifest was found for harsh. Nucleus package metadata is still published here so future coverage has a stable package URL.



## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ~/.config/harsh/habits, ~/.config/harsh/log
- Windows: %APPDATA%\harsh\habits, %APPDATA%\harsh\log
## Other Package-Manager Records

- Nix - harsh: normalized package name match | nixpkgs package indexes: pkgs/by-name/ha/harsh/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- apk - harsh - 0.8.31-r21: normalized package name match | Alpine Linux edge package indexes: harsh from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Habit tracking for geeks | https://github.com/wakatara/harsh


## Combined YAML source

View the package source record on GitHub. [combined/harsh.yml](https://github.com/mxcl/pkgdb/blob/main/combined/harsh.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph
