# jrnl

> Command-line journal application that creates, searches, and views entries stored as plain text, with optional AES encryption.

Stars: 7.4k · Language: Python · License: GPL-3.0 · Categories: Productivity

- Repository: https://github.com/jrnl-org/jrnl
- Website: https://jrnl.sh
- Page: https://www.trmn.sh/tools/jrnl

## Overview

jrnl is a journal application for the command line. It is used to create, search, and view journal entries from the terminal. Journals are stored as human-readable plain text files, and can optionally be encrypted with AES encryption.

Entries are created by passing text directly to the command, for example `jrnl yesterday: Called in sick. Used the time to clean the house and write my book.` The leading `yesterday:` is parsed as a timestamp. Text up to the first sentence ending (`.`, `?`, or `!`) becomes the title, and the remainder becomes the body. The resulting file entry looks like `[2012-03-29 09:00] Called in sick.` followed by the body on the next line.

Running `jrnl` with no arguments prompts you to compose an entry interactively. It can also be configured to use an external editor. The tool is aimed at developers and other terminal users who want a plain-text, optionally encrypted journal or note log. Fuller documentation is available at jrnl.sh.

## Alternatives

- [buku](https://www.trmn.sh/tools/buku.md): Command-line bookmark manager with search, browser import, encryption, and local web UI (Python, 7.2k stars)
- [scli](https://www.trmn.sh/tools/scli.md): Terminal user interface for Signal messaging with Vim-like navigation and external editor support (Python, 537 stars)
- [tempy](https://www.trmn.sh/tools/tempy.md): Terminal weather report tool displaying current and near-future conditions without requiring API keys (Python, 194 stars)
- [cheat.sh](https://www.trmn.sh/tools/chubin-cheat.md): Cheat sheet service queried with curl or the cht.sh client, covering 1000+ UNIX/Linux commands, 56 programming languages and several DBMSes. (Python, 41.8k stars)
- [gopass](https://www.trmn.sh/tools/gopass.md): Command-line password manager compatible with pass, supporting GPG encryption, Git versioning, and team collaboration (Go, 7.3k stars)

---

Canonical: https://www.trmn.sh/tools/jrnl