Happy App Router

Per-app proxy routing for Clash Verge Rev on macOS. Web UI to select apps, assign proxy policies, and apply rules with one click.

🚀 Install with NPM

You can now install Happy App Router as a global command:

npm install -g @happytokenai/happy-router

After installation, you can use the command happy-router directly from anywhere in your terminal.

🖥️ Usage

Both CLI and Web UI are included and fully functional:

1. Web UI (Recommended)

Launch the beautiful, modern Web interface to manage all your rules visually:

happy-router --web

Alternatively, use npx @happytokenai/happy-router --web without installing.

2. CLI Interface

Step-by-step interactive command line guide:

happy-router

🛠️ Prerequisites

• macOS with Clash Verge Rev installed
• TUN mode enabled (required for per-process rules)
• Node.js 22+

📖 Key Features

• Pick an app — Search and select from all installed macOS applications.
• Pick a proxy — Choose a proxy group or individual node with live latency display.
• Modern Design — High-end UI with transparency effects, icon-only controls, and elegant animations.
• One-click Apply — Writes rules to clash-verge.yaml and hot-reloads via API automatically.

🚦 Routing Modes

| Mode | Behavior | |------|----------| | Append (追加规则) | Selected apps → proxy, other traffic follows original Clash rules. | | Exclusive (仅选中直连) | Selected apps → proxy, ALL other traffic goes DIRECT. |

📦 Development & Testing

If you want to contribute or test changes locally:

1. Clone & Install:

   git clone https://github.com/happytokenai/HappyRouter.git
   cd HappyRouter
   npm install

2. Local Linking (Development Mode): Link the package to your system to test the happy-router command globally without publishing:

   npm link

   Now, any changes you make in the code will be immediately reflected when you run happy-router.

3. Running Interfaces:

   • Web UI: npm run web
   • CLI: npm start
   • Desktop: npm run electron

🚢 Publishing to NPM

To publish a new version to the NPM registry:

1. Login (if not already):

   npm login --registry https://registry.npmjs.org

2. Update Version: Increment the version in package.json (e.g., from 1.0.0 to 1.0.1).

3. Publish:

   npm publish --access public

⚠️ Important

• TUN mode must be enabled — PROCESS-NAME rules only work in TUN mode.
• Auto Backup — A backup of your clash-verge.yaml is created before every change.
• Safe Markers — Rules are wrapped in # BEGIN/END HAPPY_APP_ROUTER markers for safe removal.

📄 License

MIT