anchor

README

---

Anchor is a simple CLI tool for storing bookmarks neatly organized in a flattened label hierarchy. It features a custom and intuitive TUI via bubbletea and automatic syncing with git via go-git as a backing storage.

Installation

Download one of the pre-built binaries and make it available for the shell you are using. Make sure to grab the right one for the operating system/architecture you intend to use it on.

Build from source

Prerequisites to build anchor from source:

• Go 1.21 or later

Build and place it under $GOBIN:

 go install github.com/loghinalexandru/anchor@latest

Storage

For now by default it uses the local file system as storage. You can specify what kind of backing storage you want via a config file explained in the next section.

Valid options:

• local
• git via ssh auth

Usage

In order to use anchor you first need to create a home for all your bookmarks. Before any operation you need to initialize the storage. For this run:

anchor init

In order to switch to git or any other storage, create a file under ~/.anchor/config/anchor.yaml with the following config:

storage: git

For this to work you need to have a repository already created and a ssh key already setup. The authentication is done via the ssh-agent as mentioned in the go-git documentation.

This is a one-time-only configuration since the file will be persisted on the preffered backing storage.