KU-Signal

K-Universe agent coordination engine. Typed K-Wire protocol, headless AgentCore, swappable adapters (CLI / TUI / VS Code / WebSocket).

Install

npm / pnpm / bun (recommended)

bun install -g @k-universe/signal
/signal
npm install -g @k-universe/signal
pnpm install -g @k-universe/signal

curl (binary — macOS / Linux)

curl -fsSL https://raw.githubusercontent.com/k-universe-dev/ku-signal/main/install.sh | bash

Homebrew (macOS / Linux)

brew tap k-universe-dev/tap
brew install ku-signal

AUR (Arch Linux)

paru -S ku-signal-bin
# or
yay -S ku-signal-bin

Windows

bun install -g @k-universe/signal

AI Coding Tools

Claude Code

claude mcp add ku-signal -- npx -y @k-universe/signal

OpenCode

opencode mcp add ku-signal -- npx -y @k-universe/signal

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "ku-signal": {
      "command": "npx",
      "args": ["-y", "@k-universe/signal"]
    }
  }
}

Windsurf

Add to ~/.windsurf/mcp_config.json:

{
  "mcpServers": {
    "ku-signal": {
      "command": "npx",
      "args": ["-y", "@k-universe/signal"]
    }
  }
}

All tools at once (agent-add)

npx -y agent-add \
  --mcp '{"server":{"command":"npx","args":["-y","@k-universe/signal"]}}' \
  --target cursor,claude,opencode,windsurf

Quick start

ku-signal --help
ku-signal init          # create BYTE.md in current project
ku-signal config --set-anthropic-key sk-...
ku-signal               # launch TUI
ku-signal -p "Hello"    # one-shot print mode

K-Wire Invariants

npx tsx scripts/verify.ts

Expected: 4/4 PASS — KWire-1, KWire-2, KWire-3, ARCH.

Architecture

| Path | Purpose | |---|---| | src/protocol/ | Typed Zod schemas — K-Wire protocol | | src/core/ | Headless AgentCore + Runner | | src/adapters/ | CLI, socket, TUI (Ink), VS Code | | src/providers/ | Anthropic, OpenAI/LM Studio | | src/tools/ | file_read, file_write, bash, search | | src/extensions/ | Extension manifest schema + discovery |

License

MIT — K-Universe Dev