health

Diagnose service health and inspect agent runs via Solstone CLI commands.

2|2|Updated Jun 4, 2026
One-click install
npx skills add https://github.com/solpbc/solstone --skill health-solpbc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: health
Source: https://github.com/solpbc/solstone/tree/main/apps/health/muse/health
Command: npx skills add https://github.com/solpbc/solstone --skill health-solpbc

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides essential tools for monitoring the operational status of services and inspecting the execution of AI agents within the Solstone system, ensuring smooth operation and aiding in debugging.

Core Features & Use Cases

  • Service Status Check: Quickly ascertain if all background services are running and healthy.
  • Log Inspection: Review recent service logs or follow them in real-time for immediate issue detection.
  • Agent Run Analysis: Examine past agent executions, filter by status or schedule, and drill down into specific run details and events.
  • Journal Navigation: Understand the file structure for logs, agent outputs, and data files.
  • Use Case: If a Solstone feature is not working, use sol health to check if the relevant service is running, then sol health logs --service <service_name> to see if there are any errors, and finally sol muse logs --errors to check if any agents failed recently.

Quick Start

Check the current status of all Solstone services.

Frequently Asked Questions about health

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

FAQPage Schema
How do I check Solstone service status and diagnose background service health?

To check Solstone service health, run the `sol health` CLI command to ascertain if all background services are running. This quickly diagnoses operational issues within the Solstone system.

How do I inspect agent logs and filter past agent runs for errors?

To inspect agent logs and filter past agent runs for errors, use the `sol muse logs --errors` CLI command. This examines past agent executions, filters by schedule, and drills down into specific run details and events.

How do I view real-time service logs for immediate issue detection in Solstone?

To view real-time service logs for immediate issue detection in Solstone, use the `sol health logs --service <service_name>` command. This allows you to review recent service logs or follow them live to identify runtime errors.

What is the journal layout structure for navigating Solstone agent outputs and data files?

The journal layout structure for navigating Solstone agent outputs organizes logs, agent outputs, and data files at journal, day, and segment levels. This file structure reference helps you locate and inspect specific execution data.

Do I need access to the Solstone journal path to diagnose service health and inspect agent runs?

Yes, you need access to the Solstone journal path and its associated log files and sockets to diagnose service health and inspect agent runs. This access is required to navigate the file structure and execute `sol health` and `sol muse` commands.