[oddessentials]

Important

Requires Agent Guild 1.5.0 or newer, which oddessentials/agent-guild#298 releases. Release order:

1. merge and publish Agent Guild 1.5.0;
2. check that the published 1.5.0 has the compact page;
3. then merge this.

With an older Agent Guild the view only shows "The Yard here needs Agent Guild 1.5.0 or newer". This was checked against the published 1.4.0.

Part of #6, which stays open until the whole integration is released and checked.

The view

• Agent Guild in the Explorer, collapsed until opened, so nothing loads at startup. It can be dragged to the bottom panel.
• It shows only the Yard scene, in the tab's last skin and theme, which are stored in globalState.
• No retainContextWhenHidden: a hidden view keeps nothing and draws nothing, and loads once when it shows again.
• Double-clicking a character opens the tab, or brings it forward, and opens that session's terminal once. That holds whether the tab was closed, hidden, in front or still connecting.
• Without a running Agent Guild, or with one that is too old, the view says so and offers Open Agent Guild.

When Agent Guild is gone before a page loads

• When a frame finishes loading, the view and the tab run the existing health() check. There is no new timeout or polling.
• View: if the check fails, it shows "Agent Guild stopped responding" with Retry and Open Agent Guild.
  • Only the page's own ready message counts as loaded.
  • A page that never sent ready loads again when the view shows or the tab reconnects.
  • A check that answers after a newer page loaded, or after the view was disposed, changes nothing.
• Tab: reconnects through its existing refresh and loads its page once.
• Known limit: if the manager comes back between a failed frame and its check, the error page stays until the next event (showing the view, or the tab reconnecting).

Store listing

• The README leads with running the coding agents (with the Claude Code and Codex CLI rate-limit meters), then the Yard, the view beside your code and the tab.
• A table compares what each tool gets, and every claim was checked against Agent Guild 1.5.0's code.
• media/view.png shows the view in real VS Code with demo sessions, captioned as such.
• Adds a commands table, a version table, troubleshooting, privacy and trademark notes, and the keywords companion and sidebar (29 of 30).

Tests

• Unit: 7 pass.

• e2e in real VS Code against a manager running from feat: VS Code can show the Yard in a small view beside the code, and open a double-clicked session in its tab agent-guild#298, twice:

  • normal start;
  • a session opened from the view with the tab closed, hidden or in front;
  • hiding and re-showing the view;
  • a manager gone before the view's page loaded, then Retry;
  • late checks after a newer page or a disposed view;
  • the same failure for the tab;
  • a real manager restart.

  Neither page loaded more than once after any step.

• CI's e2e installs MIN_VERSION (1.2.0), so in CI it checks the "needs 1.5.0" view.

🤖 Generated with Claude Code