parse-git-status

Parse git status output into a structured JSON object.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/ronmikailov/site-360 --skill parse-git-status-ronmikailov
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: parse-git-status
Source: https://github.com/ronmikailov/site-360/tree/main/.claude/skills/parse-git-status
Command: npx skills add https://github.com/ronmikailov/site-360 --skill parse-git-status-ronmikailov

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Parse git status output into structured data that can be consumed by automation and analytics tools, enabling programmatic insights into repository state.

Core Features & Use Cases

  • Parse branch information (current branch, tracking, ahead/behind)
  • Categorize files by status (staged, modified, deleted, renamed, untracked, ignored)
  • Return a unified JSON object with fields: branch, tracking, ahead, behind, staged, modified, deleted, renamed, untracked, clean
  • Handle edge cases such as detached HEAD and empty input for robust validation

Quick Start

Provide the raw git status output and receive a structured JSON summary including branch, tracking, status lists, and clean flag.

Frequently Asked Questions about parse-git-status

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

FAQPage Schema
How do I parse git status output into JSON for automation workflows?

To parse git status output into JSON, provide the raw git status output to the parser. It returns a structured JSON object containing branch, tracking, ahead, behind, staged, modified, deleted, renamed, untracked, and clean fields for programmatic analysis.

Can I use git status JSON parsing for pre-flight checks before committing?

Yes, you can use git status JSON parsing for pre-flight checks before commits. The parser identifies a clean working directory state and categorizes staged, modified, deleted, and untracked files, enabling automated validation of repository conditions prior to executing workflows.

What is the best way to list changed files in git status programmatically?

The best way to list changed files programmatically is parsing git status into JSON. The parser categorizes file status indicators including M, A, D, R, ??, and !! into structured arrays for staged, modified, deleted, renamed, and untracked files.

Does git status JSON parsing support detached HEAD and empty input edge cases?

Git status JSON parsing supports detached HEAD and empty input edge cases for robust validation. The parser handles these conditions gracefully, ensuring your automation workflows receive consistent JSON output even when repository state is detached or blank.

How does parsing git status into structured data handle branch tracking and ahead/behind counts?

Parsing git status into structured data extracts branch tracking information and ahead/behind commit counts. The parser reads the raw git status output and populates the branch, tracking, ahead, and behind fields in the resulting JSON object for analytics.

What do I need to parse git status output into a structured JSON representation?

To parse git status output into a structured JSON representation, you only need the raw text output from a git status command. The parser requires no dependencies or components, processing the provided text to return the unified JSON summary.