configure-notifications

Configure Notifications

Set up OMC notification integrations so you're alerted when sessions end, need input, or complete background tasks.

Routing

Detect which provider the user wants based on their request or argument:

• If the trigger or argument contains "telegram" → follow the Telegram section
• If the trigger or argument contains "discord" → follow the Discord section
• If the trigger or argument contains "slack" → follow the Slack section
• If no provider is specified, use AskUserQuestion:

Question: "Which notification service would you like to configure?"

Options:

1. Telegram - Bot token + chat ID. Works on mobile and desktop.
2. Discord - Webhook or bot token + channel ID.
3. Slack - Incoming webhook URL.

---

Shared Config Commands

Every provider section reads and writes the same ${COPILOT_CONFIG_DIR:-~/.copilot}/.omc-config.json. These two commands are the only ones you need for that, and both run unchanged in bash, zsh, and PowerShell — no jq, no shell-specific redirection.

READ_NOTIFICATIONS — print the current notifications object, or NO_CONFIG_FILE:

node -e "const p=require('path'),f=require('fs'),d=process.env.COPILOT_CONFIG_DIR||p.join(require('os').homedir(),'.copilot'),t=p.join(d,'.omc-config.json');if(f.existsSync(t)===false){console.log('NO_CONFIG_FILE');process.exit(0)}let c={};try{c=JSON.parse(f.readFileSync(t,'utf8'))}catch{console.log('INVALID_CONFIG_FILE');process.exit(0)}console.log(JSON.stringify(c.notifications||{},null,2))"

MERGE_CONFIG — deep-merge one JSON patch into the config. It writes through a temp file, so a failure can never truncate the user's existing settings, and it refuses to touch a config it cannot parse:

node -e "const p=require('path'),f=require('fs'),d=process.env.COPILOT_CONFIG_DIR||p.join(require('os').homedir(),'.copilot'),t=p.join(d,'.omc-config.json');const patch=JSON.parse(process.argv[1]);f.mkdirSync(p.dirname(t),{recursive:true});let c={};if(f.existsSync(t)){try{c=JSON.parse(f.readFileSync(t,'utf8'))}catch{console.error('ERROR: existing config is not valid JSON; it was not modified');process.exit(1)}}const merge=(a,b)=>{for(const k of Object.keys(b)){const v=b[k];if(v&&typeof v==='object'&&Array.isArray(v)===false){a[k]=merge(a[k]&&typeof a[k]==='object'?a[k]:{},v)}else{a[k]=v}}return a};merge(c,patch);const tmp=t+'.tmp';f.writeFileSync(tmp,JSON.stringify(c,null,2));f.renameSync(tmp,t);console.log('Updated '+t)" "{\"notifications\":{\"enabled\":true}}"