JoinGrove

Agent Workflow — Git, Checkpoints, and Chat

Source: docs/reference/agent-workflow.md
Generated: 01/09/2026

JoinGrove agents edit real files in your workspace. Use Git and review habits as your checkpoint system — especially on campus shared machines.

Key Concepts

  • No cloud checkpoint engine: JoinGrove does not ship Cursor-style automatic snapshots before every agent edit. Your safety net is Git (commits, branches, stash) plus the Source Control diff review UI.
  • Enter vs Shift+Enter: In Agents chat, Enter sends immediately; Shift+Enter inserts a newline without sending.
  • Slash shortcuts: Type /studio, /campus, /hub, /offline, /trust, /share in chat to run JoinGrove commands without the Command Palette.
  • Campus labs: Review agent diffs before accept; use zero egress on shared VMs; distribute tutorials via WhatsApp/USB.

API / Reference

Chat input behavior

Input Action
Enter Send message immediately
Shift+Enter New line in the input (no send)
Cmd/Ctrl+Enter Used in some feedback editors — not the main Agents input

Slash commands

Slash Command ID Purpose
/studio joingrove.studioBuildFromPrompt Build from idea
/campus joingrove.campusOnboardingWizard Campus onboarding
/pricing joingrove.showPricing PPP pricing by region
/offline joingrove.setupOfflineAi Connect Ollama
/egress joingrove.offlineModeStatus Egress status
/hub joingrove.globalSouthHub Global South hub page
/docs joingrove.openDocsTopic Browse documentation topics
/topics joingrove.openDocsTopic Browse topics (alias)
/matrix joingrove.openCapabilitiesMatrixDocs Capabilities matrix (migration)
/trust joingrove.openTelemetryDashboard Trust dashboard
/share joingrove.shareWithCohort Cohort distribution (WhatsApp/Telegram)
/security joingrove.securityModeWizard Network security mode

Git checkpoint workflow (recommended)

Step Action
1 git status — see what the agent changed
2 Review diffs in Source Control before accepting large edits
3 git stash push -m "before-agent" before risky agent runs
4 git checkout -b agent/feature-name for experimental work
5 Commit when satisfied — that commit is your rollback point

Setup & Installation

  1. Open Agents window (default in JoinGrove).
  2. Read the first-run tip or open this guide: joingrove.openAgentWorkflowDocs.
  3. Before a big agent task on a campus VM: git stash or create a branch.
  4. For offline cohorts: share campus-first-project.md and enable zero egress.

Code Examples

Create a safety branch before agent scaffolding:

git checkout -b campus/agent-sokomart

Next: Run your Studio or agent build flow, then review diffs.

Stash uncommitted work before a large agent run:

git stash push -m "pre-agent"

Next: After the agent finishes, git stash pop only if you want those changes back.

Open the Global South hub from chat:

/hub

Next: Use Share with cohort for WhatsApp/Telegram tutorial packs.

How It Connects

  • Global South hub: joingrove.globalSouthHub — pricing, tutorials, trust, share cards
  • Studio flow: joingrove.studioBuildFromPrompt — idea → preview
  • Campus tutorial: resources/global-south/tutorials/campus-first-project.md
  • Share offline: resources/global-south/tutorials/share-whatsapp.md
  • Security modes: joingrove.securityModeWizard
  • Reference: docs/reference/commands.md, docs/reference/egress.md