JD.AI

AI-powered terminal assistant and multi-channel platform built on Semantic Kernel. 15 AI providers, 27 tool categories, 33+ slash commands, MCP server integration, workflow engine, subagent orchestration, team strategies, and six channel adapters — across 18 projects with 772+ tests.

Architecture

┌──────────────────────────────────────────────┐
│              TUI Client (jdai)               │
│  33+ slash commands · model search · sessions│
└──────────────────────┬───────────────────────┘
                       │
┌──────────────────────▼───────────────────────┐
│         Gateway Control Plane                │
│       (REST API + SignalR Hubs)              │
└──────┬────────────┬────────────┬─────────────┘
       │            │            │
┌──────▼──────┐ ┌───▼──────┐ ┌──▼─────────────┐
│  Telemetry  │ │ Workflows│ │  MCP Servers    │
│ OpenTelemetry│ │  Engine  │ │ (add/list/rm)  │
│ tracing,    │ │ run/list │ │                 │
│ metrics,    │ │ /refine  │ │                 │
│ health      │ │          │ │                 │
└─────────────┘ └──────────┘ └─────────────────┘
       │
┌──────▼──────────────────────────────────────┐
│     Agent Pool + Routing                    │
│  5 subagent types · 4 team strategies       │
│  ConversationTransformer (5 modes)          │
└──────┬──────────────────┬───────────────────┘
       │                  │
┌──────▼──────┐   ┌───────▼───────────┐
│  Channel    │   │  Memory /         │
│  Adapters   │   │  Embeddings       │
│ (6 channels)│   │  (SQLite vectors) │
└─────────────┘   └───────────────────┘
       │
┌──────▼──────────────────────────────────────┐
│   15 AI Providers · 27 Tool Categories      │
│   Plugin SDK · Credential Store · Sessions  │
└─────────────────────────────────────────────┘

Features

Quick Start

dotnet tool install -g JD.AI   # Install globally
jdai setup                      # One-command setup (daemon + onboarding + MCP)
jdai                            # Launch the TUI

First-Class Setup

jdai setup is the recommended, repeatable setup path. It is safe to run multiple times.

What it does:

• Ensures jdai-daemon is installed/updated (unless --no-update)
• Installs/refreshes the daemon service and starts it (unless --no-start)
• Shows daemon and bridge status
• Runs onboarding (jdai onboard) to set provider/model defaults and MCP servers

# Full setup (recommended)
jdai setup

# Change provider/model defaults and save globally
jdai setup --skip-daemon --provider "OpenAI Codex" --model gpt-5.3-codex --global

# Daemon/gateway only
jdai setup --daemon-only

# Set bridge mode while setting up daemon
jdai setup --daemon-only --bridge disable
jdai setup --daemon-only --bridge passthrough

Setup flags:

• --daemon-only: run daemon/gateway setup only
• --skip-daemon: run onboarding only
• --skip-onboard: run daemon/gateway only
• --no-update: skip jdai-daemon tool install/update
• --no-start: do not start the daemon service
• --bridge <status|enable|disable|passthrough>: set/check bridge mode
• onboarding flags are forwarded: --provider, --model, --global, --skip-mcp, --skip-import

On Windows and Linux, daemon service operations may require elevation. jdai-daemon will prompt/recommend UAC/sudo as needed.

TUI Quick Commands

/provider add                   # Add an AI provider
/help                           # List all commands

Screenshots

Markdown rendering with syntax highlighting, tables, and slash-command colorization:

Unified diff view with red/green line coloring:

Providers

OAuth / Local (zero API key)

API Key

AWS SDK

Key Commands

Run /help in the TUI for the complete list.

Gateway & Channels

The Gateway (JD.AI.Gateway) is an ASP.NET Core control plane exposing REST endpoints and SignalR hubs for real-time agent communication, authentication, rate limiting, and plugin orchestration.

Six channel adapters connect the agent pool to external platforms:

See the Gateway API docs and Channel Adapters guide.

Project Structure

src/
├── JD.AI                      # TUI client (dotnet tool)
├── JD.AI.Core                 # Agents, providers, sessions, tools, memory, event bus
├── JD.AI.Gateway              # ASP.NET Core control plane (REST + SignalR)
├── JD.AI.Daemon               # Background service host (Windows/Linux)
├── JD.AI.Plugins.SDK          # Plugin interface library
├── JD.AI.Workflows            # Workflow engine (run/list/refine)
├── JD.AI.SpecSite             # UPSS static-site generator (HTML + DocFX content)
├── JD.AI.Telemetry            # OpenTelemetry tracing, metrics, health checks
├── JD.AI.Dashboard.Wasm       # Blazor WASM dashboard (MudBlazor)
├── JD.AI.Channels.Discord     # Discord adapter
├── JD.AI.Channels.Signal      # Signal adapter
├── JD.AI.Channels.Slack       # Slack adapter
├── JD.AI.Channels.Telegram    # Telegram adapter
├── JD.AI.Channels.Web         # WebChat adapter
└── JD.AI.Channels.OpenClaw    # OpenClaw bridge adapter
tests/
├── JD.AI.Tests                # Core unit tests
├── JD.AI.Gateway.Tests        # Gateway unit tests
├── JD.AI.Workflows.Tests      # Workflow engine tests
└── JD.AI.IntegrationTests     # End-to-end integration tests

Dependencies

Documentation

Full documentation is built with docfx and published from the docs/ directory.

• API Reference — Auto-generated from XML doc comments
• User Guide — Installation, commands, workflows, best practices
• Developer Guide — Architecture, custom tools, plugins, gateway API
• Operations — Deployment, observability, security, governance
• Reference — CLI flags, commands, tools, providers, environment variables
• Specifications — Generated UPSS portal content

Contributing

See CONTRIBUTING.md for guidelines. The project uses central package management, Nerdbank.GitVersioning, and enforces code style via Meziantou.Analyzer.

License

MIT © JD