channel-setup

Channel Setup

Activate a channel for local/tmux operation, adding the config.json entry first when there isn't one. This mirrors what docker-setup does for Docker users but targets the local environment.

Plan

1. Read config and detect channels

Docker check (first): read .claude-code-hermit/state/runtime.json if it exists.

• If runtime_mode == "docker": stop and redirect —

  This project is running in Docker. Channel token and pairing must happen inside the container, not on the host. Run /claude-code-hermit:docker-setup — it configures channels container-side. Stop.

• If runtime.json is missing AND .claude-code-hermit/docker/Dockerfile.hermit exists (Docker scaffolded but not yet booted): same redirect.
• Otherwise: proceed.

Read .claude-code-hermit/config.json. Collect all entries under channels that are valid objects, tracking which are disabled (enabled: false).

Adding an entry. Where a branch below says create the entry, run (<name> is the lowercase channel key — discord, telegram — never the capitalized option label):

echo '{"channels":{"<name>":{"enabled":true}}}' | bun ${CLAUDE_PLUGIN_ROOT}/scripts/hatch-config.ts "$(pwd)" --reinit >/dev/null

The script fills enabled, dm_channel_id: null, default_chat_id: null, and state_dir (.claude.local/channels/<name>), validates the whole config, preserves every other key, and merges onto an existing entry rather than replacing it. Discard stdout — it prints the full config. A non-zero exit means nothing was written: report the hatch-config: line it printed on stderr and stop — never fall through into steps 2–6 against a channel that isn't in config.json.

• If no channels configured: offer to add one — AskUserQuestion (header: "Channel") with options Discord, Telegram, Cancel. On Cancel, stop without writing. Otherwise create the entry and continue with that channel selected. Do not offer iMessage here: step 4 defines token vars for Discord and Telegram only.
• If entries exist but all are disabled: name them, then ask with AskUserQuestion (header: "Channel") — the disabled channel names plus Cancel — which to re-enable. On Cancel, stop without writing. Otherwise create the entry for the chosen name (this flips enabled and leaves dm_channel_id, default_chat_id, state_dir, and allowed_users intact) and continue with it selected.
• If exactly one enabled channel and nothing disabled: use it automatically.
• Otherwise (several enabled, or enabled and disabled side by side): ask with AskUserQuestion (header: "Channel") — every channel name as an option, disabled ones labelled <name> — disabled, plus All (enabled channels only) — which to set up. If a disabled name is chosen, create the entry for it first (re-enabling it), then continue with it selected.