Exhub

Exhub is an Elixir-powered enhancement plugin for Emacs, based on WebSocket communication. It facilitates real-time interaction and communication between Emacs and the Elixir server.

Features

WebSocket Communication: Establishes a bi-directional connection between Emacs and Elixir using WebSockets.
Message Handling: Enables sending and receiving messages between Emacs and the Elixir server.
Erlang/Elixir Backend: Leverages Elixir and Erlang for robust backend processing.
Emacs Integration: Provides Emacs Lisp functions to interact seamlessly with the Elixir server.
Agent Integration: Allows integration with agents for enhanced functionality.
MCP Tools Integration: Provides integration with MCP Tools for extended functionality.
Mac Keep Alive: Maintains Bluetooth connections on macOS using scheduled health checks.
Health Check: Monitors target URLs with scheduled checks and sends webhook notifications (supports Feishu/Lark and generic webhooks).
Habit Management: MCP-based user habit and environment configuration storage with protected keys and persistent storage.
Think/Plan Tools: MCP-based reasoning scratchpad tools (think and plan) for LLM chain-of-thought and step planning without side effects.
Archery SQL Audit: MCP-based integration with the Archery SQL audit platform, exposing tools for querying instances, databases, executing read-only SQL, and retrieving query history and resource groups.
Time Tools: MCP-based timezone-aware time utilities for getting current time and converting between timezones.
Code Completion: LLM-powered code completion with dual modes: specialized prompts and various enhancements for chat-based LLMs on code completion tasks, and fill-in-the-middle (FIM) completion for compatible models.
Advanced Configuration Management: Enhanced LLM configuration server with validation, error handling, and type specifications.
Browser Automation: MCP-based Chrome browser automation via kuri-agent (CDP), exposing tools for navigation, element interaction, screenshots, security audits, JWT scanning, and IDOR probing.
Image Generation: MCP-based AI image generation from text descriptions using Gitee AI, supporting Qwen-Image, Kolors, GLM-Image, FLUX.2-dev, and HunyuanDiT models.
Todo Management: MCP-based multi-tenant todo list management with set_items, get_items, update_item_completion, and clear_items tools; backed by an in-memory ETS store with automatic 2-hour TTL expiry.
Desktop Commander: MCP-based local filesystem and process management — read/write/edit/search files, list directories, execute commands, and manage long-running background processes. Supports document extraction (PDF, DOCX, images) via Gitee AI PaddleOCR. Exposes 17 tools at /desktop/mcp, including read_multiple_files for parallel file reading.
Document Extraction: MCP-based document text extraction (PDF, DOCX, images, etc.) via Gitee AI PaddleOCR-VL-1.5, supporting both local files and remote URLs. Returns extracted content in Markdown format at /doc-extract/mcp.
ACP Agent MCP Server: MCP-based bridge to ACP (Agent Communication Protocol) agents like Claude Code, Gemini CLI, OpenCode, and Codex. Spawn, manage, and interact with AI coding agents via MCP tools at /agent/mcp. Supports session management, prompts, permission handling, and multi-agent pipelines.
Vault (Org-mode Password Book): Emacs org-mode password vault integrated with Exhub. Encrypts secrets with AES-256-GCM on the backend and stores them as org links ([[exhub-vault:CIPHERTEXT][description]]). Supports quick insert (C-c v i), decrypt & copy (C-c v c / C-c C-o), and decrypt & show (C-c v s). Reuses the existing SECRET_VAULT_PASSWORD — no additional configuration needed.
Brain (Obsidian Vault): MCP-based interface to an Obsidian vault as a "second brain". Exposes tools for listing notes and directories (recursive, flat, absolute paths) and searching by content, filename, or tags (including hierarchical tag search) at /brain/mcp.

Installation

Elixir Server

Clone the Repository:

git clone https://github.com/edmondfrank/exhub.git
cd exhub

Install Dependencies:

mix deps.get

Note: For Mac Keep Alive feature, ensure blueutil is installed:

brew install blueutil

Note: For Browser Automation (browser_* MCP tools), kuri-agent must be installed and available on your PATH, and Chrome must be running with remote debugging enabled. See docs/modules/browser-use.md for full setup instructions.

