relay-setup

Configures tokenmon remote sound relay for SSH and Docker environments.

24|6|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/ThunderConch/tkm --skill relay-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: relay-setup
Source: https://github.com/ThunderConch/tkm/tree/main/skills/relay-setup
Command: npx skills add https://github.com/ThunderConch/tkm --skill relay-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Remote tokenmon sessions often can’t play sounds because there is no audio output in SSH/Docker environments, so you need a way to route tokenmon audio back to your local machine.

Core Features & Use Cases

  • Detects your runtime environment (SSH, Docker, or local WSL) and selects an appropriate relay strategy.
  • Reads and updates the current tokenmon config (relay_audio, relay_host, relay_sound_root, peon ping port) without forcing manual edits.
  • Guides you through a safe setup flow that can enable, change, disable, and verify relay connectivity, including an optional sound test for confirmation.

Quick Start

Run the relay setup wizard and follow the prompts to enable or disable remote sound relay for your current environment.

Frequently Asked Questions about relay-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enable remote audio playback for tokenmon in an SSH session?

To enable remote audio playback for tokenmon in an SSH session, you route the audio through a peon-ping relay on a reachable host. The setup wizard detects your environment and updates the tokenmon config with the correct relay_host and relay_sound_root.

Can I get audible feedback from tokenmon running inside a Docker container?

You can get audible feedback from tokenmon running inside a Docker container by configuring a remote sound relay. The setup process detects the Docker environment and updates relay_audio settings to route playback to a reachable host outside the container.

What is the best way to configure tokenmon remote sound relay settings?

The best way to configure tokenmon remote sound relay settings is to use a dedicated setup wizard that reads your current config and safely updates relay_audio, relay_host, and relay_sound_root without forcing manual edits, followed by a reachability verification.

Does configuring a remote sound relay require manual tokenmon config file edits?

Configuring a remote sound relay does not require manual tokenmon config file edits. The setup wizard reads your current configuration and automatically updates the relay_audio, relay_host, relay_sound_root, and peon ping port values based on your detected environment.

How do I verify tokenmon relay connectivity after updating the audio configuration?

You verify tokenmon relay connectivity after updating the audio configuration by checking the peon-ping health endpoint. The setup wizard performs this verification automatically and offers an optional sound test to confirm audible feedback is working.

Why does tokenmon audio fail to play in my local WSL environment?

Tokenmon audio fails to play in local WSL or other non-audio environments because there is no direct audio output device available. You must route the playback via a peon-ping relay on a reachable host and configure the relay_sound_root path.