TLDR;

• Handle your tabs, groups, bookmarks and history from outside of your web-browser.
• 🤓 Install of the mozeidon cli
• 📖 CLI Reference Documentation
• ✨ Desktop applications based on mozeidon CLI

Mozeidon is essentially a CLI written in Go to handle Mozilla Firefox OR Google Chrome tabs, history, and bookmarks.

Here you'll find :

• a guide to complete the installation of the mozeidon components (see architecture).
• advanced examples of the CLI usage (including integration with fzf and fzf-tmux)
• a Raycast extension built around Mozeidon CLI (for MacOS only)
• a MacOS desktop app built around Mozeidon CLI (for MacOS only)

All the code is available here as open-source. You can be sure that :

• your browsing data (tabs, bookmarks, etc) will remain private and safe: mozeidon will never share anything outside of your system.
• at any time, stopping or removing the mozeidon firefox (or chrome) addon extension will stop or remove all related processes on your machine.

Using the mozeidon CLI (see CLI reference), you can :

• list all currently opened tabs
• list recently-closed tabs
• list, delete current history
• list current bookmarks
• switch to a currently opened tab
• open a new tab (empty tab or with target url)
• close a currently opened tab
• pin/unpin a currently opened tab
• group/ungroup a currently opened tab
• create, delete, update a bookmark

Example output showing tabs with jq formatting

Example output showing tabs with --go-template formatting

Example output showing tabs within custom fzf-tmux script

Mozeidon is built on ipc and native-messaging protocols, using the following components :

• the Mozeidon firefox or chrome add-on, a JS script running in the Mozilla (or Chrome) browser, receives commands and sends back data (i.e tabs, bookmarks, etc) by leveraging various browser APIs.

• the Mozeidon native-app, a Go program, interacts with the Mozeidon firefox-addon. It sends commands to, and receive data from the browser addon - via native-messaging protocol.

• the Mozeidon CLI, another Go program, interacts with the Mozeidon native-app. It sends commands to and receive data from the native-app - via ipc protocol.

You need to install at least 3 components :

• the Mozeidon firefox add-on or the Mozeidon chrome add-on
• the Mozeidon native-app
• the Mozeidon CLI

The mozeidon addon for Mozilla Firefox can be found here :

https://addons.mozilla.org/en-US/firefox/addon/mozeidon

Latest version : 3.0 ( previous versions may not work with our latest CLI versions )

The mozeidon addon for Google Chrome can be found here :

https://chromewebstore.google.com/detail/mozeidon/lipjcjopdojfmfjmnponpjkkccbjoipe

New version coming soon : 3.0 ( previous versions may not work with our latest CLI versions )

The mozeidon native-app, a very simple ipc server written in go, will allow the mozeidon add-on to receive commands from and send responses to the mozeidon CLI (see below).

On MacOS or Linux, you can install it using homebrew :

brew tap egovelox/homebrew-mozeidon ; brew install egovelox/mozeidon/mozeidon-native-app ;

Otherwise, you may download the binary from the release page.

If no release matches your platform, you can build the binary yourself:

git clone https://github.com/egovelox/mozeidon-native-app.git ; cd mozeidon-native-app && go build

On MacOS, first locate the ~/Library/Application Support/Mozilla/NativeMessagingHosts directory (or create it if missing).

Then create a mozeidon.json file, and copy into it the following json.

Note: depending on your installation, you may need to replace the value in "path" with the absolute path of the mozeidon-native-app.

{ "name": "mozeidon", "description": "Native messaging add-on to interact with your browser", "path": "/opt/homebrew/bin/mozeidon-native-app", "type": "stdio", "allowed_extensions": [ "mozeidon-addon@egovelox.com" ] }

Now the Mozeidon firefox-addon will be able to interact with the Mozeidon native-app.

Note : For other OS than MacOS, please check the Mozilla documentation to find the correct location of the Firefox NativeMessagingHosts directory.

As a last step, you need to install the Mozeidon CLI.

On MacOS, first locate the ~/Library/Application Support/Google/Chrome/NativeMessagingHosts directory (or create it if missing).

Then create a mozeidon.json file, and copy into it the following json.

Note: depending on your installation, you may need to replace the value in "path" with the absolute path of the mozeidon-native-app.

{ "name": "mozeidon", "description": "Native messaging add-on to interact with your browser", "path": "/opt/homebrew/bin/mozeidon-native-app", "type": "stdio", "allowed_origins": ["chrome-extension://lipjcjopdojfmfjmnponpjkkccbjoipe/"] }

Now the Mozeidon chrome-addon will be able to interact with the Mozeidon native-app.

Note : For other OS than MacOS, please check the Chrome documentation to find the correct location of the Chrome NativeMessagingHosts directory.

