feat(zcode-wakatime): add WakaTime plugin for AI coding time tracking

marketplace.json

@@ -443,6 +443,21 @@
         "ci-cd",
         "gitlab-api"
       ]
+    },
+    {
+      "name": "zcode-wakatime",
+      "source": "./plugins/zcode-wakatime",
+      "description": "WakaTime plugin for ZCode. Installs wakatime-cli, then syncs AI heartbeats after user prompts and file-edit tool events.",
+      "description_i18n": {
+        "en": "WakaTime plugin for ZCode. Installs wakatime-cli, then syncs AI heartbeats after user prompts and file-edit tool events.",
+        "zh-CN": "ZCode 的 WakaTime 插件：自动安装 wakatime-cli，并在用户提交与文件编辑后同步 AI 编程心跳。"
+      },
+      "version": "0.2.0",
+      "author": {
+        "name": "RoiexLee",
+        "url": "https://github.com/RoiexLee"
+      },
+      "category": "developer-tools"
     }
   ]
 }

plugins/zcode-wakatime/.zcode-plugin/plugin.json

@@ -0,0 +1,19 @@
+{
+  "name": "zcode-wakatime",
+  "version": "0.2.0",
+  "description": "WakaTime plugin for ZCode. Installs wakatime-cli, then syncs AI heartbeats after user prompts and file-edit tool events.",
+  "description_i18n": {
+    "en": "WakaTime plugin for ZCode. Installs wakatime-cli, then syncs AI heartbeats after user prompts and file-edit tool events.",
+    "zh-CN": "ZCode 的 WakaTime 插件：自动安装 wakatime-cli，并在用户提交与文件编辑后同步 AI 编程心跳。"
+  },
+  "author": {
+    "name": "RoiexLee",
+    "url": "https://github.com/RoiexLee"
+  },
+  "keywords": [
+    "zcode",
+    "wakatime",
+    "time-tracking",
+    "ai"
+  ]
+}

plugins/zcode-wakatime/LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, WakaTime
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its contributors
+   may be used to endorse or promote products derived from this software
+   without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

plugins/zcode-wakatime/README.md

@@ -0,0 +1,35 @@
+# zcode-wakatime
+
+[WakaTime][wakatime] plugin for [ZCode][zcode].
+
+The plugin installs [wakatime-cli][wakatime-cli] into `~/.wakatime/`, checks for wakatime-cli updates on session start, and syncs AI heartbeats after user prompts and file-edit tool events.
+
+Derived from [wakatime/codex-cli-wakatime][wakatime/codex-cli-wakatime], adapted for ZCode.
+
+## Install
+
+In ZCode: **Settings → Plugins → Create → Add marketplace** → add `RoiexLee/zcode-wakatime` → install **zcode-wakatime**.
+
+## Configuration
+
+The plugin reads standard WakaTime settings from `~/.wakatime.cfg`.
+
+Useful settings:
+
+```ini
+[settings]
+api_key = XXXX
+debug = true ; verbose plugin logging to ~/.wakatime/zcode.log
+proxy = https://127.0.0.1:8080 ; optional, used for wakatime-cli downloads
+```
+
+Logs are written to `~/.wakatime/zcode.log`.
+
+## License
+
+[BSD-3-Clause](LICENSE)
+
+[wakatime]: https://wakatime.com
+[zcode]: https://zcode.z.ai
+[wakatime-cli]: https://github.com/wakatime/wakatime-cli
+[wakatime/codex-cli-wakatime]: https://github.com/wakatime/codex-cli-wakatime

plugins/zcode-wakatime/README_CN.md

@@ -0,0 +1,35 @@
+# zcode-wakatime
+
+[ZCode][zcode] 的 [WakaTime][wakatime] 插件。
+
+将 [wakatime-cli][wakatime-cli] 安装到 `~/.wakatime/`，在会话启动时检查 wakatime-cli 更新，并在用户提交与文件编辑事件后同步 AI 编程心跳。
+
+派生自 [wakatime/codex-cli-wakatime][wakatime/codex-cli-wakatime]，已适配 ZCode。
+
+## 安装
+
+在 ZCode 中：**Settings → Plugins → Create → Add marketplace** → 添加 `RoiexLee/zcode-wakatime` → 安装 **zcode-wakatime**。
+
+## 配置
+
+插件读取 `~/.wakatime.cfg` 中的标准 WakaTime 配置。
+
+常用配置：
+
+```ini
+[settings]
+api_key = XXXX
+debug = true ; 详细插件日志写入 ~/.wakatime/zcode.log
+proxy = https://127.0.0.1:8080 ; 可选，用于下载 wakatime-cli
+```
+
+日志写入 `~/.wakatime/zcode.log`。
+
+## 许可
+
+[BSD-3-Clause](LICENSE)
+
+[wakatime]: https://wakatime.com
+[zcode]: https://zcode.z.ai
+[wakatime-cli]: https://github.com/wakatime/wakatime-cli
+[wakatime/codex-cli-wakatime]: https://github.com/wakatime/codex-cli-wakatime