Skip to content

Agent-ready setup page on GitHub Pages - #11

Merged
oddessentials merged 1 commit into
mainfrom
feat/agent-docs-page
Nov 9, 2026
Merged

oddessentials merged 1 commit into
mainfrom
feat/agent-docs-page

Conversation

@oddessentials

Copy link
Copy Markdown
Owner

Closes #10.

One page an agent can follow to download, install, connect and check Builders: https://oddessentials.github.io/agent-guild-builders/ (live after merge).

  • site/index.md is the source. tools/make_site.py builds index.html, index.md and llms.txt from it.
  • .github/workflows/pages.yml installs Builders by running the page's install block, runs the MCP smoke test on it, then deploys. It runs on changes to the page and again after every release.
  • tests/site_commands.gd fails if the page's connect commands differ from the Connect dialog's.
  • ci.yml skips docs-only pushes to main, so merging this doesn't publish a release. A change to ci.yml alone also won't release on merge; it still builds on its PR.
  • README: a "For agents" link under the install button.

Checked locally against Build 19 in Windows PowerShell 5.1 and PowerShell 7: install and reinstall, and connect for Claude Code, Codex, Antigravity and Grok, including a folder name with ', $, &, %, spaces and [ ]. Claude Code reports Connected and Grok reports 1 healthy with 16 tools.

🤖 Generated with Claude Code

One page an agent can follow to download, install, connect and check
Builders, published as HTML, Markdown and llms.txt. The Pages workflow
installs Builders by following the page before each deploy, and again
after every release. The page's connect commands are tested against the
Connect dialog's. Docs-only pushes to main no longer build a release.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@oddessentials
oddessentials merged commit c2ada4a into main Nov 9, 2026
4 checks passed
@oddessentials
oddessentials deleted the feat/agent-docs-page branch November 9, 2026 15:22
oddessentials added a commit that referenced this pull request Nov 10, 2026
* Run Builders on a Mac (#7)

A native macOS build alongside the Windows one, plus two fixes the Mac
testing turned up.

- MCP replies are flushed as they're printed. Release builds buffer piped
  stdout on macOS, so an agent never heard back until it disconnected.
- Exporting without replacing no longer goes through a shell. OS.execute
  runs its command through one on macOS, so a folder name containing
  $(...) ran as a command. ln is now started directly, and hostile names
  and eight racing publishes are tested.
- Cmd shortcuts on a Mac (undo, redo, save), and Mac wording: Trash,
  Show in Finder, Terminal, and connect commands quoted for zsh.
- A macOS export preset (universal, ETC2/ASTC textures for Apple Silicon).
  tools/package.ps1 (was package_windows.ps1) takes -Platform macOS: kits
  go in Contents/Resources, the app is ad-hoc signed again and zipped
  with ditto.
- CI builds, tests, packages and smoke-tests the Mac app on macos-latest,
  and releases attach AgentGuildBuilders-macos.zip.
- The README and the agent page cover installing on a Mac and opening an
  unsigned app the first time.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Track the uid for tests/site_commands.gd

Every other test script's uid is tracked; this one was missed in #10/#11.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
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.

Agent-ready docs page on GitHub Pages: download, install and run Builders

1 participant