add-emacs

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

1|Updated May 22, 2026
One-click install
npx skills add https://github.com/roseDwayane/LocalizeAgenticSys --skill add-emacs-rosedwayane
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-emacs
Source: https://github.com/roseDwayane/LocalizeAgenticSys/tree/main/nanoclaw/.claude/skills/add-emacs
Command: npx skills add https://github.com/roseDwayane/LocalizeAgenticSys --skill add-emacs-rosedwayane

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? NanoClaw does not ship messaging channels in trunk, so developers who live in Emacs have no built-in way to chat with their agent without switching to Telegram, Discord, or another external app. This Skill installs and wires an Emacs channel so you can talk to your NanoClaw agent directly from a chat buffer or org-mode file. ## Core Features & Use Cases - Interactive chat buffer: Open a chat buffer with a keybinding (SPC N c, SPC a N c, or C-c n c) and converse with the agent without leaving Emacs. - Org-mode integration: Send the current org subtree or region with nanoclaw-org-send; the agent's reply lands as a child heading inline in your notes. - Local HTTP bridge: The adapter uses only Node's built-in http module on localhost (default port 8766) with optional bearer-token auth — no bot token, Chat SDK, or external service required. - Use Case: While reviewing code in Doom Emacs, select a confusing function, send it with nanoclaw-org-send, and receive the agent's explanation as a child heading directly in your org file. ## Quick Start Ask the agent to add the Emacs channel to NanoClaw, then follow the prompts to pick your Emacs distribution (Doom, Spacemacs, or vanilla) 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 set EMACS_ENABLED=true in .env and restart the service. The skill walks through each idempotent step.

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

Load nanoclaw.el and bind nanoclaw-org-send to a key such as C-c n o. Position the cursor on an org heading or select a region, invoke the command, and the agent's reply is inserted as a child heading in the same file.

Does the Emacs channel work with Doom Emacs and Spacemacs?

Yes, the skill provides configuration snippets for Doom Emacs (map! in config.el), Spacemacs (dotspacemacs/user-config), and vanilla Emacs 27.1+ (init.el with global-set-key). nanoclaw.el uses only built-in url, json, and org libraries, so no package manager is needed.

Does the NanoClaw Emacs integration require an external service or bot token?

No, it runs a local HTTP bridge on localhost port 8766 using only Node's built-in http module. You can optionally set EMACS_AUTH_TOKEN as a bearer token to prevent other local processes from accessing the endpoint.

Why is the Emacs channel not starting in NanoClaw?

Check that EMACS_ENABLED=true exists in .env and that src/channels/index.ts contains the import './emacs.js' line. Then grep logs/nanoclaw.log for 'Emacs channel listening'; a missing line means the adapter never registered.

What are the limitations of the Emacs channel?

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