phone-status

Collect phone battery, charging, uptime, load, and storage metrics over SSH into JSON.

3|Updated Jul 17, 2024
One-click install
npx skills add https://github.com/Castrozan/.dotfiles --skill phone-status
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: phone-status
Source: https://github.com/Castrozan/.dotfiles/tree/main/agents/skills/phone-status
Command: npx skills add https://github.com/Castrozan/.dotfiles --skill phone-status

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ssh, and includes scripts (resource) components.

What problem does it solve?

This Skill makes it easy to monitor the health of a phone over SSH by collecting battery, charging state, uptime, load, and storage, then returning a structured JSON summary.

Core Features & Use Cases

  • Remote health checks: query battery, charging status, uptime, CPU load, and storage on a target phone.
  • JSON output for straightforward ingestion into dashboards and automation.
  • Use Case: IT admins can monitor a fleet of devices over SSH/Tailscale and trigger alerts when metrics cross predefined thresholds.

Quick Start

Run the phone-status script to fetch the current device metrics: scripts/phone-status.sh

Frequently Asked Questions about phone-status

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

FAQPage Schema
How do I monitor phone battery and storage remotely over SSH?

You can monitor phone health over SSH by running a script that queries battery, charging status, uptime, load, and storage metrics. The tool returns a structured JSON summary, making it easy to ingest the data into dashboards or automated alerting systems.

How do I check CPU load and uptime on a remote phone for incident response?

You can check CPU load and uptime for incident response by running the phone-status script over SSH. It queries the target device and aggregates the health metrics into a single structured JSON report for quick diagnostics.

Do I need a dedicated SSH key and Tailscale to monitor phone health metrics?

Yes, monitoring phone health metrics requires an SSH client, Tailscale network access to reach the host named phone, and a dedicated SSH key located at /run/agenix/id_ed25519_phone to authenticate the remote connection.

Can I use this remote phone monitoring tool for IT fleet management?

Yes, this remote phone monitoring tool supports IT admin workflows for fleet management. It performs periodic status collection across multiple devices over SSH and Tailscale, returning JSON data to trigger alerts when metrics cross predefined thresholds.

What is the best way to automate remote phone health checks and return JSON?

The best way to automate remote phone health checks is running the phone-status shell script. It fetches current device metrics over SSH and outputs structured JSON, enabling seamless integration into automated IT admin workflows and dashboards.