u-foo 1.0.2 → 1.0.6

package/README.md

@@ -7,6 +7,8 @@ Multi-agent AI collaboration toolkit for Claude Code and OpenAI Codex.
 - **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`) and Codex (`ucodex`)
+  - **PTY Wrapper** - Intelligent terminal emulation with ready detection
+  - **Smart Probe Injection** - Waits for agent initialization before injecting commands
 - **Skills System** - Extensible agent capabilities (`ufoo skills`)
 
 ## Quick Start
@@ -45,6 +47,8 @@ ucodex    # instead of 'codex'
        └─────────────┘ └───────┘ └─────────────┘
 ```
 
+Bus state lives in `.ufoo/agent/all-agents.json` (metadata), `.ufoo/bus/*` (queues/events), and `.ufoo/daemon/*` (bus daemon runtime).
+
 ## Commands
 
 | Command | Description |
@@ -53,6 +57,7 @@ ucodex    # instead of 'codex'
 | `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) |
 | `ufoo bus send <id> <msg>` | Send message to agent |
 | `ufoo bus check <id>` | Check pending messages |
@@ -75,12 +80,11 @@ ufoo/
 │   ├── uclaude      # Claude Code wrapper
 │   └── ucodex       # Codex wrapper
 ├── SKILLS/          # Global skills (uinit, ustatus)
-├── scripts/
-│   ├── bus.sh       # Event bus implementation
-│   ├── bus-*.sh     # Bus utilities (inject, daemon, alert)
-│   ├── context-*.sh # Context management
-│   ├── init.sh      # Project initialization
-│   └── skills.sh    # Skills management
+├── src/
+│   ├── bus/         # Event bus implementation (JS)
+│   ├── daemon/      # Daemon + chat bridge
+│   └── agent/       # Agent launch/runtime
+├── scripts/         # Legacy helpers (bash, deprecated)
 ├── modules/
 │   ├── context/     # Decision/context protocol
 │   ├── bus/         # Bus module resources
@@ -101,8 +105,9 @@ your-project/
 │   │   ├── queues/      # Per-agent message queues
 │   │   └── offsets/     # Read position tracking
 │   └── context/
-│       └── DECISIONS/   # Decision records
-├── scripts/             # Symlinked ufoo scripts
+│       ├── decisions/   # Decision records
+│       └── decisions.jsonl  # Decision index
+├── scripts/             # Legacy symlink (optional)
 ├── AGENTS.md            # Injected protocol blocks
 └── CLAUDE.md            # → AGENTS.md
 ```
@@ -162,3 +167,57 @@ ufoo --help
 ## License
 
 UNLICENSED (Private)
+
+## Recent Changes
+
+### 🚀 Smart Ready Detection & PTY Wrapper (2026-02-06)
+
+Added intelligent agent initialization detection for reliable probe injection:
+
+**Features:**
+- **ReadyDetector** - Monitors PTY output to detect when agents are ready
+- **Smart Probe Timing** - Injects session probe after agent initialization (not before)
+- **Multi-layer Fallback** - 10s ready detection + 8s fallback + 15 retries
+- **Performance Metrics** - Tracks detection time and buffer usage (`UFOO_DEBUG=1`)
+
+**Benefits:**
+- ✅ No more premature probe injection (was 2s, now waits for prompt)
+- ✅ Reliable session ID capture (39 tests, 100% pass)
+- ✅ Production-ready error handling and logging
+
+**Technical Details:**
+- `src/agent/readyDetector.js` - PTY output analysis
+- `src/agent/ptyWrapper.js` - Terminal emulation with monitoring
+- `src/daemon/providerSessions.js` - Early probe triggering support
+
+See `.ufoo/plans/ready-detection-production-checklist.md` for full details.
+
+---
+
+### 🎉 Bash to JavaScript Migration (2026-02-04)
+
+We've successfully migrated **80% of the codebase** from Bash to JavaScript for better maintainability and cross-platform support!
+
+**What Changed:**
+- ✅ EventBus core (986 lines) → 8 JavaScript modules
+- ✅ Daemon & inject → Pure JavaScript
+- ✅ status, skills, init → JavaScript modules
+- ⏸️ Context management scripts remain in Bash (complex text processing)
+
+**Impact:**
+- **CLI commands unchanged** - All commands work exactly as before
+- **Performance:** 51ms/message (vs 45ms in Bash, +13%)
+- **Testing:** 20/20 integration tests passing
+- **Quality:** Better error handling, testing, and IDE support
+
+**Learn More:**
+- See [MIGRATION_LOG.md](MIGRATION_LOG.md) for full details
+- View archived scripts in `scripts/.archived/migrated-to-js/`
+- Performance benchmarks in test reports
+
+**Why This Matters:**
+- 🎯 Unified JavaScript tech stack
+- 🧪 Easier to test and maintain
+- 🌍 Cross-platform potential (Windows/Linux)
+- 💡 Better IDE support and refactoring
+- 🚀 Foundation for future enhancements

package/README.zh-CN.md

@@ -45,6 +45,8 @@ ucodex    # 代替 'codex'
        └─────────────┘ └───────┘ └─────────────┘
 ```
 
+Bus 状态存放于 `.ufoo/agent/all-agents.json`（元数据）、`.ufoo/bus/*`（队列/事件）以及 `.ufoo/daemon/*`（bus daemon 运行态）。
+
 ## 命令列表
 
 | 命令 | 说明 |
@@ -53,6 +55,7 @@ ucodex    # 代替 'codex'
 | `ufoo status` | 显示 banner、未读消息和未处理决策 |
 | `ufoo daemon --start|--stop|--status` | 管理 ufoo 守护进程 |
 | `ufoo chat` | 启动 ufoo 交互界面（无参数默认进入） |
+| `ufoo resume [nickname]` | 恢复 agent 会话（可选昵称） |
 | `ufoo bus join` | 加入事件总线（uclaude/ucodex 自动完成）|
 | `ufoo bus send <id> <msg>` | 发送消息给Agent |
 | `ufoo bus check <id>` | 检查待处理消息 |
@@ -75,12 +78,11 @@ ufoo/
 │   ├── uclaude      # Claude Code 包装器
 │   └── ucodex       # Codex 包装器
 ├── SKILLS/          # 全局技能（uinit, ustatus）
-├── scripts/
-│   ├── bus.sh       # 事件总线实现
-│   ├── bus-*.sh     # 总线工具（注入、守护进程、提醒）
-│   ├── context-*.sh # 上下文管理
-│   ├── init.sh      # 项目初始化
-│   └── skills.sh    # 技能管理
+├── src/
+│   ├── bus/         # 事件总线实现（JS）
+│   ├── daemon/      # Daemon + chat bridge
+│   └── agent/       # Agent 启动/运行
+├── scripts/         # 历史遗留（bash，已弃用）
 ├── modules/
 │   ├── context/     # 决策/上下文协议
 │   ├── bus/         # 总线模块资源
@@ -102,7 +104,7 @@ your-project/
 │   │   └── offsets/     # 读取位置跟踪
 │   └── context/
 │       └── DECISIONS/   # 决策记录
-├── scripts/             # 软链接的 ufoo 脚本
+├── scripts/             # 软链接（历史遗留，可选）
 ├── AGENTS.md            # 注入的协议块
 └── CLAUDE.md            # → AGENTS.md
 ```

package/SKILLS/ufoo/SKILL.md

@@ -0,0 +1,117 @@
+---
+name: ufoo
+description: |
+  Unified ufoo agent protocol: context decisions, event bus, and initialization.
+  Use when: (1) input starts with "/ufoo", (2) agent session startup, (3) any ufoo-related operation.
+  Combines uctx (decisions), ubus (messaging), and uinit (initialization).
+---
+
+# ufoo — Unified Agent Protocol
+
+ufoo is the multi-agent coordination layer. It provides three capabilities:
+
+1. **Context Decisions** — Persistent knowledge log shared across agents
+2. **Event Bus** — Inter-agent messaging
+3. **Initialization** — Project setup for ufoo modules
+
+## Session Marker
+
+When you see `/ufoo <marker>` (e.g., `/ufoo claude-9`), this is a daemon probe for session tracking. **Do not reply.** Silently ignore it and wait for the next user input.
+
+---
+
+## 1. Context Decisions (uctx)
+
+### When to Record
+
+**"If it has information value, write it down."**
+
+Record a decision whenever your work produces knowledge that would be useful to your future self, other agents, or the user. The threshold is LOW — when in doubt, record it.
+
+- **Always record**: architectural choices, trade-off analysis, research findings, non-obvious gotchas, naming/convention changes, external API behavior discovered, performance observations, bug root causes
+- **Also record**: open questions you couldn't resolve, assumptions you made, approaches you considered and rejected (with reasons), edge cases noticed but not handled
+- **Write the decision BEFORE acting on it** — if your session dies, the knowledge survives
+- **Granularity**: one sentence or multi-page analysis — match the depth to the information value
+
+### Commands
+
+```bash
+ufoo ctx decisions -l              # List all decisions
+ufoo ctx decisions -s open         # Check open decisions
+ufoo ctx decisions -n 1            # Show latest decision
+ufoo ctx decisions new "Title"     # Create new decision
+```
+
+### Decision Format
+
+Decisions live at: `.ufoo/context/decisions/`
+
+```yaml
+---
+status: open
+---
+# DECISION NNNN: <Title>
+
+Date: YYYY-MM-DD
+Author: <agent>
+
+Context:
+What led to this decision?
+
+Decision:
+What is now considered true?
+
+Implications:
+What must follow from this?
+```
+
+### Handling Open Decisions
+
+1. **Read and understand** — sync other agents' knowledge
+2. **Check if action needed** — does it require implementation?
+3. **Execute if needed** — do the work
+4. **Resolve** — update frontmatter: `status: resolved`, `resolved_by:`, `resolved_at:`
+
+**NEVER resolve blindly.** Reading the title is not enough.
+
+---
+
+## 2. Event Bus (ubus)
+
+### Commands
+
+```bash
+ufoo bus check "$UFOO_SUBSCRIBER_ID"        # Check pending messages
+ufoo bus ack "$UFOO_SUBSCRIBER_ID"           # Acknowledge after handling
+ufoo bus send "<target>" "<message>"         # Send message
+ufoo bus broadcast "<message>"               # Broadcast to all
+ufoo bus status                              # Show bus status
+```
+
+### Target Resolution
+
+- Exact ID: `claude-code:abc123`
+- Nickname: `architect`
+- Type: `codex` (all codex agents)
+- Wildcard: `*` (broadcast)
+
+### CRITICAL: When you receive pending messages
+
+**EXECUTE tasks immediately. Do NOT ask the user.**
+
+1. Check: `ufoo bus check $UFOO_SUBSCRIBER_ID`
+2. Execute each task
+3. Reply: `ufoo bus send "<publisher>" "<result>"`
+4. **Always ack**: `ufoo bus ack $UFOO_SUBSCRIBER_ID`
+
+---
+
+## 3. Initialization (uinit)
+
+Trigger: `/uinit` or `/ufoo init`
+
+```bash
+ufoo init --modules context,bus --project $(pwd)
+```
+
+After init, auto-join bus if enabled.

package/SKILLS/uinit/SKILL.md

@@ -0,0 +1,73 @@
+---
+name: uinit
+description: |
+  Initialize ufoo modules in current project.
+  Use when: (1) new project needs context/bus enabled, (2) user inputs /uinit or /ufoo init.
+  Provides interactive module selection, defaults to all selected.
+---
+
+# uinit
+
+Initialize ufoo modules in current project.
+
+## Trigger
+
+User inputs `/uinit` or `/ufoo init`
+
+## Execution Flow
+
+### 1. Ask user to select modules
+
+Use AskUserQuestion tool, provide multi-select, default all selected:
+
+```
+Please select modules to enable:
+
+☑ context - Shared context protocol (.ufoo/context/)
+☑ bus - Agent event bus (.ufoo/bus/ + .ufoo/agent/)
+☐ resources - UI/Icons resources (optional)
+```
+
+Options:
+- `context` (recommended) - Shared context, decision recording, knowledge persistence
+- `bus` (recommended) - Multi-agent communication, task delegation, message passing
+- `resources` (optional) - UI tone guide, icon library
+
+Default selected: context, bus
+
+### 2. Execute initialization
+
+Based on user selection, execute:
+
+```bash
+ufoo init --modules <selected_modules> --project $(pwd)
+```
+
+### 3. If bus module selected, auto-join bus
+
+```bash
+SUBSCRIBER=$(ufoo bus join | tail -1)
+echo "Joined event bus: $SUBSCRIBER"
+```
+
+### 4. Report initialization result
+
+```
+=== ufoo initialization complete ===
+
+Enabled modules:
+  ✓ context → .ufoo/context/
+  ✓ bus → .ufoo/bus/ + .ufoo/agent/
+
+My identity: claude-code:<session-id>
+
+Next steps:
+  - Run /ctx to check context status
+  - See AGENTS.md for protocol rules
+```
+
+## Notes
+
+- If .ufoo/context, .ufoo/bus, or .ufoo/agent already exists, skip creation
+- After initialization, auto-join event bus (if bus enabled)
+- AGENTS.md will have protocol description block injected

package/SKILLS/ustatus/SKILL.md

@@ -0,0 +1,36 @@
+---
+name: ustatus
+description: |
+  Unified ufoo status check. Shows banner, unread bus messages, and open decisions.
+  Use when: (1) User asks for status, (2) Quick health check, (3) Before starting work.
+---
+
+# ufoo Status
+
+## What this does
+
+Quick, unified status view:
+- Banner
+- Unread bus messages (unacked queues)
+- Open decisions
+
+## Workflow
+
+### 1. Verify structure exists
+
+Check `.ufoo/` exists. If missing, tell user to run `ufoo init`.
+
+### 2. Run status command
+
+```bash
+ufoo status
+```
+
+### 3. Report status
+
+Briefly summarize:
+- Unread messages count
+- Open decisions count
+- Any immediate action needed
+
+If unread messages > 0, advise running `ufoo bus check <subscriber>` and `ufoo bus ack <subscriber>` after handling.

package/bin/uclaude.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * uclaude: Launch Claude Code and auto-join event bus
+ *
+ * Usage: uclaude [claude args...]
+ */
+
+const AgentLauncher = require("../src/agent/launcher");
+
+const launcher = new AgentLauncher("claude-code", "claude");
+const args = process.argv.slice(2);
+
+launcher.launch(args);

package/bin/ucodex.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * ucodex: Launch Codex and auto-join event bus
+ *
+ * Usage: ucodex [codex args...]
+ */
+
+const AgentLauncher = require("../src/agent/launcher");
+
+const launcher = new AgentLauncher("codex", "codex");
+const args = process.argv.slice(2);
+
+launcher.launch(args);

package/bin/ufoo

@@ -18,14 +18,14 @@ Usage:
   ufoo daemon --start|--stop|--status
   ufoo chat
   ufoo init [--modules context[,resources]] [--project <dir>]
-  ufoo bus <...>            # delegates to ./scripts/bus.sh in the current project
-  ufoo ctx <...>            # delegates to ./scripts/ai-context-*.sh in the current project
+  ufoo bus <...>            # JS bus implementation (project-local data)
+  ufoo ctx <...>            # JS context commands (doctor|lint|decisions)
   ufoo skills list
   ufoo skills install <name|all> [--codex|--agents|--target <dir>]
 
 Notes:
   - `init` creates/updates <project>/.ai-context and injects CLAUDE.md/AGENTS.md blocks.
-  - For Codex notifications, prefer `scripts/bus-alert.sh` / `scripts/bus-listen.sh` (no IME issues).
+  - For Codex notifications, prefer `ufoo bus alert` / `ufoo bus listen` (no IME issues).
 USAGE
 }
 