Quick setup for browser automation:

# 1. Build kuri-agent (requires Zig)
git clone https://github.com/justrach/kuri && cd kuri
zig build agent -Doptimize=ReleaseFast
cp ./zig-out/bin/kuri-agent /usr/local/bin/kuri-agent

# 2. Launch Chrome with remote debugging
# macOS:
/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome \
  --remote-debugging-port=9222 --user-data-dir=/tmp/chrome-debug

# 3. Verify
which kuri-agent && curl -s http://localhost:9222/json/version | head -1

Configuration:

Secrets (API keys, cookies, etc.) are managed via SecretVault and loaded at runtime from encrypted vault files. No secrets are hardcoded in config/config.exs.

SecretVault Setup

a. Set the master password:

export SECRET_VAULT_PASSWORD="your-secure-master-password"

b. Create secrets using the provided setup script (recommended):

chmod +x scripts/setup_secrets.sh
./scripts/setup_secrets.sh

Or insert secrets individually with mix scr.insert:

mix scr.insert dev gitee_api_key        "your-gitee-ai-api-key"
mix scr.insert dev openai_api_key       "your-openai-api-key"
mix scr.insert dev gitee_cookie         "your-gitee-cookie-string"
mix scr.insert dev siliconflow_api_key  "your-siliconflow-key"
mix scr.insert dev mistral_api_key      "your-mistral-key"
mix scr.insert dev codestral_api_key    "your-codestral-key"
mix scr.insert dev anthropic_api_key    "your-anthropic-key"
mix scr.insert dev groq_api_key         "your-groq-key"
mix scr.insert dev gemini_api_key       "your-gemini-key"
mix scr.insert dev cohere_api_key       "your-cohere-key"
mix scr.insert dev samba_api_key        "your-samba-key"

All LLM configurations and the Gitee Cat cookie are automatically assembled from these secrets at runtime via config/runtime.exs. Secrets are encrypted at rest using AES-256-GCM — only the encrypted .vault_secret files are committed to Git.

📖 See docs/SECRETS.md for full documentation on creating, editing, listing, and auditing secrets. 🔄 Migrating from a previous hardcoded config? See docs/MIGRATION.md.

Customizing API Base URLs

The default API base URLs for LLM providers are configured in config/runtime.exs. If you need to change the API endpoint for a specific provider (e.g., to use a proxy or different region), you can modify config/runtime.exs:

# Example: Change the API base for a specific model
"openai/Qwen2.5-72B-Instruct" => %{
  api_base: "https://your-custom-endpoint.com/v1",  # Change this
  api_key: giteeai_api_key,
  model: "openai/Qwen2.5-72B-Instruct"
}

The api_base field can be customized per model while still using SecretVault-managed API keys.

Other Optional Configuration

The following optional settings can be placed in config/config.exs:

# Mac Keep Alive Configuration (optional)
config :exhub, Exhub.MacKeepAlive,
  device_name: "Your Device Name",  # Must be a paired Bluetooth device
  jobs: [
    {"*/5 * * * *", {Exhub.MacKeepAlive, :run_keep_alive_check, []}}
  ]

# Health Check Configuration (optional)
config :exhub, Exhub.HealthCheck,
  targets: [
    [name: "Example API", url: "https://api.example.com/health"],
    [name: "Main Site", url: "https://example.com", expected_status: 200]
  ],
  webhook_url: "https://open.feishu.cn/open-apis/bot/v2/hook/your-webhook-token",
  webhook_provider: :feishu,  # or :default for generic webhooks
  jobs: [
    {"*/5 * * * *", {Exhub.HealthCheck, :run_health_checks, []}}
  ]

# MCP Habit Server Configuration (optional)
# The habit server provides an MCP endpoint at /mcp for managing user preferences
# Habits are stored in ~/.config/exhub/habits.json with metadata tracking

Build:
```
MIX_ENV=prod mix release
```
Run the Server:
```
_build/prod/rel/exhub/bin/exhub start
```

Emacs Setup

