Skip to content
Hallway is out (npm i -g hallway): v0, v1 and v2 have shipped, apart from checking it all on a real Mac. See the roadmap.

Bookmarks and ignore files

v0 One file per bookmark group. The filename is the group’s slug.

title: Production
order: 10 # groups sort by order, then title
collapsed: false
links:
- title: Admin console
url: https://admin.example.com
description: Production admin
icon: auto # auto = fetch the favicon once and cache it; or an emoji / image / URL
tags: [prod]
- title: BI dashboards
url: https://bi.example.com
FieldMeaning
titleThe group’s heading.
orderSort key; groups sort by order, then title.
collapsedWhether the group starts collapsed. Saved here, so it is the same in every browser.
links[].titleThe chip’s label.
links[].urlWhere it goes. Required.
links[].descriptionShown as a tooltip.
links[].iconauto (the site’s favicon, fetched once and cached), an emoji, an image in the data home, or a URL. Without one, a monogram on a colour derived from the hostname.
links[].tagsFree-form tags, for filtering.

Bookmarks are inert: nothing is launched, and they are not health-checked. See Bookmarks.

v0 Observed listeners you never want to see. Ignore in the dashboard (or hallway ignore) appends to it; you can edit it by hand.

ports: [631] # never show these ports
processes: [rapportd, ControlCenter] # never show listeners owned by these process names
dirs: [] # never show listeners whose working directory is under these paths

This is on top of the scanner’s own filters (ports below 1024, the ephemeral range, and known non-web daemons). See the scanner.