As a last step, you need to install the Mozeidon CLI.

The Mozeidon CLI is a lightweight CLI written in go.

📖 Complete CLI Reference Documentation

On MacOS or Linux, you can install it using homebrew :

brew tap egovelox/homebrew-mozeidon ; brew install egovelox/mozeidon/mozeidon ;

Otherwise, you may download the binary from the release page.

If no release matches your platform, you can build the binary yourself:

git clone https://github.com/egovelox/mozeidon.git ; cd mozeidon/cli && go build

📖 Complete CLI Reference Documentation

# get maximum 10 of latest bookmarks, title and url mozeidon bookmarks -m 10 --go-template '{{range .Items}}{{.Title}} {{.Url}}{{"\n"}}{{end}}'

# get opened tabs, with 📌 icon if pinned mozeidon tabs get --go-template '{{range .Items}}{{.WindowId}}:{{.Id}} {{.Url}} {{if .Pinned}}📌{{else}}🦊{{end}} {{"\\u001b[38;5;109m"}} {{.Domain}}{{"\\033[0m"}} {{.Title}}{{"\n"}}{{end}}'

If you've installed fzf you can use it as a kind of UI for mozeidon CLI.

The below bash command shows how fzf can be used to select a tab, and to open it in your browser.

mozeidon tabs get --go-template '{{range .Items}}{{.WindowId}}:{{.Id}} {{.Url}} {{if .Pinned}}📌{{else}}🦊{{end}} {{"\u001b[38;5;109m"}} {{.Domain}}{{"\033[0m"}} {{.Title}}{{"\n"}}{{end}}' \ | fzf --ansi --with-nth 3.. --bind=enter:accept-non-empty \ | cut -d ' ' -f1 \ | xargs -n1 -I % sh -c 'mozeidon tabs switch % && open -a firefox'

note : xargs -n1 prevents to run any command if no tab was chosen with fzf ( say, for example, that you exited fzf with ctrl-c )

note : mozeidon tabs switch is used to switch to the tab you chose in fzf

As an example, let's bind our mozeidon script with the tmux shortcut Prefix-t

# in $HOME/.tmux.conf bind t run-shell -b "bash $HOME/.tmux/mozeidon_tabs.sh"

Now create the script $HOME/.tmux/mozeidon_tabs.sh :

#!/bin/bash mozeidon tabs get --go-template \ '{{range .Items}}{{.WindowId}}:{{.Id}} {{.Url}} {{if .Pinned}}📌{{else}}🦊{{end}} {{"\u001b[38;5;109m"}} {{.Domain}}{{"\033[0m"}} {{.Title}}{{"\n"}}{{end}}' \ | fzf-tmux -p 60% -- \ --no-bold --layout=reverse --margin 0% --no-separator --no-info --black --color bg+:black,hl:reverse,hl+:reverse,gutter:black --ansi --with-nth 3.. --bind=enter:accept-non-empty \ | cut -d ' ' -f1 \ | xargs -n1 -I % sh -c '$HOME/bin/mozeidon tabs switch % && open -a firefox'

This more advanced script will allow to :

• open a new tab (empty or with search query)
• switch to a currently open tab
• close one or many tabs

#!/bin/bash $HOME/bin/mozeidon tabs get --go-template \ '{{range .Items}}{{.WindowId}}:{{.Id}} {{.Url}} {{if .Pinned}}📌{{else}}🦊{{end}} {{"\u001b[38;5;109m"}} {{.Domain}}{{"\033[0m"}} {{.Title}}{{"\n"}}{{end}}'\ | fzf-tmux -p 60% -- \ --border-label=TABS \ --no-bold \ --layout=reverse \ --margin 0% \ --no-separator \ --no-info \ --black \ --color bg+:black,hl:reverse,hl+:reverse,gutter:black \ --with-nth 3.. \ --bind="enter:accept+execute($HOME/bin/mozeidon tabs switch {1} && open -a firefox)" \ --multi \ --marker=❌ \ --bind="ctrl-p:accept-non-empty+execute($HOME/bin/mozeidon tabs close {+1})" \ --bind="ctrl-o:print-query" \ --header-first \ --color=header:#5e6b6b \ '--header=close tab(s) [C-p]  open new tab [C-o]'\ | grep -v "[🦊📌]" \ | xargs -r -I {} sh -c '$HOME/bin/mozeidon tabs new "{}" && open -a firefox'

Swell 🏄 🌊 is really fast and plenty of features.

For MacOS and Firefox users only : see the Mozeidon Raycast extension.

This Raycast extension will not work with Chrome browser. Better see Swell.

Note that you'll first need to complete the installation of Mozeidon components (Mozeidon firefox add-on, Mozeidon native-app and Mozeidon CLI).

