brave-history 1.2.0
Search brave history from the command-line
License: BSD
Keywords: brave, history, cli, command-line

# brave-history
**@readwithai** - [X](https://x.com/readwithai) - [blog](https://readwithai.substack.com/) - [machine-aided reading](https://www.reddit.com/r/machineAidedReading/) - [📖](https://readwithai.substack.com/p/what-is-reading-broadly-defined
)[⚡️](https://readwithai.substack.com/s/technical-miscellany)[🖋️](https://readwithai.substack.com/p/note-taking-with-obsidian-much-of)

Search Brave browser history from the command-line.

## Caveats
This program uses the `History` sqlite database provided by Chrome. This is not updated immediately. I was getting delays in the order of 8 seconds when I tested this out.

`mozeidon` seems to give virtually instant data but requires considerably more configuarion than this tool which just works.

## Motivation
History is useful; GUIs are irritating; the command-line has a lot of features.

People often remeber information about the pages they have visiting on the internet and then want to refer to it for further work, quote it, or share it. This is one of the values of the history functionality in most browsers, but using the GUI interface that browser provides can be time consuming and fiddly. The command-line has a number of utilities (include custom one's generated by the user) for interacting with data. Additionally the command-line makes it possible to use data once found.

## Installation
You can install [brave-history from PyPi](https://pypi.org/project/brave-history/) using [pipx](https://github.com/pypa/pipx).
```
pipx install brave-history
```

## Usage
To search your history for some terms run:
```
brave-history github brave
```
This searches the url and the titleof the page.

`brave-history` has many flags, some not documented here, you can see this with `brave-history --help`


## Alternatives and prior work
It should be noted that much of the tooling for Chrome can be adapted to Brave.

Brave exposes and sqlite database with history. You may prefer to access this directly for your use cases, particularly if you want to remove dependencies.

[mozeidon](https://github.com/egovelox/mozeidon) is a command-line tool with a corresponding browser extension for Chrome which can fetch history, bookmarks and control tabs. I deemed the extension too heavy-weight for my purposes - it requires the installation of a browser extension, two command-line programs, and editing Chrome's configuration files. It does perform certain other functionality such as querying and interacting with tabs where there may be no alternative to using this approach.

## References
1. [Browsing Chrome history and bookmarks with fzf](https://junegunn.github.io/fzf/examples/chrome/)

## About me
I am **@readwithai**. I create tools for reading, research and agency sometimes using the markdown editor [Obsidian](https://readwithai.substack.com/p/what-exactly-is-obsidian).

I also create a [stream of tools](https://readwithai.substack.com/p/my-productivity-tools) that are related to carrying out my work.

I write about lots of things - including tools like this - on [X](https://x.com/readwithai).
My [blog](https://readwithai.substack.com/) is more about reading and research and agency.

[![@readwithai logo](./logo.png)](https://readwithai.substack.com/)