@@ -37,10 +37,10 @@ case "$cmd" in
     exec node "$repo_root/bin/ufoo.js" chat
     ;;
   doctor)
-    exec bash "$repo_root/scripts/doctor.sh"
+    exec node "$repo_root/bin/ufoo.js" doctor "$@"
     ;;
   status)
-    exec bash "$repo_root/scripts/status.sh"
+    exec node "$repo_root/bin/ufoo.js" status "$@"
     ;;
   daemon)
     exec node "$repo_root/bin/ufoo.js" daemon "$@"
@@ -49,41 +49,19 @@ case "$cmd" in
     exec node "$repo_root/bin/ufoo.js" chat
     ;;
   init)
-    exec bash "$repo_root/scripts/init.sh" "$@"
+    exec node "$repo_root/bin/ufoo.js" init "$@"
     ;;
   bus)
     # Project-local bus commands. Must be run from within the target project.
-    if [[ ! -x "./scripts/bus.sh" ]]; then
-      echo "FAIL: missing ./scripts/bus.sh. Run: ufoo init --modules bus" >&2
-      exit 1
-    fi
-    exec bash "./scripts/bus.sh" "$@"
+    exec node "$repo_root/bin/ufoo.js" bus "$@"
     ;;
   ctx)
-    # Project-local ctx commands. Must be run from within the target project.
-    sub="${1:-doctor}"
-    shift || true
-    case "$sub" in
-      doctor)
-        exec bash "./scripts/ai-context-doctor.sh" "$@"
-        ;;
-      lint)
-        exec bash "./scripts/ai-context-lint.sh" "$@"
-        ;;
-      decisions)
-        exec bash "./scripts/ai-context-decisions.sh" "$@"
-        ;;
-      *)
-        echo "Unknown ctx subcommand: $sub" >&2
-        echo "Supported: doctor, lint, decisions" >&2
-        exit 1
-        ;;
-    esac
+    exec node "$repo_root/bin/ufoo.js" ctx "$@"
     ;;
   skills)
     sub="${1:-}"
     shift || true