Note that you cannot list history items with this Raycast extension : only tabs, recently-closed tabs, and bookmarks.

Not maintained anymore.

Please now switch to Swell 🏄 🌊 really fast and plenty of features.

Not maintained anymore.

If you ask for something faster than Raycast ( which I find quite slow to trigger the search list ),
you might take a look at this macOS app mozeidon-macos-ui

🆕 Quick install of the mozeidon-macos-ui brew cask

Various releases of the Mozeidon CLI can be found on the releases page.

Releases are managed with github-actions and goreleaser.

A release will be auto-published when a new git tag is pushed, e.g :

git clone https://github.com/egovelox/mozeidon.git && cd mozeidon; git tag -a v2.0.0 -m "A new mozeidon (CLI) release" git push origin v2.0.0

We'll assume that you installed and followed the steps described in the Mozeidon native-app paragraph above. In fact, you rarely need to modify this component, it's just a message broker (see the architecture paragraph above ).

First clone this repository.

Then, build the cli and the extensions locally :

make all

Now, before loading the local extension in your browser, don't forget to disable any running instance of the mozeidon extension.

Then, in Firefox ( or any web-browser ), via Extensions > Debug Addons > Load Temporary Add-on, select the manifest file in firefox-addon/manifest.json.
This will load the local extension.

From there, you may want to go further and build the CLI also :

You should now be able to execute the CLI using the local binary :

./cli/mozeidon tabs get

For users who installed both the firefox-addon AND the chrome-addon, or for those who use multiple browsers, each loading the mozeidon extension :

mozeidon CLI will not work properly when multiple instances of the mozeidon browser-extension are activated at the same time.
To overcome this limitation, keep one extension activated (e.g firefox-addon)
and deactivate the other extension (e.g chrome-addon).

If you notice any error during this operation, try to deactivate/reactivate the browser extension 🙏.

This is currently not planned for resolution. Technically, to overcome this limitation, we would need a particular native-messaging-host (mozeidon-native-app) for each web-browser.
The installation would surely be too complex for most users. (see architecture),

Mozeidon cannot guess in which browser window a given tab-id is located.
Consequently, if you have 2 browser windows,
mozeidon tabs switch [tab-id] will switch to the last active browser window,
where, possibly, the tab-id you targeted is not located.

This is by design, mozeidon was precisely meant to facilitate browsing within a unique browser window.

See #6

By design, the mozeidon cli can only move bookmarks ( e.g changing their folder location ) to places located under the Bookmarks Bar tree.

For mozeidon cli, there is no valid --folder-path for places located outside of the Bookmarks Bar tree.

The cli still allows get, update, delete operations for those bookmarks located outside of the Bookmarks Bar tree, but as for moving them, it can only move them inside the Bookmarks Bar tree.

This is by design : the cli uses a folder-path model, with the root, represented as /, being actually the Bookmarks Bar itself.

Each browser has a default bookmark folder, e.g Other Bookmarks in Firefox, Other Favorites in Edge, etc.
But internally, in the browser, this default bookmark folder IS NOT LOCATED INSIDE THE Bookmarks Bar tree ( though this folder may be displayed by the browser in the Bookmarks Bar ).

This default bookmark folder contravenes mozeidon design for bookmarks folder locations (--folder-path):
In mozeidon, a --folder-path value:

• is always a path starting from the root of the Bookmarks Bar tree ( aka Favorites Bar ) represented as /
• should always start with /
• should always end with /

E.g in mozeidon :

• --folderPath "//surf/" represents a surf folder, inside a "" (no title) folder, inside the Bookmarks Bar
• --folderPath "//Other Bookmarks/" represents a Other Bookmarks folder, inside a "" (no title) folder, inside the Bookmarks Bar ( and it should not be confused with Firefox's default bookmark folder )

Because internally, inside the browser, this default bookmark folder is not located in the Bookmarks Bar tree - though this folder may be displayed by the browser in the Bookmarks Bar, the --folder-path flag on the mozeidon bookmark commands cannot reference such default bookmark folder, meaning that :

• You can create a bookmark in the default bookmark folder with mozeidon bookmark new by omitting the --folder-path flag.
• Such created bookmark will appear in the results of mozeidon bookmarks with a parent field of "parent":"//Other Bookmarks/"
• You cannot move such bookmark in a child folder ( i.e inside the default bookmark folder ) with e.g (let's say our bookmark-id is 42) mozeidon bookmark update 42 --folder-path '//Other Bookmarks/surf/'
• Instead, that command will move the bookmark in a surf folder, inside a Other Bookmarks folder, inside a "" (no title) folder, inside the Bookmarks Bar
• But still, you can move such bookmark in a folder located inside the Bookmarks Bar, with e.g mozeidon bookmark update 42 --folder-path '/surf/'