Install the Emacs Package: Add the following to your Emacs configuration file (e.g., ~/.emacs.d/init.el):

(add-to-list 'load-path (expand-file-name "site-lisp/exhub" user-emacs-directory))
(require 'exhub)
(exhub-start-elixir)
(exhub-start)

Basic

Sending Messages

Use the exhub-send function to send messages to the Elixir server:

(exhub-send "your message here")

Documentation

Module	Description	Doc
exhub-tool	MCP tool server integration (Git, File, K8s, Gitee, GitHub)	docs/modules/tool.md
exhub-chat	Chat, code generation, translation, and document polishing	docs/modules/chat.md
exhub-agent	Agent-based interactions and tool orchestration	docs/modules/agent.md
exhub-translate	Symbol and region translation utilities	docs/modules/translate.md
exhub-file	File operations and Markdown preview	docs/modules/file.md
exhub-fim	LLM-powered fill-in-the-middle code completion	docs/modules/fim.md
exhub-keep-alive	macOS Bluetooth connection maintenance	docs/modules/keep-alive.md
exhub-health-check	URL monitoring with webhook notifications	docs/modules/health-check.md
exhub-habit	MCP-based habit/environment config storage	docs/modules/habit.md
exhub-web-tools	MCP web search and URL fetch tools	docs/modules/web-tools.md
exhub-think	MCP reasoning scratchpad (think & plan tools)	docs/modules/think.md
exhub-archery	MCP Archery SQL audit platform integration	docs/modules/archery.md
exhub-time	MCP time utilities (timezone conversion, current time)	docs/modules/time.md
exhub-browser-use	MCP Chrome browser automation via kuri-agent (CDP)	docs/modules/browser-use.md
exhub-image-gen	MCP AI image generation via Gitee AI (5 models)	docs/modules/image-gen.md
exhub-todo	MCP multi-tenant todo list management with TTL expiry	docs/modules/todo.md
exhub-desktop	MCP desktop commander (filesystem, search, process management)	docs/modules/desktop.md
exhub-doc-extract	MCP document text extraction (PDF, DOCX, images) via Gitee AI	docs/modules/doc-extract.md
exhub-agent-mcp	MCP ACP Agent bridge for AI coding agents integration	docs/modules/agent-mcp.md
exhub-vault	Org-mode password vault (AES-256-GCM encrypted org links)	docs/modules/vault.md
exhub-brain	MCP Obsidian vault "second brain" (list & search notes)	docs/modules/brain.md

For a full changelog see docs/recent-enhancements.md. For secrets management see docs/SECRETS.md and docs/MIGRATION.md.

Contributing

Feel free to contribute to Exhub by opening issues or pull requests on the GitHub repository.

License

Exhub is licensed under the MIT License.

Name		Name	Last commit message	Last commit date
Latest commit History 193 Commits
config		config
docs		docs
lib		lib
scripts		scripts
test		test
.formatter.exs		.formatter.exs
.gitignore		.gitignore
.tool-versions		.tool-versions
LICENSE		LICENSE
README.md		README.md
exhub-agent.el		exhub-agent.el
exhub-chat.el		exhub-chat.el
exhub-file.el		exhub-file.el
exhub-fim.el		exhub-fim.el
exhub-gitee.el		exhub-gitee.el
exhub-tool.el		exhub-tool.el
exhub-translate.el		exhub-translate.el
exhub-vault.el		exhub-vault.el
exhub.el		exhub.el
mcp_servers.json.example		mcp_servers.json.example
mix.exs		mix.exs
mix.lock		mix.lock

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Exhub

Features

Installation

Elixir Server

SecretVault Setup

Customizing API Base URLs

Other Optional Configuration

Emacs Setup

Basic

Sending Messages

Documentation

Contributing

License

About

Uh oh!

Releases

Packages

Uh oh!

Contributors

Uh oh!

Languages

Folders and files

Latest commit

History

Repository files navigation

Exhub

Features

Installation

Elixir Server

SecretVault Setup

Customizing API Base URLs

Other Optional Configuration

Emacs Setup

Basic

Sending Messages

Documentation

Contributing

License

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages