add-emacs

Adds an Emacs channel to NanoClaw via a local HTTP bridge with org-mode integration.

2|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/RADHA0-max/selfhealbackend --skill add-emacs-radha0-max
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-emacs
Source: https://github.com/RADHA0-max/selfhealbackend/tree/main/nanoclaw/.claude/skills/add-emacs
Command: npx skills add https://github.com/RADHA0-max/selfhealbackend --skill add-emacs-radha0-max

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? NanoClaw does not ship channels in trunk, so developers who live in Emacs have no built-in way to chat with their assistant without switching to Telegram, Slack, or another external app. This Skill installs and wires an Emacs channel that runs over a local HTTP bridge, requiring no bot token or external service. ## Core Features & Use Cases - Interactive chat buffer: Open a chat buffer inside Doom, Spacemacs, or vanilla Emacs and talk to NanoClaw without leaving your editor. - Org-mode integration: Send the current org subtree or region with nanoclaw-org-send and receive the reply as a child heading inline in your notes. - Local HTTP bridge with optional auth: The adapter uses only Node builtins and can be locked with a bearer token; one host maps to one messaging group. - Use Case: While reviewing code, select a function region, send it via nanoclaw-org-send, and get a code review back as a child heading directly in your org file. ## Quick Start Ask the assistant to add the Emacs channel to NanoClaw, then follow the prompts to pick your Emacs distribution and verify the chat buffer responds.

Frequently Asked Questions about add-emacs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add an Emacs channel to NanoClaw?

Fetch the channels branch, copy src/channels/emacs.ts and emacs/nanoclaw.el into your checkout, add the self-registration import to src/channels/index.ts, then build and run the registration test. Set EMACS_ENABLED=true in .env and restart the service.

How do I send org-mode content to an AI assistant from Emacs?

Load nanoclaw.el and invoke nanoclaw-org-send on a heading or region. The current subtree or region is sent over the local HTTP bridge, and the assistant's reply is inserted as a child heading in your org file.

Does the Emacs channel work with Doom Emacs and Spacemacs?

Yes, nanoclaw.el works with Doom Emacs, Spacemacs, and vanilla Emacs 27.1 or later. It uses only built-in libraries (url, json, org), so no package manager is needed; only the keybinding configuration differs per distribution.

Does the NanoClaw Emacs bridge require a bot token or external service?

No, the channel runs as a local HTTP bridge on port 8766 with no external service. You can optionally set EMACS_AUTH_TOKEN to a random string to prevent other local processes from accessing the endpoint.

Why is the Emacs channel not starting in NanoClaw?

Check that EMACS_ENABLED=true is present in .env and that src/channels/index.ts contains the import './emacs.js' line. The log should show 'Emacs channel listening' at startup; also verify port 8766 is not already in use by another process.

What are the limitations of the Emacs channel?

The channel is single-user and single-chat: one host maps to one messaging group addressed by a platform id. It does not support threads, multi-user channels, typing indicators, attachments, or cold DM initiation.