# XKeen Manager for Raycast

URL: https://www.raycast.com/vbrs/xkeen-manager

> Manage the xkeen (Xray) proxy client on Keenetic routers over SSH: status, server profiles, routing rules, backups and health checks

- Install: raycast://extensions/vbrs/xkeen-manager
- Author: [Виктор Брухис](https://www.raycast.com/vbrs)
- Installs: 10
- Platforms: macOS
- Categories: System, Security, AI Extensions
- Updated: 2026-11-11
- Source: https://github.com/raycast/extensions/tree/ebc6660dd359d62915350abb679c3b070184662d/extensions/xkeen-manager/

## Commands

- **XKeen Manager**: Status, restart and logs for xkeen
- **Setup SSH Connection**: Wizard to configure passwordless access
- **XKeen Menu Bar**: XKeen status in the menu bar with quick actions

## AI tools

- **Get Status**: Get current xkeen status, mode, active profile and router health (/opt, disk, xkeen binary)
- **List Profiles**: List available xkeen server profiles and show which one is active
- **Switch Profile**: Switch xkeen to another server profile and restart it
- **Add Domains**: Add domains, keywords or geosite/geoip entries to xkeen routing

## README

> 🇷🇺 Русская версия: [README.ru.md](https://github.com/raycast/extensions/raw/ebc6660dd359d62915350abb679c3b070184662d/extensions/xkeen-manager//README.ru.md)

### XKeen Manager for Raycast

**XKeen Manager** — the ultimate control panel for Xray (the `xkeen` package) on Keenetic routers.
Monitor status, switch servers, and manage routing rules without touching the terminal.

#### ✨ Features

*   🚀 **Full Control:** Start, Stop, Restart with status indication (Green/Red) and operational mode.
*   🌍 **Smart IP Check:** Hybrid verification showing your real ISP IP (router request) and VPN IP (Mac request), so you know exactly if the bypass is working.
*   🔄 **Profile Manager:**
    *   Create different profiles for different countries/servers.
    *   Switch on the fly. The script safely replaces the server config (`04_outbounds.json`).
    *   *Auto-Sync:* If you edit the active profile's config, changes save to both the live config and the profile backup.
*   📝 **JSON Editor:** Built-in editor for `Routing` and `Outbounds` with syntax validation.
*   📜 **Logs:** View recent Xray events (newest at the top).

##### New Features

*   **Menu Bar:** The "XKeen Menu Bar" command displays a colored status indicator (green = running, red = stopped, orange = connection error). Switch profiles and restart directly from the menu with background updates every 10 minutes.
*   **AI Tools:** Manage through Raycast AI — `get-status`, `list-profiles`, `switch-profile`, `add-domains` commands with confirmations for state-changing actions.
*   **Preferences:** "Proxy Outbound Tag" setting for specifying the outbound node tag; leave empty to auto-detect from `04_outbounds.json`.

#### 🛠 Requirements

1.  **macOS** (Raycast is Mac-only).
2.  **Keenetic** router with [Entware](https://github.com/Entware/Entware) installed.
3.  Installed **xkeen** package (original or forks like jameszeroX).

#### ⚙️ Installation & Setup

##### Step 1. Install the extension
1.  Clone the repository and install dependencies:
    ```bash
    npm install
    ```
2.  Add to Raycast:
    ```bash
    npm run dev
    ```

##### Step 2. Configure SSH Connection (The Magic!)
To make the extension work instantly without asking for a password every 5 seconds:

1.  Find the **Setup SSH Connection** command in Raycast (included in the package).
2.  Press Enter. A terminal will open.
3.  Enter your router IP (usually `192.168.1.1`) and admin password.
4.  The wizard will automatically:
    *   Generate SSH keys.
    *   Upload them to the router.
    *   Configure `~/.ssh/config` with `ControlMaster` optimization (10x faster + ban protection).

**What the wizard does locally:** if `~/.ssh/id_ed25519` doesn't exist, it generates a new Ed25519 key **without a passphrase** (so Raycast can connect without prompting), copies the public key to the router via `ssh-copy-id`, and appends a `Host` block to `~/.ssh/config` with `ControlMaster` settings. Nothing else on your Mac is modified.

##### Step 3. Finalize
1.  Launch **XKeen Manager**.
2.  On first run, configure settings (unless you changed them in the wizard):
    *   **SSH Connection:** `xkeen` (or your custom alias).
    *   **Paths:** Keep defaults if you have standard Entware (`/opt/etc/xray...`).

---

#### 📖 Working with Profiles

1.  Go to **Switch Profiles**.
2.  Press **Create** and enter a name (e.g., `germany`).
    *   The extension creates a copy of the current server, saves it as profile `germany`, and immediately switches to it.
3.  Now go to the main menu → **Outbounds**.
4.  Paste your German server's VLESS config and press **Save**.
5.  Done! The config is now bound to the `germany` profile.

To revert to your previous server, just select it from the profiles list and press Enter.

#### 🤝 Troubleshooting

*   **Status: Command failed / Connection reset:**
    The router temporarily blocked you for frequent requests.
    1. Reboot the router.
    2. Be sure to complete **Step 2 (Setup SSH Connection)** to enable connection optimization.
*   **IP Error:**
    Make sure the `2ip.io` site is added to Xkeen routing as a proxied domain.

---

#### 📄 License

MIT