JoinGrove

Agents Window

Source: docs/agent/agents-window.md
Generated: 01/09/2026

The Agents window is JoinGrove's default UI — multi-session agent orchestration instead of sidebar chat.

Key Concepts

  • What: The Agents window (sessions.html) hosts chat, agent mode, Studio preview shell, and slash commands in one workspace.
  • Why: Mobile-friendly, agent-first layout suits Chromebooks, phones, and cohort labs better than classic sidebar chat.
  • Related: Prompting (prompting.md), Studio wizard (studio-wizard.md), run modes (run-modes.md).

API / Reference

Behavior Detail
Default launch defaultWindow: "agents" in product.json
Dev command npm run dev
Browser equivalent npm run sessions-web (port 8081)
Classic fallback --classic or joingrove.openClassic
Open folder joingrove ./my-project pre-selects folder in Agents
Auto-classic routes Diff, merge, extension dev → classic workbench

Commands

Command ID
Focus chat input workbench.action.chat.focusInput
Open Studio home joingrove.openStudioHome
Open Studio shell (preview split) joingrove.openStudioShell
Global South hub joingrove.globalSouthHub
Agent workflow guide joingrove.openAgentWorkflowDocs

Setup & Installation

  1. npm run dev — Agents window opens automatically.
  2. Command Palette → Open JoinGrove Studio Home for Build / Classic / Docs entry cards.
  3. Use /studio, /docs, /hub slash commands in chat (see slash-commands.md).
  4. Switch to Classic anytime → joingrove.openClassic.

Code Examples

Launch agent-first:

npm run dev

Launch with project folder:

joingrove ./my-project

Browser Agents UI:

npm run sessions-web

Next: Read prompting.md for @ files, rules, and context.

How It Connects

  • README agent-first section: README.md
  • Slash commands: slash-commands.md
  • Studio home: resources/market/studio-home.json
  • In-app command: joingrove.openStudioHome