Welcome to Egghead’s documentation!

Live Demo


Egghead Screenshot

Egghead is a browser history replacement that aims to let you actually make use of your browser history.

I personally haven’t found the default history app in Chrome to be very useful, and I’ve struggled to answer basic questions I have about pages I’ve visited in the past. For example–very commonly I found myself searching for something on Google, finding the answer, then wanting to go find that answer again to refresh my memory later. Chrome’s search may allow you to find the google search itself, but it offers no way of actually figuring out what where you went from there. Also, it doesn’t allow you to perform any sort of advanced searching other than a simple text query.

Egghead offers a faceted search engine that allows you to narrow things down to your heart’s desire. I built egghead after years of my own frustration with the default Chrome history, and I’ve personally found it quite useful so far. I hope you do too.

Technical Specs

Egghead is written entirely in Typescript and uses SQLite as its back end, and specifically it heavily relies on SQLite’s FTS5 module for searching.

It’s distributed as a browser extension; check the top of the README for links to install it on the Chrome web store (which also works for any chrome-compatible browser such as Brave and Edge) or the Firefox add-on store.

A live demo of the app is also available at egghead.camfeenstra.com. This demo will allow you to perform searches against a demo database, but in order to see the real power of egghead you’ll have to use it as an extension.

Development

Check out the development documentation for information on how to build and develop the extension for different targets.

Contact

If you have problems using this repository, please open an issue or reach out to me at cameron.l.feenstra@gmail.com for help.

License

Egghead is licensed under GPL v3.

Copyright (C) 2023 Cameron Feenstra

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.