Rules-based browser launcher for TUI + GNOME.
switchyard.aly.codes
tui
gome
bowser
go
website: add tui documentation and update using page
Aly Raffauf
(Jul 6, 2026, 4:23 PM EDT)
f5ce1a31
6353bdc6
+32
-2
website/src/assets/screenshots/swtui.png
website/src/assets/screenshots/swtui.png
This is a binary file and will not be displayed.
+30
website/src/content/docs/tui.md
+30
website/src/content/docs/tui.md
···
1
+
---
2
+
title: Terminal User Interface
3
+
description: Guide to the experimental terminal user interface for Switchyard.
4
+
---
5
+
6
+
Switchyard has an experimental terminal user interface (TUI) available on both Linux and macOS. It works more or less as the Adwaita GUI does, but from your terminal, with the limtiations that entails.
7
+
8
+
9
+
10
+
The TUI was built for internal testing and porting to macOS, but is feature-complete and uses the same backend that the GUI does. You can use it to launch links, including `switchyard://` URLs, from your terminal or from a scripting language of your choice.
11
+
12
+
## Usage
13
+
14
+
Clone the [repo](https://github.com/alyraffauf/switchyard), then build the TUI binary from the `cmd/sw` directory:
15
+
16
+
```bash
17
+
go run ./cmd/sw
18
+
```
19
+
20
+
Or, just use Nix:
21
+
22
+
```bash
23
+
nix run .#sw
24
+
```
25
+
26
+
You may pass your URL as a command line argument:
27
+
28
+
```bash
29
+
sw https://switchyard.aly.codes
30
+
```
+2
-2
website/src/content/docs/using.md
+2
-2
website/src/content/docs/using.md
···
4
4
order: 10
5
5
---
6
6
7
-
Switchyard is a rules-based browser launcher for Linux. Once it is set as your default browser, clicked links pass through Switchyard first. It can then open the link in a specific browser, ask you which browser to use, or rewrite the URL before opening it.
7
+
Switchyard is a powerful, rules-based browser launcher. Once it is set as your default browser, clicked links pass through Switchyard first. It can then open the link in a specific browser, ask you which browser to use, or rewrite the URL before opening it.
8
8
9
-
Use it when different parts of your life belong in different browsers: work links in Chrome, personal links in Firefox, video links in Brave, or privacy-friendly redirects before anything opens.
9
+
Use it when different parts of your life live in different browsers: work links in Chrome, personal links in Firefox, video links in Brave, or to add privacy-friendly redirects before anything opens.
10
10
11
11
The basic flow is:
12
12