Nat nazt

Approving Claude Code from Discord — how MCP notifications relay tool permissions

When Claude Code wants to run a tool, it doesn't always have permission. If you're not at the terminal, who tells it yes or no? The answer: a JSON-RPC notification, an MCP plugin, and a Discord button. Here's the full path with every line of public code.

The setup

I run Claude Code in a tmux session on my laptop. Sometimes I'm not in front of the laptop — I'm out, on my phone, mid-meeting, anywhere. But Claude is mid-task and just hit a tool that needs my approval (Edit, Bash, anything not pre-allowlisted). What now?

`maw wake <bot>` — One Command to Run an Autonomous Discord/Telegram Claude Bot

A small CLI design pattern that turns a 4-part wake invocation into a single word. Built into maw-js (the multi-Claude-instance manager) on 2026-05-04 across three commits.

The problem

A Claude Code instance acting as a Discord bot is not the same as Claude Code in your terminal. To run autonomously it needs:

Flag / env	Why

`maw search` — The Hidden Gem of the Oracle CLI

"oh maw search is the gold!" — Nat, 2026-05-05

maw search <keyword> is the single-query meta-command that searches the entire oracle universe at once. Most maw users don't realize it exists. They should.

What it actually does

One query, four sources, ranked output:

🕰️ Discord Channel Config Archaeology — /time-travel --prove (v2)

"Timestamp is the truth" — Nat, 2026-05-04 Proved by Timekeeper Oracle from 148 jsonl evidence points v2: tokens redacted, pass keychain instructions added

Token Map (redacted — retrieve from keychain)

🕰️ Discord Channel Config Archaeology — /time-travel --prove

"Timestamp is the truth" — Nat, 2026-05-04 Proved by Timekeeper Oracle from 148 jsonl evidence points

Executive Summary

discord-oracle created ALL channel configs in a 12-hour marathon (May 3 18:35 → May 4 11:50 ICT). But token sharing, naming chaos, orphan dirs, and a split-brain hermes config made the system "shitty."

Hardware Buddy BLE Protocol

This is the wire protocol the Claude desktop apps speak over Bluetooth LE. You don't need anything from this repository to implement it. Any device that can advertise the Nordic UART Service and parse newline-delimited JSON will work: Arduino, ESP32, nRF52, a Raspberry Pi with a BLE dongle.

Enabling the bridge

The BLE bridge is off by default. In Claude for macOS or Windows:

name

cross-machine-code-find

description

Find code/files on another machine via SSH and relay findings to a target oracle's inbox + maw notification. Use when user asks to find a project that lives on a different host (e.g., "find X on white.local", "ssh to <host> and dig <topic>", "bring code from <other-machine> to <oracle>"). Trigger phrases — "ssh to <host>", "find on <machine>", "code on white", "bring from <host>", "white.local find", "remote dig".

/cross-machine-code-find — Cross-Machine Code Discovery + Relay

Find code on another machine via SSH, then relay findings to a target oracle's inbox + ping their maw session.

When to Use

Discord Bot — Tag-Only vs Free-for-All Toggle

How to switch a Claude-Code Discord bot between "respond to all messages" and "respond only when @mentioned" — per channel, instantly, no restart.

The Setting

In ~/.claude/channels/<bot-name>/access.json, each channel entry has requireMention:

Discord Bot Multi-Channel Access Recipe

How to configure a Claude-Code Discord bot to operate across multiple channels and servers via access.json.

The Pain (without this recipe)

Every new Discord channel = manual update of every bot's access.json. With N bots × M channels growing fast, this becomes unsustainable.

	substitutions:
	device_internal_name: fireman-display
	device_friendly_name: FireMan Display

	esphome:
	name: ${device_internal_name}
	friendly_name: ${device_friendly_name}
	on_boot:
	priority: -100
	then: