BASHHISTORY
Generated by scripts/gen-format-pages.py from docs/data/format-metadata/, FILE_FORMATS.csv and docs/formats-master.csv. Do not edit by hand: change the source, then run the script.
BASH_HISTORY
Shell History Preview.
At a glance
| Purpose | A shell history file (bash or zsh): the commands a user ran, with timestamps when recorded. |
| Extensions | .bash_history |
| Poka parser | poka-shell-history |
| Viewer | poka-table-viewer |
| Depth tier | Parser with a shared viewer (see Depth tiers) |
| Breadth tier | B2 Broad (see Breadth tiers) |
How much Poka reads
B2 Broad. The common content of the current and the common older versions is decoded. Some named features or versions are not, and are listed.
Confidence: medium (the reviewer read the code). Basis: Reviewed 2026-10-26: read parsers/poka-shell-history/src/main.rs (191 lines) and plugin.json. No unit tests or tests/samples.rs; the corpus has no .bash_history, .zsh_history and .history sample. Covers .bash_history, .zsh_history and .history. The table lists every command with its time where the file records one (bash #timestamp lines or zsh extended history). Judgement: B2: every entry is shown; the gaps are limits, redaction by design and fields left raw.
What Poka does not read
- zsh's metafied bytes are not unmetafied, so non-ASCII text can show wrongly (judgement from the code)
- Multi-line commands are split into lines (judgement from the code)
- The zsh elapsed-time field is not shown
- Only the first 2,000 commands are listed
Libraries
Libraries Poka uses or has assessed for this format, with the status, licence and language the registry records.
- shellist (candidate; MIT; Rust; https://docs.rs/crate/shellist/0.3.0) — Library and CLI that parses bash, zsh and fish history; version 0.3.0 page checked.
- Plaso (bash_history text plugin) (candidate; Apache-2.0; Python; https://plaso.readthedocs.io/en/stable/_modules/plaso/parsers/text_plugins/bash_history.html) — Forensic timeline engine; plugin parses # epoch timestamp lines and multi-line commands. Licence taken from the main Plaso repository page.
Sources
- parsers/poka-shell-history/src/main.rs
- parsers/poka-shell-history/plugin.json