@foxden-app/foxclaw 0.3.0 → 0.3.1

package/README.md

@@ -139,6 +139,14 @@ systemctl --user status foxclaw.service
 journalctl --user -u foxclaw.service -f
 ```
 
+也可以直接用包装命令：
+
+```bash
+foxclaw status
+foxclaw restart
+foxclaw stop
+```
+
 需要前台调试时：
 
 ```bash
@@ -292,6 +300,8 @@ foxclaw weixin-login
 foxclaw doctor
 foxclaw status
 foxclaw start
+foxclaw restart
+foxclaw stop
 foxclaw uninstall-systemd
 ```
 

package/README_EN.md

@@ -139,6 +139,14 @@ systemctl --user status foxclaw.service
 journalctl --user -u foxclaw.service -f
 ```
 
+You can also use the wrapper commands:
+
+```bash
+foxclaw status
+foxclaw restart
+foxclaw stop
+```
+
 For foreground debugging:
 
 ```bash
@@ -292,6 +300,8 @@ See [Troubleshooting](./docs/troubleshooting.md) for `doctor` failures, Telegram
 foxclaw doctor
 foxclaw status
 foxclaw start
+foxclaw restart
+foxclaw stop
 foxclaw uninstall-systemd
 ```
 

package/dist/main.js

