channel-setup

Configure and activate a Claude Code channel for local tmux deployment.

69|12|Updated Mar 23, 2026
One-click install
npx skills add https://github.com/gtapps/claude-code-hermit --skill channel-setup-gtapps
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: channel-setup
Source: https://github.com/gtapps/claude-code-hermit/tree/main/plugins/claude-code-hermit/skills/channel-setup
Command: npx skills add https://github.com/gtapps/claude-code-hermit --skill channel-setup-gtapps

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Guides users through activating and configuring a Claude Code channel for local/tmux operation, including plugin installation, token setup, and pairing.

Core Features & Use Cases

  • Install and configure the channel plugin for local environments.
  • Manage bot tokens in a project-local state directory and guide pairing flow.
  • Handle channel discovery, prerequisites checks, restart prompts, and pairing status.

Quick Start

Run the hatch flow to activate a configured channel and follow the on-screen prompts to install the plugin, configure your bot token, and pair your channel.

Frequently Asked Questions about channel-setup

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

FAQPage Schema
How do I activate and pair a local Claude channel for tmux workflows?

You can activate a local Claude channel by running the hatch flow, which guides you through plugin installation, bot token setup, and channel pairing for your terminal or tmux environment.

What is the claude-code-hermit plugin used for in local terminal deployments?

The claude-code-hermit plugin is used for local Claude Code channel deployment, covering plugin installation, token management, restart prompts, and pairing status verification in terminal environments.

Do I need a bot token to configure a local Claude Code channel?

Yes, configuring a bot token is required. The setup flow guides you through managing the bot token in a project-local state directory and verifying access.json to ensure proper channel pairing.

How does channel discovery and access verification work for local Claude deployments?

Channel discovery runs prerequisites checks and plugin installation, then verifies access.json to confirm bot token configuration and pairing status for local Claude Code channel access.

Why is my local Claude channel not pairing after plugin installation?

If channel pairing fails after plugin installation, verify that the bot token is correctly configured in the project-local state directory and that access.json validation passes during the restart prompt.

Can I use channel-setup for projects without a tmux or terminal workflow?

Channel-setup is designed for projects using the claude-code-hermit plugin with local tmux or terminal workflows, making it best suited for those specific local deployment environments.