Skip to content

feat(orbtile-start): add Orbtile setup check skill - #198

Open
diogomendes-cmyk wants to merge 2 commits into
zai-org:mainfrom
Orbtile:feat/orbtile-start
Open

diogomendes-cmyk wants to merge 2 commits into
zai-org:mainfrom
Orbtile:feat/orbtile-start

Conversation

@diogomendes-cmyk

@diogomendes-cmyk diogomendes-cmyk commented Nov 17, 2026 •

Copy link
Copy Markdown

Plugin type (required) / 插件类型(必填)

  • UI Plugin / 是 UI 插件
  • Standard plugin / 普通插件(非 UI) — does not provide MCP Apps interactive pages / 不提供 MCP Apps 交互页面
  • Not applicable / 不适用

Affected plugin name(s) / 涉及的插件名称:orbtile-start (Standard plugin)

What / 改动内容

Adds external_plugins/orbtile-start, a small read-only setup check for Orbtile, a macOS and Windows app that shows the live state of coding agents on a keypad. Orbtile follows ZCode tasks from their files, with one optional approval hook.

  • User problem: "Is Orbtile set up for ZCode, and why don't my ZCode tasks show in Orbtile?"
  • Visible behaviour: one skill, orbtile-status. When the user asks (for example "check my Orbtile setup"), it runs scripts/orbtile.sh zcode status (macOS and Linux) or scripts/orbtile.ps1 zcode status (Windows). It reports whether the Orbtile app is installed, whether Orbtile's ZCode approval hook is in ~/.zcode/cli/config.json, and whether the app is running (macOS), then gives one next step. On Linux it says Orbtile does not run there, with no download step.
  • Side effects / dependencies: no hooks, MCP servers, agents or commands. No network access. Writes no files and changes no settings. It reads ~/.zcode/cli/config.json and the usual app folders only. It needs sh (macOS/Linux) or PowerShell (Windows).
  • Version and registration: 0.1.5 in both .zcode-plugin/plugin.json and the new marketplace.json entry; category developer-tools.
  • Licensing and provenance: MIT. All code is written by Orbtile; no third-party code or assets. Source: https://github.com/Orbtile/orbtile-plugins/tree/main/zcode/orbtile-start (identical files).

How it was tested / 测试方式

  • python3 scripts/validate.py: OK: 56 plugin(s) validated. git diff --check: clean.
  • python3 scripts/build_dist.py: the full run stops on other plugins (photocraft needs the Rust 1.95 wasm32 toolchain for pnpm build). This plugin's artifact was built with the script's own build_zip and build_index_entry: plugins/orbtile-start/0.1.5/plugin.zip, 7 files, 8979 bytes.
  • ZCode CLI 0.16.9 (bundled with the macOS desktop app):
    • zcode plugins validate: "Plugin manifest is valid".
    • Local marketplace add, plugins install and plugins enable all work.
    • zcode skills list shows orbtile-start:orbtile-status.
  • The status script has 90 shell tests (macOS and Linux) and 27 PowerShell tests (Windows 11) in the source repo. They cover the hook markers written by the Orbtile app on macOS, Windows and remote Linux hosts, plus the no-app, app-only and Linux cases.
  • Not tested: a model reply in the ZCode desktop app. The bundled CLI's headless -p mode does not run outside the app on our test machine.

Self-check / 自查清单

  • Plugin name is unique kebab-case; new external plugin directory is external_plugins/orbtile-start/
  • Usage category is set (developer-tools)
  • Plugin type and affected names are declared above
  • version identical in plugin.json and marketplace.json (0.1.5, new plugin)
  • README.md (EN) and README_CN.md (中文) both present and equivalent
  • description_i18n has both en and zh-CN
  • No secrets, machine-specific paths, or private dependencies
  • Model/API/network dependencies documented (none)
  • python3 scripts/validate.py passes; build_dist.py for this plugin's artifact passes (full run needs the Rust wasm toolchain for other plugins, see above)

diogomendes-cmyk pushed a commit to Orbtile/orbtile-plugins that referenced this pull request Nov 17, 2026
@panda920

Copy link
Copy Markdown
Collaborator

✅ Internal validation passed. A ZCode maintainer will review the change next; after acceptance, release checks run separately and this PR is closed automatically.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants