PATCH

Peripheral Access Terminal for Connected Hardware

Quick Start

# Install Go dependencies
make deps

# First time on macOS only — installs the haraltd Bluetooth daemon
make setup

# Build and run (handles haraltd automatically on macOS)
make run

Platform Requirements

Platform	Requirement
Linux	BlueZ (sudo apt install bluez / sudo pacman -S bluez)
macOS	haraltd daemon (installed via make setup, requires gh CLI)

Note: BLE peripherals (keyboards, mice, etc.) are discovered natively via CoreBluetooth on macOS and require no extra setup. The haraltd daemon is only needed for Classic Bluetooth devices (speakers, headphones, etc.).

Make Commands

Command	Description
make build	Compile the binary
make run	Build and run (handles haraltd automatically on macOS)
make deps	Install Go dependencies
make clean	Remove build artifacts
make setup	Install haraltd daemon (macOS only, required once)
make start-haraltd	Start the haraltd daemon (macOS)
make stop-haraltd	Stop the haraltd daemon (macOS)
make help	Show all available commands

Keybindings

Tab Bar (default)

Key	Action
Tab / Right / l	Next tab
Shift+Tab / Left / h	Previous tab
1, 2	Jump to tab by number
Enter	Focus into the selected tab
q / Ctrl+C	Quit

Bluetooth Tab (when focused)

Key	Action
Up / k	Move cursor up
Down / j	Move cursor down
Enter	Connect/disconnect selected device
p	Toggle Bluetooth power
Esc	Return to tab bar