nictui-radio-cli-plugin

NicTUI - Professional TDH3 Radio Programmer

A terminal-based user interface for programming the TIDRADIO TD-H3 HAM radio.

Features

• Channel Management - Read, edit, and write channels to the radio
• Settings Configuration - Modify radio settings via the UI
• Band Plan Editor - Edit frequency band plans
• DTMF Presets - Manage DTMF signaling presets
• Scan Presets - Configure scanning behavior
• Codeplug Operations - Import/export full codeplugs
• Firmware Flashing - Flash firmware updates
• Remote Control - Control the radio remotely via USB serial
• AI Skill Installer - Install a bundled Codex or Claude Code skill that drives the NicTUI CLI

Installation

Quick Install (All Platforms)

One-command installation that automatically detects your platform and installs NicTUI:

curl -fsSL https://raw.githubusercontent.com/RCGV1/NicTUI/master/install.sh | bash

This will:

• Detect your operating system and architecture
• Download the latest release binary
• Install to ~/.local/bin/nictui
• Add ~/.local/bin to your PATH

After installation, restart your terminal or run:

source ~/.bashrc  # or ~/.zshrc, ~/.profile, etc.

Then start the interactive UI with:

nictui

Manual Installation

Linux/macOS

# Download the binary
curl -LO https://github.com/RCGV1/NicTUI/releases/latest/download/nictui-{version}-{platform}

# Example for Linux x86_64:
# curl -LO https://github.com/RCGV1/NicTUI/releases/latest/download/nictui-1.0.0-linux-x86_64

# Make executable
chmod +x nictui-{version}-{platform}

# Move to a directory in your PATH
mkdir -p ~/.local/bin
mv nictui-{version}-{platform} ~/.local/bin/nictui

# Add to PATH (add to ~/.bashrc or ~/.zshrc)
export PATH="$HOME/.local/bin:$PATH"

Windows

Download the .exe file from Releases and run it from Command Prompt or PowerShell.

Update NicTUI

To update to the latest version:

# Re-run the install script
curl -fsSL https://raw.githubusercontent.com/RCGV1/NicTUI/master/install.sh | bash

# Or manually download the new version and replace the binary

Check Version

nictui --version

Uninstall

rm -f ~/.local/bin/nictui

Usage

Running nictui with no arguments launches the full-screen TUI.

1. Connect your TD-H3 radio to the computer via USB
2. Select the appropriate serial port
3. Use the arrow keys to navigate between tabs
4. Press the indicated keys to perform actions

When you exit the TUI, NicTUI will print a hint about the bundled AI skill if it detects codex or claude on your system.

AI Skill

NicTUI ships with a bundled skill for Codex and Claude Code. The skill uses the NicTUI CLI only, requires NicSure mod firmware on the radio, backs up the radio data it changes, prefers targeted updates over bulk writes, and runs --validate-only before real writes.

Install into detected agent directories:

nictui skill install

Inspect the bundled skill and install paths:

nictui skill show
nictui skill paths

Force a specific target:

nictui skill install --agent codex
nictui skill install --agent claude
nictui skill install --agent all

Installed locations:

• Codex: $CODEX_HOME/skills/nictui-radio-cli or ~/.codex/skills/nictui-radio-cli
• Claude Code: ~/.claude/skills/nictui-radio-cli

Publishing and Discovery

This repo also includes a Claude Code marketplace definition at .claude-plugin/marketplace.json and a plugin package at plugins/nictui-radio-cli-plugin. That gives Claude Code users a directory-style install path through the official plugin marketplace flow.

For local validation and install testing:

claude plugin validate .
claude plugin marketplace add ./ --scope user
claude plugin install nictui-radio-cli-plugin@nictui-marketplace

For Codex, the bundled skill lives at skills/nictui-radio-cli. Codex does not currently expose a first-party skill marketplace in this repo, so the practical distribution path is to host the skill in a public GitHub repository and submit it to a community registry that indexes GitHub-hosted Codex skills.

CLI