Files
bot/docs/platforms/mac/skills.md
zeekayandHanzo Dev 84e4069c2c docs name the state dir and config file the bot reads: ~/.bot/bot.json
The docs said ~/.hanzo-bot/hanzo-bot.json (and ~/.hanzo-bot-<profile>, hanzo-bot.plugin.json), which nothing reads: src/config/paths.ts resolves ~/.bot, bot.json and ~/.bot-<profile>, and plugins ship bot.plugin.json. Every such path in docs/ now names what the code opens.

Co-authored-by: Hanzo Dev <[email protected]>
2026-09-24 21:12:09 -07:00

1.1 KiB

summary, read_when, title
summary read_when title
macOS Skills settings UI and gateway-backed status
Updating the macOS Skills settings UI
Changing skills gating or install behavior
Skills

Skills (macOS)

The macOS app surfaces HanzoBot skills via the gateway; it does not parse skills locally.

Data source

  • skills.status (gateway) returns all skills plus eligibility and missing requirements (including allowlist blocks for bundled skills).
  • Requirements are derived from metadata.hanzo-bot.requires in each SKILL.md.

Install actions

  • metadata.hanzo-bot.install defines install options (brew/node/go/uv).
  • The app calls skills.install to run installers on the gateway host.
  • The gateway surfaces only one preferred installer when multiple are provided (brew when available, otherwise node manager from skills.install, default npm).

Env/API keys

  • The app stores keys in ~/.bot/bot.json under skills.entries.<skillKey>.
  • skills.update patches enabled, apiKey, and env.

Remote mode

  • Install + config updates happen on the gateway host (not the local Mac).