# ddworken/hishtory

Your shell history: synced, queryable, and in context

Repository: https://github.com/ddworken/hishtory
Canonical: https://ross.abutalabs.com/products/hishtory
Homepage: https://hishtory.dev
Language: Go
License: MIT
License Family: permissive
Topics: bash, cli, history, zsh, fish, shell, golang
Last push: 2026-03-18T23:18:46+00:00

## Health v2 (maintenance only)
Score: 66/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 72, release rhythm 40, longevity 100
- inputs: {"age_days": 1695, "days_push": 168, "days_rel": 572, "gap_med": 2, "n_releases_24m": 24}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3114, forks 73 (observed 2026-08-28T04:07:44.081557+00:00)

## What it is
hiSHtory is a CLI tool that replaces your shell history with a richer, context-aware version storing the working directory, exit code, hostname, and timestamps for every command. History is stored locally, end-to-end encrypted, and synced across machines, with powerful query syntax and a Ctrl+R fuzzy search interface.

## Use cases
- find a complex command I ran on another machine
- search shell history by directory, hostname, or exit code
- sync bash/zsh/fish history across all my computers
- query shell history by date range
- redact accidentally recorded commands from history
- replace ctrl-r with a better history search

## When to choose
- you work across multiple machines and want unified shell history
- you need context (cwd, exit code, timestamp) for past commands
- you want encrypted syncing of shell history
- you use bash, zsh, or fish and want better Ctrl+R

## When to avoid
- you only use one machine and are happy with built-in history
- you prefer fully offline tools with no sync service dependency
- you use shells other than bash/zsh/fish

## Facets
- artifact type: cli-tool
- maturity: active
- function: search-engine, cli, developer-tools, cryptography
- domain: developer-tools, privacy
- platform: cli, cross-platform
- tags: shell-history, bash, zsh, fish, end-to-end-encryption, sync, terminal, command-line, linux, macos

## Member repositories
- ddworken/hishtory (main) score 66

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:44.081557+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:45:59.476072+00:00, confidence not recorded.
  - readme: https://github.com/ddworken/hishtory (fetched 2026-08-28T04:07:44.081557+00:00, sha 650153178c02)
  - homepage: https://hishtory.dev (fetched 2026-08-29T09:41:39.800396+00:00, sha 73e83baf6db4)
- Data as of 2026-08-30T08:39:29.467469+00:00.