monitoring

Monitor sgai workspaces and agent activity via HTTP and SSE endpoints.

130|8|Updated Jan 23, 2026
One-click install
npx skills add https://github.com/sandgardenhq/sgai --skill monitoring-sandgardenhq
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: monitoring
Source: https://github.com/sandgardenhq/sgai/tree/main/docs/sgai-skills/monitoring
Command: npx skills add https://github.com/sandgardenhq/sgai --skill monitoring-sandgardenhq

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It enables users to observe sgai agents, monitor workspace status, and track progress without manual log inspection.

Core Features & Use Cases

  • Retrieve full factory state for all workspaces.
  • Get a single workspace’s status, code diff, and workflow diagram.
  • Subscribe to real‑time Server‑Sent Events for instant updates.
  • Inspect agent sequences, todos, commits, and fork information for debugging or reporting.

Quick Start

Ask the monitoring skill to display the current state of the workspace named "my-project".

Frequently Asked Questions about monitoring

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I monitor sgai workspace progress in real time?

To monitor sgai workspace progress in real time, you need a running sgai server exposing the /api/v1/* HTTP endpoints and SSE support to fetch workspace diffs and receive instant updates.

Can I get code diffs and workflow diagrams for a specific sgai workspace?

Yes, you can get a single workspace's status, code diff, and workflow diagram by requesting the factory state and inspecting agent sequences, todos, commits, and fork information through the sgai API.

How do Server-Sent Events work for tracking agent activity?

Server-Sent Events provide real-time notifications for any running sgai project by subscribing to SSE endpoints, allowing you to track agent activity and workspace changes instantly without manual log inspection.

Do I need a running sgai server to fetch factory state and agent sequences?

Yes, fetching full factory state, agent sequences, todos, and commits requires a running sgai server exposing the /api/v1/* HTTP endpoints and SSE support for real-time monitoring capabilities.

What's the best way to debug agent workflows without manual log inspection?

The best way to debug agent workflows without manual log inspection is to retrieve full factory state, inspect agent sequences and commits, and subscribe to SSE notifications for real-time workspace updates.

Why does workspace monitoring fail to return real-time updates?

Workspace monitoring fails to return real-time updates when the sgai server is not running or does not properly expose the /api/v1/* HTTP endpoints and SSE support required for streaming notifications.