@@ -23,7 +23,16 @@ async function main() {
     }
     if (command === 'start') {
         requireNode24(command);
-        startService();
+        startService('start');
+        return;
+    }
+    if (command === 'restart') {
+        requireNode24(command);
+        startService('restart');
+        return;
+    }
+    if (command === 'stop') {
+        stopService();
         return;
     }
     if (command === 'uninstall-systemd') {
@@ -146,10 +155,10 @@ function initConfig() {
     console.log(`Created ${envPath}`);
     console.log('Edit it, then run: foxclaw doctor');
 }
-function startService() {
+function startService(action) {
     if (!runDoctorChecks()) {
         console.error('');
-        console.error('Fix the failed checks above, then run: foxclaw start');
+        console.error(`Fix the failed checks above, then run: foxclaw ${action}`);
         process.exit(1);
     }
     if (process.platform === 'darwin') {
@@ -158,6 +167,13 @@ function startService() {
     }
     installSystemd();
 }
+function stopService() {
+    if (process.platform === 'darwin') {
+        stopLaunchd();
+        return;
+    }
+    stopSystemd();
+}
 function runDoctorChecks() {
     const configuredCodexBin = process.env.CODEX_CLI_BIN;
     const checks = [
@@ -263,6 +279,15 @@ function uninstallSystemd() {
     spawnChecked('systemctl', ['--user', 'daemon-reload']);
     console.log(`Removed ${unitPath}`);
 }
+function stopSystemd() {
+    if (!hasCommand('systemctl')) {
+        console.error('systemctl not found');
+        process.exit(1);
+    }
+    const unitName = 'foxclaw.service';
+    spawnChecked('systemctl', ['--user', 'stop', unitName]);
+    console.log(`Stopped ${unitName}`);
+}
 function installLaunchd() {
     if (process.platform !== 'darwin') {
         console.error('launchd install is only available on macOS');
@@ -320,6 +345,19 @@ ${foxclawEnvXml}
     spawnChecked('launchctl', ['load', plist]);
     console.log(`Installed ${plist}`);
 }
+function stopLaunchd() {
+    if (process.platform !== 'darwin') {
+        console.error('launchd stop is only available on macOS');
+        process.exit(1);
+    }
+    const plist = path.join(process.env.HOME || '', 'Library', 'LaunchAgents', 'app.foxden.foxclaw.plist');
+    if (!fs.existsSync(plist)) {
+        console.error(`launchd plist not found: ${plist}`);
+        process.exit(1);
+    }
+    spawnChecked('launchctl', ['unload', plist]);
+    console.log(`Stopped ${plist}`);
+}
 function buildServicePath(nodeDir) {
     const parts = [
         path.join(process.env.HOME || '', '.local', 'bin'),

package/docs/install-for-beginners.md

@@ -259,13 +259,13 @@ foxclaw status
 Restart Linux service after changing `.env`:
 
 ```bash
-foxclaw start
+foxclaw restart
 ```
 
-Stop Linux service:
+Stop the service:
 
 ```bash
-systemctl --user stop foxclaw.service
+foxclaw stop
 ```
 
 Uninstall Linux service:

package/docs/troubleshooting.md

@@ -93,7 +93,7 @@ Check these in order:
 5. Restart after changing `.env`:
 
    ```bash
-   foxclaw start
+   foxclaw restart
    ```
 
    If running foreground mode, stop with `Ctrl+C` and run `foxclaw serve` again.
@@ -145,7 +145,7 @@ systemctl --user disable --now telegram-codex-app-bridge.service
 Then restart FoxClaw:
 
 ```bash
-foxclaw start
+foxclaw restart
 ```
 
 ## Codex Or App-Server Fails

package/docs/user-manual.md

@@ -146,6 +146,7 @@ journalctl --user -u foxclaw.service -f
 On macOS, `foxclaw start` manages launchd. For foreground debugging, stop the background service and run:
 
 ```bash
+foxclaw stop
 foxclaw serve
 ```
 

package/docs/zh/install-for-beginners.md

@@ -257,13 +257,13 @@ foxclaw status
 修改 `.env` 后重启：
 
 ```bash
-foxclaw start
+foxclaw restart
 ```
 
-停止 Linux 服务：
+停止服务：
 
 ```bash
-systemctl --user stop foxclaw.service
+foxclaw stop
 ```
 
 卸载 Linux 服务：

package/docs/zh/troubleshooting.md

@@ -94,7 +94,7 @@ CODEX_CLI_BIN=/absolute/path/to/codex
 5. 修改 `.env` 后重启：
 
    ```bash
-   foxclaw start
+   foxclaw restart
    ```
 
    如果正在前台运行，先 `Ctrl+C` 停止，再重新运行 `foxclaw serve`。
@@ -146,7 +146,7 @@ systemctl --user disable --now telegram-codex-app-bridge.service
 然后重启 FoxClaw：
 
 ```bash
-foxclaw start
+foxclaw restart
 ```
 
 ## Codex 或 app-server 异常

package/docs/zh/user-manual.md

@@ -146,6 +146,7 @@ journalctl --user -u foxclaw.service -f
 macOS 上 `foxclaw start` 会管理 launchd。前台排障时，先停后台服务，再运行：
 
 ```bash
+foxclaw stop
 foxclaw serve
 ```
 

package/package.json

@@ -1,65 +1,67 @@
-{
-  "name": "@foxden-app/foxclaw",
-  "version": "0.3.0",
-  "description": "Foxden local execution claw for controlling Codex from trusted chat interfaces.",
-  "type": "module",
-  "main": "dist/main.js",
-  "bin": {
-    "foxclaw": "dist/main.js"
-  },
-  "files": [
-    "dist",
-    "docs",
-    "scripts",
-    "skills",
-    ".env.example",
-    "README.md",
-    "README_EN.md",
-    "LICENSE"
-  ],
-  "private": false,
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/foxden-app/foxclaw.git"
-  },
-  "homepage": "https://github.com/foxden-app/foxclaw#readme",
-  "bugs": {
-    "url": "https://github.com/foxden-app/foxclaw/issues"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "engines": {
-    "node": ">=24"
-  },
-  "scripts": {
-    "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
-    "build": "npm run clean && tsc -p tsconfig.build.json",
-    "dev": "tsx src/main.ts serve",
-    "serve": "node dist/main.js serve",
-    "start-service": "node dist/main.js start",
-    "weixin-login": "node dist/main.js weixin-login",
-    "status": "node dist/main.js status",
-    "doctor": "node dist/main.js doctor",
-    "init": "node dist/main.js init",
-    "install-systemd": "node dist/main.js install-systemd",
-    "uninstall-systemd": "node dist/main.js uninstall-systemd",
-    "install-launchd": "node dist/main.js install-launchd",
-    "typecheck": "tsc --noEmit",
-    "lint": "eslint .",
-    "test": "node --test --import tsx \"src/**/*.test.ts\"",
-    "prepack": "npm run build"
-  },
-  "dependencies": {
-    "dotenv": "^16.6.1",
-    "qrcode-terminal": "^0.12.0"
-  },
-  "devDependencies": {
-    "@eslint/js": "^9.39.0",
-    "@types/node": "^24.12.0",
-    "eslint": "^9.39.0",
-    "tsx": "^4.19.3",
-    "typescript": "5.9.3",
-    "typescript-eslint": "^8.58.0"
-  }
-}
+{
+  "name": "@foxden-app/foxclaw",
+  "version": "0.3.1",
+  "description": "Foxden local execution claw for controlling Codex from trusted chat interfaces.",
+  "type": "module",
+  "main": "dist/main.js",
+  "bin": {
+    "foxclaw": "dist/main.js"
+  },
+  "files": [
+    "dist",
+    "docs",
+    "scripts",
+    "skills",
+    ".env.example",
+    "README.md",
+    "README_EN.md",
+    "LICENSE"
+  ],
+  "private": false,
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/foxden-app/foxclaw.git"
+  },
+  "homepage": "https://github.com/foxden-app/foxclaw#readme",
+  "bugs": {
+    "url": "https://github.com/foxden-app/foxclaw/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "scripts": {
+    "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
+    "build": "npm run clean && tsc -p tsconfig.build.json",
+    "dev": "tsx src/main.ts serve",
+    "serve": "node dist/main.js serve",
+    "start-service": "node dist/main.js start",
+    "stop-service": "node dist/main.js stop",
+    "restart-service": "node dist/main.js restart",
+    "weixin-login": "node dist/main.js weixin-login",
+    "status": "node dist/main.js status",
+    "doctor": "node dist/main.js doctor",
+    "init": "node dist/main.js init",
+    "install-systemd": "node dist/main.js install-systemd",
+    "uninstall-systemd": "node dist/main.js uninstall-systemd",
+    "install-launchd": "node dist/main.js install-launchd",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "test": "node --test --import tsx \"src/**/*.test.ts\"",
+    "prepack": "npm run build"
+  },
+  "dependencies": {
+    "dotenv": "^16.6.1",
+    "qrcode-terminal": "^0.12.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.0",
+    "@types/node": "^24.12.0",
+    "eslint": "^9.39.0",
+    "tsx": "^4.19.3",
+    "typescript": "5.9.3",
+    "typescript-eslint": "^8.58.0"
+  }
+}