u-foo 1.1.9 → 1.2.1

package/README.md

@@ -1,37 +1,86 @@
 # ufoo
 
-Multi-agent AI collaboration toolkit for Claude Code and OpenAI Codex.
+🤖 Multi-agent AI collaboration framework for orchestrating Claude Code, OpenAI Codex, and custom AI agents.
+
+[![npm version](https://img.shields.io/npm/v/u-foo.svg)](https://www.npmjs.com/package/u-foo)
+[![License](https://img.shields.io/badge/license-UNLICENSED-red.svg)](LICENSE)
+[![Node](https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg)](https://nodejs.org)
+[![Platform](https://img.shields.io/badge/platform-macOS-blue.svg)](https://www.apple.com/macos)
+
+## Why ufoo?
+
+ufoo solves the challenge of coordinating multiple AI coding agents:
+
+- **🔗 Unified Interface** - One chat UI to manage all your AI agents
+- **📬 Message Routing** - Agents can communicate and collaborate via event bus
+- **🧠 Context Sharing** - Shared decisions and knowledge across agents
+- **🚀 Auto-initialization** - Agent wrappers handle setup automatically
+- **📝 Decision Tracking** - Record architectural decisions and trade-offs
+- **⚡ Real-time Updates** - See agent status and messages instantly
 
 ## Features
 
+- **Chat Interface** - Interactive multi-agent chat UI (`ufoo chat`)
+  - Real-time agent communication and status monitoring
+  - Dashboard with agent list, online status, and quick actions
+  - Direct messaging to specific agents with `@agent-name`
 - **Event Bus** - Real-time inter-agent messaging (`ufoo bus`)
 - **Context Sharing** - Shared decisions and project context (`ufoo ctx`)
-- **Agent Wrappers** - Auto-initialization for Claude Code (`uclaude`), Codex (`ucodex`), and ufoo core (`ucode`)
+- **Agent Wrappers** - Auto-initialization for Claude Code (`uclaude`), Codex (`ucodex`), and ucode assistant (`ucode`)
   - **PTY Wrapper** - Intelligent terminal emulation with ready detection
   - **Smart Probe Injection** - Waits for agent initialization before injecting commands
+  - **Consistent Branding** - Unified agent naming (e.g., ucode-1, claude-1, codex-1)
 - **Skills System** - Extensible agent capabilities (`ufoo skills`)
 
-## Quick Start
+## Installation
 
 ```bash
-# Clone and link globally
-git clone <repo> ~/.ufoo
+# Install globally from npm
+npm install -g u-foo
+
+# Or clone from source
+git clone https://github.com/Icyoung/ufoo.git ~/.ufoo
 cd ~/.ufoo && npm link
+```
+
+## Quick Start
 
+```bash
 # Initialize a project
 cd your-project
 ufoo init
 
-# Or use agent wrappers (auto-init + bus join)
-uclaude   # instead of 'claude'
-ucodex    # instead of 'codex'
-ucode     # ufoo self-developed coding agent entry
+# Launch chat interface (default command)
+ufoo chat
+# or just
+ufoo
+
+# Use agent wrappers (auto-init + bus join)
+uclaude   # Claude Code wrapper
+ucodex    # Codex wrapper
+ucode     # ucode assistant (self-developed AI coding agent)
 ```
 
-To import a local `pi-mono` checkout as a reference snapshot (reference-only):
+## Example Workflow
 
 ```bash
-npm run import:pi-mono -- /path/to/pi-mono
+# 1. Start the chat interface
+$ ufoo
+
+# 2. Launch agents from chat
+> /launch claude
+> /launch ucode
+
+# 3. Send tasks to agents
+> @claude-1 Please analyze the current codebase structure
+> @ucode-1 Fix the bug in authentication module
+
+# 4. Agents communicate via bus
+claude-1: Analysis complete. Found 3 areas needing refactoring...
+ucode-1: Bug fixed. Running tests...
+
+# 5. Check decisions made
+> /decisions
 ```
 
 Native self-developed implementation lives under `src/code`.
@@ -52,17 +101,51 @@ ucode-core run-once --json
 ucode-core list --json
 ```
 
-Configure `ucode` provider/model/API in `.ufoo/config.json` (ufoo-managed):
+## Agent Configuration
+
+Configure AI providers in `.ufoo/config.json`:
 
+### ucode Configuration (Self-developed Assistant)
 ```json
 {
-  "ucodeProvider": "openai",
-  "ucodeModel": "gpt-5.1-codex",
+  "ucodeProvider": "openai",          // or "anthropic", "azure", etc.
+  "ucodeModel": "gpt-4-turbo-preview",
   "ucodeBaseUrl": "https://api.openai.com/v1",
   "ucodeApiKey": "sk-***"
 }
 ```
 
+### Claude Configuration
+```json
+{
+  "claudeProvider": "claude-cli",     // Uses Claude CLI
+  "claudeModel": "claude-3-opus"      // or "claude-3-sonnet"
+}
+```
+
+### Codex Configuration
+```json
+{
+  "codexProvider": "codex-cli",       // Uses Codex CLI
+  "codexModel": "gpt-4"               // or "gpt-4-turbo-preview"
+}
+```
+
+### Complete Example
+```json
+{
+  "launchMode": "internal",
+  "ucodeProvider": "openai",
+  "ucodeModel": "gpt-4-turbo-preview",
+  "ucodeBaseUrl": "https://api.openai.com/v1",
+  "ucodeApiKey": "sk-***",
+  "claudeProvider": "claude-cli",
+  "claudeModel": "claude-3-opus",
+  "codexProvider": "codex-cli",
+  "codexModel": "gpt-4"
+}
+```
+
 `ucode` writes these into a dedicated runtime directory (`.ufoo/agent/ucode/pi-agent`) and uses them for native planner/engine calls.
 
 ## Architecture
@@ -89,21 +172,43 @@ Bus state lives in `.ufoo/agent/all-agents.json` (metadata), `.ufoo/bus/*` (queu
 
 ## Commands
 
+### Core Commands
 | Command | Description |
 |---------|-------------|
+| `ufoo` | Launch chat interface (default) |
+| `ufoo chat` | Launch interactive multi-agent chat UI |
 | `ufoo init` | Initialize .ufoo in current project |
 | `ufoo status` | Show banner, unread bus messages, open decisions |
-| `ufoo daemon --start|--stop|--status` | Manage ufoo daemon |
-| `ufoo chat` | Launch ufoo chat UI (also default when no args) |
-| `ufoo resume [nickname]` | Resume agent sessions (optional nickname) |
-| `ufoo bus join` | Join event bus (auto by uclaude/ucodex/ucode) |
+| `ufoo doctor` | Check installation health |
+
+### Agent Management
+| Command | Description |
+|---------|-------------|
+| `ufoo daemon start` | Start ufoo daemon |
+| `ufoo daemon stop` | Stop ufoo daemon |
+| `ufoo daemon status` | Check daemon status |
+| `ufoo resume [nickname]` | Resume agent sessions |
+
+### Event Bus
+| Command | Description |
+|---------|-------------|
+| `ufoo bus join` | Join event bus (auto by agent wrappers) |
 | `ufoo bus send <id> <msg>` | Send message to agent |
 | `ufoo bus check <id>` | Check pending messages |
-| `ufoo bus status` | Show bus status |
+| `ufoo bus status` | Show bus status and online agents |
+
+### Context & Decisions
+| Command | Description |
+|---------|-------------|
 | `ufoo ctx decisions -l` | List all decisions |
 | `ufoo ctx decisions -n 1` | Show latest decision |
+| `ufoo ctx decisions new <title>` | Create new decision |
+
+### Skills
+| Command | Description |
+|---------|-------------|
 | `ufoo skills list` | List available skills |
-| `ufoo doctor` | Check installation health |
+| `ufoo skills show <skill>` | Show skill details |
 
 Notes:
 - Claude CLI headless agent uses `--dangerously-skip-permissions`.
@@ -117,7 +222,7 @@ ufoo/
 │   ├── ufoo.js      # Node wrapper
 │   ├── uclaude      # Claude Code wrapper
 │   ├── ucodex       # Codex wrapper
-│   └── ucode        # ufoo core wrapper
+│   └── ucode        # ucode assistant wrapper
 ├── SKILLS/          # Global skills (uinit, ustatus)
 ├── src/
 │   ├── bus/         # Event bus implementation (JS)
@@ -152,6 +257,37 @@ your-project/
 └── CLAUDE.md            # → AGENTS.md
 ```
 
+## Chat Interface
+
+The interactive chat UI provides a centralized hub for agent management:
+
+### Features
+- **Real-time Communication** - See all agent messages in one place
+- **Agent Dashboard** - Monitor online status, session IDs, and nicknames
+- **Direct Messaging** - Use `@agent-name` to target specific agents
+- **Command Completion** - Tab completion for commands and agent names
+- **Mouse Support** - Toggle with `Ctrl+M` for scrolling vs text selection
+- **Session History** - Persistent message history across sessions
+
+### Keyboard Shortcuts
+| Key | Action |
+|-----|--------|
+| `Tab` | Auto-complete commands/agents |
+| `Ctrl+C` | Exit chat |
+| `Ctrl+M` | Toggle mouse mode |
+| `Ctrl+L` | Clear screen |
+| `Ctrl+R` | Refresh agent list |
+| `↑/↓` | Navigate command history |
+
+### Chat Commands
+| Command | Description |
+|---------|-------------|
+| `/help` | Show available commands |
+| `/agents` | List online agents |
+| `/clear` | Clear chat history |
+| `/settings` | Configure chat preferences |
+| `@agent-name <message>` | Send to specific agent |
+
 ## Agent Communication
 
 Agents communicate via the event bus:
@@ -178,9 +314,10 @@ Built-in skills triggered by slash commands:
 
 ## Requirements
 
-- macOS (for Terminal.app/iTerm2 injection features)
-- Node.js >= 18 (optional, for npm global install)
-- Bash 4+
+- **macOS** - Required for Terminal.app/iTerm2 integration
+- **Node.js >= 18** - For npm installation and JavaScript runtime
+- **Bash 4+** - For shell scripts and command execution
+- **Terminal** - iTerm2 or Terminal.app for agent launching
 
 ## Codex CLI Notes
 
@@ -195,21 +332,62 @@ ufoo chat  # daemon auto-starts
 
 ## Development
 
+### Setup
 ```bash
-# Local development
-./bin/ufoo --help
+# Clone the repository
+git clone https://github.com/Icyoung/ufoo.git
+cd ufoo
+
+# Install dependencies
+npm install
 
-# Or via Node
+# Link for local development
 npm link
-ufoo --help
+
+# Run tests
+npm test
 ```
 
+### Contributing
+- Fork the repository
+- Create a feature branch (`git checkout -b feature/amazing-feature`)
+- Commit your changes (`git commit -m 'Add amazing feature'`)
+- Push to the branch (`git push origin feature/amazing-feature`)
+- Open a Pull Request
+
+### Project Structure
+- `src/` - Core JavaScript implementation
+- `bin/` - CLI entry points
+- `modules/` - Modular features (bus, context, etc.)
+- `test/` - Unit and integration tests
+- `SKILLS/` - Agent skill definitions
+
 ## License
 
 UNLICENSED (Private)
 
 ## Recent Changes
 
+### 🎨 UCode Branding & UI Improvements (2026-02-15)
+
+Enhanced ucode agent branding consistency and fixed UI rendering issues:
+
+**Features:**
+- **Consistent Branding** - ucode agents now display as "ucode-1" instead of "ufoo-code-1"
+- **Banner Normalization** - Agent type shows "ucode" in launch banners
+- **UI Width Fix** - Resolved terminal width inconsistency causing background overflow
+- **Immediate Prompt Display** - ucode TUI now shows incoming prompts instantly (not waiting for response)
+
+**Technical Details:**
+- `src/bus/nickname.js` - Maps ufoo-code → ucode for nickname generation
+- `src/utils/banner.js` - Normalized agent type display
+- `src/chat/layout.js` - Fixed blessed log component width handling
+- `src/code/tui.js` - Added onMessageReceived callback for instant display
+
+**Version:** v1.1.9
+
+---
+
 ### 🚀 Smart Ready Detection & PTY Wrapper (2026-02-06)
 
 Added intelligent agent initialization detection for reliable probe injection:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "u-foo",
-  "version": "1.1.9",
+  "version": "1.2.1",
   "description": "Multi-Agent Workspace Protocol. Just add u. claude → uclaude, codex → ucodex.",
   "license": "SEE LICENSE IN LICENSE",
   "homepage": "https://ufoo.dev",

package/src/agent/ufooAgent.js

@@ -4,6 +4,11 @@ const { runCliAgent } = require("./cliRunner");
 const { normalizeCliOutput } = require("./normalizeOutput");
 const { buildStatus } = require("../daemon/status");
 const { getUfooPaths } = require("../ufoo/paths");
+const {
+  resolveRuntimeConfig,
+  resolveCompletionUrl,
+  resolveAnthropicMessagesUrl,
+} = require("../code/nativeRunner");
 
 function loadSessionState(projectRoot) {
   const dir = getUfooPaths(projectRoot).agentDir;
@@ -153,6 +158,111 @@ function extractNickname(prompt) {
   return "";
 }
 
+function isUcodeProvider(value = "") {
+  const text = String(value || "").trim().toLowerCase();
+  return text === "ucode" || text === "ufoo" || text === "ufoo-code";
+}
+
+function stripMarkdownFence(text = "") {
+  const raw = String(text || "").trim();
+  const match = raw.match(/^```(?:json)?\s*\n([\s\S]*?)\n```\s*$/);
+  if (match) return match[1].trim();
+  return raw;
+}
+
+function clipText(value = "", maxChars = 500) {
+  const text = String(value || "");
+  if (text.length <= maxChars) return text;
+  return `${text.slice(0, maxChars)}...[truncated]`;
+}
+
+async function runNativeRouterCall({ projectRoot, prompt, systemPrompt, model: requestedModel, timeoutMs = 120000 }) {
+  const runtime = resolveRuntimeConfig({
+    workspaceRoot: projectRoot,
+    provider: "",
+    model: requestedModel,
+  });
+
+  const requestModel = String(runtime.model || "").trim();
+  if (!requestModel) {
+    return { ok: false, error: "ucode model is not configured" };
+  }
+
+  const isAnthropic = runtime.transport === "anthropic-messages";
+  const url = isAnthropic
+    ? resolveAnthropicMessagesUrl(runtime.baseUrl)
+    : resolveCompletionUrl(runtime.baseUrl);
+
+  if (!url) {
+    return { ok: false, error: "ucode baseUrl is not configured" };
+  }
+
+  const headers = { "content-type": "application/json" };
+  let body;
+
+  if (isAnthropic) {
+    headers["anthropic-version"] = "2023-06-01";
+    if (runtime.apiKey) headers["x-api-key"] = runtime.apiKey;
+    body = JSON.stringify({
+      model: requestModel,
+      max_tokens: 4096,
+      system: String(systemPrompt || ""),
+      messages: [{ role: "user", content: String(prompt || "") }],
+      temperature: 0,
+    });
+  } else {
+    if (runtime.apiKey) headers.authorization = `Bearer ${runtime.apiKey}`;
+    const messages = [];
+    if (systemPrompt) messages.push({ role: "system", content: String(systemPrompt) });
+    messages.push({ role: "user", content: String(prompt || "") });
+    body = JSON.stringify({
+      model: requestModel,
+      messages,
+      temperature: 0,
+    });
+  }
+
+  const controller = new AbortController();
+  const timer = setTimeout(() => { try { controller.abort(); } catch {} }, timeoutMs);
+
+  try {
+    const response = await fetch(url, {
+      method: "POST",
+      headers,
+      body,
+      signal: controller.signal,
+    });
+
+    if (!response.ok) {
+      const errBody = await response.text().catch(() => "");
+      return { ok: false, error: `provider request failed (${response.status}): ${clipText(errBody)}` };
+    }
+
+    const data = await response.json();
+
+    let text = "";
+    if (isAnthropic) {
+      const content = Array.isArray(data.content) ? data.content : [];
+      text = content
+        .filter((item) => item && item.type === "text")
+        .map((item) => String(item.text || ""))
+        .join("");
+    } else {
+      const choice = data.choices && data.choices[0];
+      text = choice && choice.message && typeof choice.message.content === "string"
+        ? choice.message.content
+        : "";
+    }
+
+    return { ok: true, output: text.trim() };
+  } catch (err) {
+    const message = err && err.message ? err.message : "native router call failed";
+    return { ok: false, error: message };
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
 async function runUfooAgent({ projectRoot, prompt, provider, model }) {
   const state = loadSessionState(projectRoot);
   const bus = loadBusSummary(projectRoot);
@@ -161,36 +271,57 @@ async function runUfooAgent({ projectRoot, prompt, provider, model }) {
   const historyPrompt = buildHistoryPrompt(history);
   const fullPrompt = historyPrompt ? `${historyPrompt}User: ${prompt}` : prompt;
 
-  let res = await runCliAgent({
-    provider,
-    model,
-    prompt: fullPrompt,
-    systemPrompt,
-    sessionId: state.data?.sessionId,
-    disableSession: provider === "claude-cli",
-    cwd: projectRoot,
-  });
+  let res;
 
-  if (!res.ok) {
-    const msg = (res.error || "").toLowerCase();
-    if (msg.includes("session id") || msg.includes("session-id") || msg.includes("already in use")) {
-      res = await runCliAgent({
-        provider,
-        model,
-        prompt: fullPrompt,
-        systemPrompt,
-        sessionId: undefined,
-        disableSession: provider === "claude-cli",
-        cwd: projectRoot,
-      });
+  if (isUcodeProvider(provider)) {
+    // Native path: direct HTTP to LLM API, no CLI binary needed
+    res = await runNativeRouterCall({
+      projectRoot,
+      prompt: fullPrompt,
+      systemPrompt,
+      model,
+    });
+    if (!res.ok) {
+      return { ok: false, error: res.error };
     }
-  }
+    // Native path returns { ok, output } where output is raw text
+    res = { ok: true, output: res.output, sessionId: "" };
+  } else {
+    // CLI path: spawn codex/claude binary
+    res = await runCliAgent({
+      provider,
+      model,
+      prompt: fullPrompt,
+      systemPrompt,
+      sessionId: state.data?.sessionId,
+      disableSession: provider === "claude-cli",
+      cwd: projectRoot,
+    });
 
-  if (!res.ok) {
-    return { ok: false, error: res.error };
+    if (!res.ok) {
+      const msg = (res.error || "").toLowerCase();
+      if (msg.includes("session id") || msg.includes("session-id") || msg.includes("already in use")) {
+        res = await runCliAgent({
+          provider,
+          model,
+          prompt: fullPrompt,
+          systemPrompt,
+          sessionId: undefined,
+          disableSession: provider === "claude-cli",
+          cwd: projectRoot,
+        });
+      }
+    }
+
+    if (!res.ok) {
+      return { ok: false, error: res.error };
+    }
   }
 
-  const text = normalizeCliOutput(res.output);
+  const rawText = isUcodeProvider(provider)
+    ? String(res.output || "").trim()
+    : normalizeCliOutput(res.output);
+  const text = stripMarkdownFence(rawText);
   let payload = null;
   try {
     payload = JSON.parse(text);
@@ -214,7 +345,7 @@ async function runUfooAgent({ projectRoot, prompt, provider, model }) {
   saveSessionState(projectRoot, {
     provider,
     model,
-    sessionId: res.sessionId,
+    sessionId: res.sessionId || "",
     updated_at: new Date().toISOString(),
   });
 

package/src/chat/agentBar.js

@@ -21,8 +21,8 @@ function computeAgentBar(options = {}) {
   let windowItems = Math.max(1, Math.min(maxAgentWindow, activeAgents.length));
   let start = agentListWindowStart;
   const ufooItem = focusMode === "dashboard" && selectedAgentIndex === 0
-    ? "\x1b[90;7mufoo\x1b[0m"
-    : "\x1b[36mufoo\x1b[0m";
+    ? "\x1b[90;7mucode\x1b[0m"
+    : "\x1b[36mucode\x1b[0m";
   const ufooLen = stripAnsi(ufooItem).length;
 
   const computeStart = (items) => {
@@ -60,7 +60,7 @@ function computeAgentBar(options = {}) {
       agentParts = visible.map((agent, i) => {
         const rawLabel = getAgentLabel(agent);
         const label = maxLabelLen ? truncateLabel(rawLabel, maxLabelLen) : rawLabel;
-        const idx = s + i + 1; // +1 for ufoo at index 0
+        const idx = s + i + 1; // +1 for ucode at index 0
         if (focusMode === "dashboard" && idx === selectedAgentIndex) {
           return `\x1b[90;7m${label}\x1b[0m`;
         }

package/src/chat/dashboardKeyController.js

@@ -184,7 +184,7 @@ function createDashboardKeyController(options = {}) {
 
     if (key.name === "down") {
       state.dashboardView = "provider";
-      state.selectedProviderIndex = state.agentProvider === "claude-cli" ? 1 : 0;
+      state.selectedProviderIndex = Math.max(0, (state.providerOptions || []).findIndex((opt) => opt.value === state.agentProvider));
       renderDashboardAndScreen();
       return true;
     }

package/src/chat/dashboardView.js

@@ -3,13 +3,16 @@ const { clampAgentWindowWithSelection } = require("./agentDirectory");
 const DEFAULT_MODE_OPTIONS = ["terminal", "tmux", "internal"];
 
 function providerLabel(value) {
-  return value === "claude-cli" ? "claude" : "codex";
+  if (value === "claude-cli") return "claude";
+  if (value === "ucode" || value === "ufoo" || value === "ufoo-code") return "ucode";
+  return "codex";
 }
 
 function assistantLabel(value) {
   if (value === "codex") return "codex";
   if (value === "claude") return "claude";
-  if (value === "ufoo") return "ufoo";
+  if (value === "ufoo") return "ucode";
+  if (value === "ucode") return "ucode";
   return "auto";
 }
 

package/src/chat/index.js

@@ -483,13 +483,14 @@ async function runChat(projectRoot) {
   const providerOptions = [
     { label: "codex", value: "codex-cli" },
     { label: "claude", value: "claude-cli" },
+    { label: "ucode", value: "ucode" },
   ];
-  let selectedProviderIndex = agentProvider === "claude-cli" ? 1 : 0;
+  let selectedProviderIndex = Math.max(0, providerOptions.findIndex((opt) => opt.value === agentProvider));
   const assistantOptions = [
     { label: "auto", value: "auto" },
     { label: "codex", value: "codex" },
     { label: "claude", value: "claude" },
-    { label: "ufoo", value: "ufoo" },
+    { label: "ucode", value: "ufoo" },
   ];
   let selectedAssistantIndex = Math.max(
     0,
@@ -871,6 +872,7 @@ async function runChat(projectRoot) {
       selectedAssistantIndex = value;
     },
     assistantOptions,
+    providerOptions,
     getAutoResume: () => autoResume,
     setAutoResumeState: (value) => {
       autoResume = value;
@@ -981,7 +983,7 @@ async function runChat(projectRoot) {
     agentListWindowStart = 0;
     clampAgentWindow();
     selectedModeIndex = launchMode === "internal" ? 2 : (launchMode === "tmux" ? 1 : 0);
-    selectedProviderIndex = agentProvider === "claude-cli" ? 1 : 0;
+    selectedProviderIndex = Math.max(0, providerOptions.findIndex((opt) => opt.value === agentProvider));
     selectedAssistantIndex = Math.max(
       0,
       assistantOptions.findIndex((opt) => opt.value === assistantEngine)

package/src/chat/layout.js

@@ -58,7 +58,7 @@ function createChatLayout(options = {}) {
     tags: true,
     content: "",
   });
-  const bannerText = `{bold}UFOO{/bold} · Multi-Agent Manager{|}v${version}`;
+  const bannerText = `{bold}UFOO{/bold} · Chat Manager{|}v${version}`;
   statusLine.setContent(bannerText);
 
   // Command completion panel

package/src/chat/settingsController.js

@@ -23,6 +23,7 @@ function createSettingsController(options = {}) {
     setAssistantEngineState = () => {},
     setSelectedAssistantIndex = () => {},
     assistantOptions = [],
+    providerOptions = [],
     getAutoResume = () => true,
     setAutoResumeState = () => {},
     setSelectedResumeIndex = () => {},
@@ -80,7 +81,7 @@ function createSettingsController(options = {}) {
     const next = normalizeAgentProvider(provider);
     if (next === getAgentProvider()) return false;
     setAgentProviderState(next);
-    setSelectedProviderIndex(next === "claude-cli" ? 1 : 0);
+    setSelectedProviderIndex(Math.max(0, providerOptions.findIndex((opt) => opt.value === next)));
     saveConfig(projectRoot, { agentProvider: next });
     clearUfooAgentIdentity();
     logMessage("status", `{white-fg}⚙{/white-fg} ufoo-agent: ${providerLabel(next)}`);

package/src/code/README.md

@@ -2,15 +2,7 @@
 
 `src/code/` is the self-developed core area for `ucode`.
 
-## Reference Repo (pi-mono)
-
-- Local reference repo path: `/Users/icy/Code/pi-mono`
-- Upstream reference URL: `https://github.com/badlogic/pi-mono`
-- Primary reference package: `https://github.com/badlogic/pi-mono/tree/main/packages/coding-agent`
-
-Note:
-- `pi-mono` is reference-only for architecture and behavior alignment.
-- `ucode` NL core and TUI/runtime orchestration are implemented in `src/code/`.
+`ucode` NL core and TUI/runtime orchestration are implemented in `src/code/`.
 
 ## Current native scope (phase 1)
 

package/src/code/tui.js

@@ -700,9 +700,16 @@ function runUcodeTui({
 
     // Override _listener to support cursor-aware editing
     const origDone = input._done ? input._done.bind(input) : null;
+    let lastKeyRef = null;
     input._listener = function (ch, key) {
       const keyName = key && key.name;
 
+      // Dedup: blessed delivers the same key object via element 'keypress' event
+      // from both readInput's __listener binding and screen's focused.emit('keypress').
+      // Use object identity to skip the duplicate delivery.
+      if (key && key === lastKeyRef) return;
+      lastKeyRef = key || null;
+
       // Let enter/return/escape pass through to blessed key handlers
       if (keyName === "return" || keyName === "enter" || keyName === "escape") return;
 

package/src/config.js

@@ -25,7 +25,9 @@ function normalizeLaunchMode(value) {
 }
 
 function normalizeAgentProvider(value) {
-  return value === "claude-cli" ? "claude-cli" : "codex-cli";
+  if (value === "claude-cli") return "claude-cli";
+  if (value === "ucode" || value === "ufoo" || value === "ufoo-code") return "ucode";
+  return "codex-cli";
 }
 
 function normalizeAssistantEngine(value) {

package/src/daemon/index.js

@@ -494,7 +494,7 @@ function startBusBridge(projectRoot, provider, onEvent, onStatus, shouldDrain) {
       try {
         fs.writeFileSync(debugFile, `Attempting join at ${new Date().toISOString()}\n`, { flag: "a" });
         // Determine agent type based on provider configuration
-        const agentType = provider === "codex-cli" ? "codex" : "claude-code";
+        const agentType = provider === "codex-cli" ? "codex" : (provider === "ucode" ? "ufoo-code" : "claude-code");
         // Use fixed ID "ufoo-agent" for daemon's bus identity with explicit nickname
         const sub = await eventBus.join("ufoo-agent", agentType, "ufoo-agent");
         if (!sub) {