heartbeat

Collect project signals and dispatch findings through the Servo oracle-gated loop.

Updated May 16, 2026
One-click install
npx skills add https://github.com/ramboz/servo --skill heartbeat-ramboz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: heartbeat
Source: https://github.com/ramboz/servo/tree/main/hosts/codex/plugins/servo/skills/heartbeat
Command: npx skills add https://github.com/ramboz/servo --skill heartbeat-ramboz

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps manage project signals and automate the heartbeat process in Servo, ensuring continuous monitoring and proactive management of project health.

Core Features & Use Cases

  • Signal Collection: Gather project signals like CI failures, open issues, and recent commits.
  • Read-only Discovery: Perform read-only signal collection without modifying source code or triggering changes.
  • Dispatch Findings: Dispatch actionable findings through the Servo oracle-gated loop for further processing.
  • Scheduled Execution: Optionally set up scheduled heartbeats to run at regular intervals.
  • Use Case: Imagine you have a large project with multiple CI pipelines, issues, and commits. Use this Skill to set up a scheduled heartbeat that regularly checks for failures, issues, and recent commits, and dispatches actionable findings for further investigation.

Quick Start

Set up a scheduled heartbeat for the project using the following command:

python3 "/path/to/servo/plugins/servo/skills/heartbeat/heartbeat.py" run /path/to/repo --cost-ceiling 2.00 --max-candidates 3 --max-iterations 5

Frequently Asked Questions about heartbeat

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

FAQPage Schema
How do I automate CI monitoring and issue tracking for my repository?

This Skill automates signal collection by gathering CI failures, open issues, and recent commits from your repository. It performs read-only discovery to monitor project health without modifying source code, then dispatches findings through the Servo oracle-gated loop.

How do I set up a scheduled heartbeat to check for CI failures and open issues?

Run the heartbeat.py script using Python 3, passing your repository path alongside parameters like --cost-ceiling, --max-candidates, and --max-iterations. This schedules regular signal collection to monitor project health and dispatch findings.

Do I need Python 3 and GitHub credentials to run project health monitoring?

Yes, this Skill requires Python 3, the Servo framework, and relevant GitHub credentials to access repository data. Ensure these dependencies are configured in your environment before executing the heartbeat script for project monitoring.

Can I perform read-only signal collection without triggering changes to my source code?

Yes, the Skill performs read-only signal collection to gather CI failures, open issues, and recent commits without modifying source code or triggering changes. This allows safe, continuous monitoring of project health during scheduled heartbeats.

What are the limitations of using an automated heartbeat for continuous project monitoring?

Limitations include execution constraints defined by --cost-ceiling, --max-candidates, and --max-iterations parameters. Additionally, the Skill requires Python 3, Servo, and GitHub credentials, restricting usage to compatible environments with proper access configured.