env.telegram.example

# agent-chat Telegram-first environment template
#
# Usage:
#   cp env.telegram.example .env.telegram.local
#   edit .env.telegram.local
#   source .env.telegram.local

# Required for Telegram transport
export AGENT_CHAT_TRANSPORT="telegram"
export AGENT_TELEGRAM_BOT_TOKEN="<bot-token-from-botfather>"

# Optional but recommended for deterministic inbound routing.
# Leave empty to let setup-launchd bootstrap from inbound message.
# For topic-enabled groups, use the supergroup id (usually starts with -100).
# If Telegram returns migrate_to_chat_id, replace this value with that migrated id.
export AGENT_TELEGRAM_CHAT_ID=""

# Optional allowlist; include group chat id and/or owner user id.
# Example: export AGENT_TELEGRAM_CHAT_IDS="-1001234567890,123456789"
export AGENT_TELEGRAM_CHAT_IDS=""

# Optional forum-topic fallback for sessions not bound to a topic.
# Default behavior routes unbound sessions to topic id 1 (#general).
# Set to 0 to disable this fallback, or set a specific thread id.
export AGENT_TELEGRAM_GENERAL_TOPIC_THREAD_ID="1"

# Optional runtime defaults (override per session as needed)
export AGENT_CHAT_NOTIFY_MODE="route"
export AGENT_CHAT_HOME="$HOME/.codex"
export AGENT_CHAT_AGENT="codex"

# Claude runtime location (only needed when AGENT_CHAT_AGENT=claude)
export CLAUDE_HOME="$HOME/.claude"

# Telegram-only mode: keep iMessage destination unset
unset AGENT_IMESSAGE_TO