HotPlex

AI Agent Control Plane — Turn AI CLIs into Production-Ready Services

Quick Start • Features • Docs • Slack Guide • 简体中文

HotPlex transforms AI CLI tools (Claude Code, OpenCode) from "run-and-exit" commands into persistent, stateful services with full-duplex streaming.

Why HotPlex?

• Zero Spin-up Overhead — Eliminate 3-5 second CLI cold starts with persistent session pooling
• Cli-as-a-Service — Continuous instruction flow and context preservation across interactions
• Production-Ready Security — Regex WAF, PGID process isolation, and filesystem boundaries
• Multi-Platform ChatApps — Native Slack, Telegram, Feishu, DingTalk integration
• Simple Integration — Go SDK embedding or standalone WebSocket server

• Go 1.25+
• Claude Code CLI or OpenCode CLI (optional, for AI capabilities)

# One-click install (Linux / macOS / WSL)
curl -sL https://raw.githubusercontent.com/hrygo/hotplex/main/install.sh | bash

More options: specific version, custom directory, dry-run - see INSTALL.md.

# Copy example environment
cp .env.example .env

# Edit with your credentials
# For ChatApps, configure chatapps/configs/*.yaml

# Start with ChatApps (recommended for production)
./dist/hotplexd --config chatapps/configs

# Or start standalone server
./dist/hotplexd

That's it! Your AI agent service is now running.

┌─────────────────────────────────────────────────────────────┐
│                      Access Layer                           │
│         Go SDK  │  WebSocket  │  ChatApps Adapters          │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                      Engine Layer                           │
│    Session Pool  │  Config Manager  │  Security WAF         │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                     Process Layer                           │
│    Claude Code  │  OpenCode  │  Isolated Workspaces         │
└─────────────────────────────────────────────────────────────┘

import "github.com/hrygo/hotplex"

engine, _ := hotplex.NewEngine(hotplex.EngineOptions{
    Timeout: 5 * time.Minute,
})

engine.Execute(ctx, cfg, "Refactor this function", func(event Event) {
    fmt.Println(event.Content)
})

# chatapps/configs/slack.yaml
platform: slack
mode: socket
bot_user_id: ${HOTPLEX_SLACK_BOT_USER_ID}
system_prompt: |
  You are a helpful coding assistant.

export HOTPLEX_SLACK_BOT_USER_ID=B12345
export HOTPLEX_SLACK_BOT_TOKEN=xoxb-...
export HOTPLEX_SLACK_APP_TOKEN=xapp-...
hotplexd --config chatapps/configs

HotPlex employs defense-in-depth security:

We welcome contributions! Please ensure CI passes:

make lint    # Run golangci-lint
make test    # Run unit tests

See CONTRIBUTING.md for guidelines.

Released under the MIT License.