开源AI工作流

Requirements

- Node.js 18 or newer. - macOS for Terminal.app/iTerm2 integration. - Claude Code, Codex CLI, or Antigravity CLI installed when using the matching wrappers: uclaude, ucodex, or uagy.

Installation

Install the published package:

npm install -g u-foo

Or link this repository for local development:

git clone https://github.com/Icyoung/ufoo.git
cd ufoo
npm install
npm link

Installed binaries:

Quick Start

Initialize a project and open the chat dashboard:

cd your-project
ufoo init --targets context,bus
ufoo

Launch agents from chat:

> /launch codex reviewer
> /launch claude builder
> /launch ucode fixer
> @reviewer inspect the current diff and list release risks

Or launch wrappers directly inside a project:

uclaude
ucodex
uagy
ucode

Use global chat mode to switch between registered projects:

ufoo -g

For MCP-capable clients, configure the global stdio bridge once:

ufoo mcp

The MCP bridge connects to the home-scoped global controller daemon and routes project-scoped tools through the global project registry. It is not a separate per-project MCP server mode.

Daily Usage

The normal workflow is to enter chat first, then launch agents and run project commands inside the dashboard:

ufoo
ufoo -g

ufoo opens the current project chat. ufoo -g opens global chat for switching between registered projects. The project daemon is started as needed.

Configuration

Project configuration is stored in .ufoo/config.json. ucode provider credentials are stored globally in ~/.ufoo/config.json and merged at load time.

Common project settings:

{
  "launchMode": "auto",
  "agentProvider": "codex-cli",
  "controllerMode": "main",
  "codexInternalThreadMode": "api",
  "codexAuthPath": "",
  "codexOauthRefreshWindowSec": 300,
  "claudeOauthProfile": "",
  "claudeOauthTokenPath": "",
  "claudeOauthRefreshWindowSec": 300,
  "routerProvider": "",
  "routerModel": "",
  "agentModel": "",
  "autoResume": true
}

Supported launchMode values: auto, internal, tmux, terminal, and host. controllerMode accepts main, shadow, loop, and legacy compatibility values.

Global ucode settings:

{
  "ucodeProvider": "openai",
  "ucodeModel": "gpt-4.1",
  "ucodeBaseUrl": "https://api.openai.com/v1",
  "ucodeApiKey": "sk-...",
  "ucodeAgentDir": ""
}

Troubleshooting

Run a local entry directly if the linked binary is not on PATH:

node bin/ufoo.js --help

If Codex cannot write under its default home, point it at a project-local directory before launching chat or agents:

export CODEX_HOME="$PWD/.ufoo/codex"
ufoo

For Codex-friendly notifications, prefer bus helpers over raw terminal text injection:

ufoo bus alert codex:abc123 --daemon
ufoo bus listen codex:abc123