Kurahi channels

Manage chat channel accounts and their runtime status on the Gateway.

Related docs:

• Channel guides: Channels
• Gateway configuration: Configuration

Common commands

kurahi channels list
kurahi channels status
kurahi channels capabilities
kurahi channels capabilities --channel discord --target channel:123
kurahi channels resolve --channel slack "#general" "@jane"
kurahi channels logs --channel all

Add / remove accounts

kurahi channels add --channel telegram --token <bot-token>
kurahi channels remove --channel telegram --delete

Tip: kurahi channels add --help shows per-channel flags (token, app token, signal-cli paths, etc).

Login / logout (interactive)

kurahi channels login --channel whatsapp
kurahi channels logout --channel whatsapp

Troubleshooting

• Run kurahi status --deep for a broad probe.
• Use kurahi doctor for guided fixes.
• kurahi channels list prints Claude: HTTP 403 ... user:profile → usage snapshot needs the user:profile scope. Use --no-usage, or provide a claude.ai session key (CLAUDE_WEB_SESSION_KEY / CLAUDE_WEB_COOKIE), or re-auth via Claude Code CLI.

Capabilities probe

Fetch provider capability hints (intents/scopes where available) plus static feature support:

kurahi channels capabilities
kurahi channels capabilities --channel discord --target channel:123

Notes:

• --channel is optional; omit it to list every channel (including extensions).
• --target accepts channel:<id> or a raw numeric channel id and only applies to Discord.
• Probes are provider-specific: Discord intents + optional channel permissions; Slack bot + user scopes; Telegram bot flags + webhook; Signal daemon version; MS Teams app token + Graph roles/scopes (annotated where known). Channels without probes report Probe: unavailable.

Resolve names to IDs

Resolve channel/user names to IDs using the provider directory:

kurahi channels resolve --channel slack "#general" "@jane"
kurahi channels resolve --channel discord "My Server/#support" "@someone"
kurahi channels resolve --channel matrix "Project Room"

Notes:

• Use --kind user|group|auto to force the target type.
• Resolution prefers active matches when multiple entries share the same name.

Delivery status (M14)

kurahi channels status ends with a Delivery section when any channel has sent something since the gateway started:

Delivery:
- line: queued 0, sent 12, retried 1, dead-letter 0, duplicates 0, last 2m
- dead letters slack: 1 in /home/alice/.kolo/channels/dead-letter/slack.jsonl

The same data is available as kurahi api getChannelsDeliveryStatus. See Channel residents for the queue semantics.