-    exec bash "$repo_root/scripts/skills.sh" "$sub" "$@"
+    exec node "$repo_root/bin/ufoo.js" skills "$sub" "$@"
     ;;
   *)
     echo "Unknown command: $cmd" >&2

package/bin/ufoo.js

@@ -4,6 +4,7 @@ const { runCli } = require("../src/cli");
 const { runDaemonCli } = require("../src/daemon/run");
 const { runChat } = require("../src/chat");
 const { runInternalRunner } = require("../src/agent/internalRunner");
+const { runPtyRunner } = require("../src/agent/ptyRunner");
 
 const cmd = process.argv[2];
 
@@ -21,6 +22,18 @@ async function main() {
     await runInternalRunner({ projectRoot: process.cwd(), agentType });
     return;
   }
+  if (cmd === "agent-pty-runner") {
+    const agentType = process.argv[3] || "codex";
+    try {
+      await runPtyRunner({ projectRoot: process.cwd(), agentType });
+    } catch (err) {
+      // Fallback to headless runner if PTY is unavailable
+      // eslint-disable-next-line no-console
+      console.error(`[pty-runner] ${err.message || err}. Falling back to headless internal runner.`);
+      await runInternalRunner({ projectRoot: process.cwd(), agentType });
+    }
+    return;
+  }
   if (cmd === "chat") {
     await runChat(process.cwd());
     return;

package/modules/AGENTS.template.md

@@ -44,13 +44,21 @@ ufoo ctx decisions -n 1
 ```
 
 Key files in `.ufoo/context/`:
-- `DECISIONS/` - Decision log (append-only)
-- `SYSTEM.md` - System overview
-- `CONSTRAINTS.md` - Non-negotiable rules
+- `decisions/` - Decision log (append-only)
 
-**Decision recording policy:**
-- **Must record**: evaluations, architecture, naming, trade-offs
-- Write decision **before replying** when applicable
+**Decision recording policy — "If it has information value, write it down":**
+
+Record a decision whenever your work produces knowledge that would be useful to your future self, other agents, or the user. The threshold is LOW — when in doubt, record it.
+
+- **Always record**: architectural choices, trade-off analysis, research findings, non-obvious gotchas, naming/convention changes, external API behavior discovered, performance observations, bug root causes
+- **Also record**: open questions you couldn't resolve, assumptions you made, approaches you considered and rejected (with reasons), edge cases noticed but not handled
+- **Write the decision BEFORE acting on it** — if your session dies, the knowledge survives
+- **Granularity**: A decision can be one sentence ("X doesn't support Y, use Z instead") or a multi-page analysis. Match the depth to the information value.
+
+```bash
+ufoo ctx decisions new "Short descriptive title"
+# Then edit the created file with Context/Decision/Implications
+```
 
 ---
 
@@ -83,5 +91,5 @@ Extract sender ID from "from" field, use it to reply.
 
 1. Receive: `@you from claude-code:bd36dda0 Content: {"message":"Please analyze the project structure"}`
 2. Execute: Analyze the project structure
-3. Reply: `ufoo bus send "claude-code:bd36dda0" "Project contains src/, scripts/, modules/"`
+3. Reply: `ufoo bus send "claude-code:bd36dda0" "Project contains src/, modules/, bin/"`
 <!-- /ufoo -->

package/modules/bus/README.md

@@ -22,11 +22,17 @@ ufoo init --modules context,bus
 ## Directory Structure
 
 ```
-.bus/
-├── bus.json      # Bus metadata + subscriber status
-├── events/       # Event stream (JSONL, sharded by date)
-├── offsets/      # Each Agent's consumption progress
-└── queues/       # Targeted event queues
+.ufoo/
+├── agent/
+│   └── all-agents.json  # Agent metadata + agent status
+├── daemon/
+│   ├── daemon.pid
+│   ├── daemon.log
+│   └── counts/
+└── bus/
+    ├── events/          # Event stream (JSONL, sharded by date)
+    ├── offsets/         # Each Agent's consumption progress
+    └── queues/          # Targeted event queues
 ```
 
 ## Usage
@@ -34,33 +40,33 @@ ufoo init --modules context,bus
 ### Join Bus
 
 ```bash
-SUBSCRIBER=$(bash scripts/bus.sh join)
+SUBSCRIBER=$(ufoo bus join | tail -n 1)
 # Output: claude-code:a1b2c3
 ```
 
 ### Check Pending Messages
 
 ```bash
-bash scripts/bus.sh check $SUBSCRIBER
+ufoo bus check "$SUBSCRIBER"
 ```
 
 ### Send Messages
 
 ```bash
 # Send to specific instance
-bash scripts/bus.sh send "claude-code:abc123" "Please help me review"
+ufoo bus send "claude-code:abc123" "Please help me review"
 
 # Send to all instances of same type
-bash scripts/bus.sh send "claude-code" "Everyone please review"
+ufoo bus send "claude-code" "Everyone please review"
 
 # Broadcast to all
-bash scripts/bus.sh broadcast "I completed feature-x"
+ufoo bus broadcast "I completed feature-x"
 ```
 
 ### View Status
 
 ```bash
-bash scripts/bus.sh status
+ufoo bus status
 ```
 
 ## Notifications/Alerts (no key injection, recommended)
@@ -68,47 +74,46 @@ bash scripts/bus.sh status
 If you want to receive "new message alerts" while running Codex/Claude in another terminal, use **agent-side alert/listen** (avoids IME/accessibility permission/window positioning fragmentation issues):
 
 ```bash
-SUBSCRIBER=$(bash scripts/bus.sh join | tail -n 1)
+SUBSCRIBER=$(ufoo bus join | tail -n 1)
 
 # Background alert: title badge + bell + optional macOS notification center
-bash scripts/bus-alert.sh "$SUBSCRIBER" 1 --notify --daemon
+ufoo bus alert "$SUBSCRIBER" 1 --notify --daemon
 
 # Or: foreground continuous print of new messages (suitable for a side terminal)
-bash scripts/bus-listen.sh "$SUBSCRIBER" --from-beginning
+ufoo bus listen "$SUBSCRIBER" --from-beginning
 ```
 
 ## Unattended Auto-Execute (recommended)
 
-If you need **Claude A to notify Claude B / Codex C and have the target auto-execute** (e.g., auto-trigger `/ubus`), use `autotrigger`:
+If you need **Claude A to notify Claude B / Codex C and have the target auto-execute** (e.g., auto-trigger `/ubus`), use the bus daemon:
 
 1) First `join` in each terminal session (records `tty`, also records `TMUX_PANE` if in tmux):
 
 ```bash
-SUBSCRIBER=$(bash scripts/bus.sh join | tail -n 1)
+SUBSCRIBER=$(ufoo bus join | tail -n 1)
 ```
 
-2) Start autotrigger in the project (runs as background daemon):
+2) Start the bus daemon in the project (runs as background daemon):
 
 ```bash
-# backend=auto prefers tmux (if available), otherwise tries Terminal.app do script (pure Automation), finally Accessibility
-bash scripts/bus-autotrigger.sh start --interval 1 --command "/ubus" --backend auto
+ufoo bus daemon --interval 1 --daemon
 ```
 
-3) After sending a message, autotrigger injects `/ubus` into the target session and presses Enter:
+3) After sending a message, the daemon injects `/ubus` into the target session and presses Enter:
 - tmux: `send-keys`
 - Terminal.app (pure Automation): `do script` (no Accessibility needed, but requires Automation authorization; compatibility depends on whether target program accepts input)
 - Terminal.app (Accessibility): System Events (needs Accessibility), injection sequence is Escape + paste + Return (avoids IME issues)
 
 Tips:
-- Terminal.app backend depends on `tty` in `bus.json`. Execute `join` in the target terminal session (ensure `tty` is not `not a tty`).
+- Terminal.app backend depends on `tty` in `.ufoo/agent/all-agents.json`. Execute `join` in the target terminal session (ensure `tty` is not `not a tty`).
 - Pure Automation backend needs one-time authorization: System Preferences → Privacy & Security → Automation (allow script to control Terminal).
 - Accessibility backend needs one-time authorization: System Preferences → Privacy & Security → Accessibility (for Terminal / script host).
 
 Stop/view status:
 
 ```bash
-bash scripts/bus-autotrigger.sh status
-bash scripts/bus-autotrigger.sh stop
+ufoo bus daemon --status
+ufoo bus daemon --stop
 ```
 
 ## Subscriber ID Format