terminal-agent-visual-signals: Skill for Claude Code

TAVS Setup & Configuration Assistant

Conversational configuration for Terminal Agent Visual Signals. Handles initial setup, ongoing config changes, and named profile management — all with backup, preview, and verification.

When to Use

• Setup: First-time configuration, re-setup, "tavs wizard", "tavs setup"
• Config: Modify a setting, change theme, adjust colors, "tavs config"
• Profiles: Save/load/apply named config sets, "tavs profile"
• Agent settings: Per-agent color, face, or title format overrides

Prerequisites

Verify the TAVS CLI is available:

./tavs version 2>/dev/null || echo "TAVS CLI not found"

If unavailable, the tavs CLI is part of TAVS v3.0.0+.

Intent Detection

Determine which workflow to use based on the user's request:

Keywords	Workflow
"set up", "configure from scratch", "wizard", "first time", "install"	A: Setup Wizard
"change", "modify", "set", "switch", "update", "enable", "disable"	B: Config Change
"profile", "save config", "load config", "apply profile", "list profiles"	C: Profile Management

When unclear, ask the user:

• Run the setup wizard — Full guided configuration
• Change a specific setting — Quick, targeted modification
• Manage profiles — Save or load a named configuration

---

Workflow A: Setup Wizard

Guided multi-step configuration. Best for first-time users or full reconfiguration.

Phase 1: Environment Detection (Automatic)

Run silently to detect the user's environment:

./tavs status 2>/dev/null
echo "TERM_PROGRAM=${TERM_PROGRAM:-unset}"
echo "GHOSTTY_RESOURCES_DIR=${GHOSTTY_RESOURCES_DIR:-unset}"
echo "ITERM_SESSION_ID=${ITERM_SESSION_ID:-unset}"
echo "KITTY_PID=${KITTY_PID:-unset}"
echo "COLORTERM=${COLORTERM:-unset}"
echo "TERM=${TERM:-unset}"
echo "TAVS_AGENT=${TAVS_AGENT:-claude}"
defaults read -g AppleInterfaceStyle 2>/dev/null || echo "light"

Present: "I detected [Terminal] in [dark/light] mode running [Agent]." Mention terminal-specific notes from references/terminal-guide.md.