# Gst

> Shows development status in the repository: branch, uncommitted changes, recent commits, diff vs main, hot files, semantic summary. Used when a developer writes "status", "gst", "git status", "what's going on", "repo state", "show changes".

- Skill: `yokeloop/gst` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add yokeloop/gst`
- Raw SKILL.md: https://api.skillmd.com/api/skills/yokeloop/gst/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: yokeloop (https://skillmd.com/u/yokeloop)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/yokeloop/gst

---


# Development status

Status orchestrator: collect repository state, format a report, write a short summary. Read-only, no agent.

## Step 1 — Collect

One call:

```bash
bash ${CLAUDE_PLUGIN_ROOT}/lib/gst-collect.sh
```

Parse the structured block. A top-level field is a line matching `^[A-Z_]+:` at column 0; its value is inline (`KEY: value`) or, for list fields (`CHANGED_FILES`, `HOT_FILES`, `COMMITS`, `STASH`, `CONFLICTS`), the indented lines that follow until the next top-level field. Each `COMMITS` line is `hash|subject|relative-time|author`.

## Step 2 — Format

Build the report from this template; skip every empty section:

```
Branch: <BRANCH> [ahead <AHEAD>, behind <BEHIND> <UPSTREAM>]

Changes: <SHORTSTAT>
   staged: <STAGED>  unstaged: <UNSTAGED>  untracked: <UNTRACKED>

Changed files (vs <DEFAULT_BRANCH>):
   <directory>/
     <status> <file> (+N -M)

Hot files:
   1. <path> — +N -M
   ...

Commits (from <DEFAULT_BRANCH>): +<COMMITS_COUNT> commits
   <hash> <subject> — <relative-time>
   ...

Stash: <STASH_COUNT> entries

Summary: <2-3 sentences>
```

Rules:

- Group `CHANGED_FILES` by directory, not alphabetically.
- Relative times come straight from the 3rd `COMMITS` field; never print absolute dates.
- Skip empty sections (no stash, no hot files, no changes → hide them).
- File status: `M` modified, `A` added, `D` deleted (renames appear as `D` + `A`).
- Plain text, no emoji.

## Step 3 — Summary

Write 2-3 sentences on the outcome ("added JWT-based authentication"), not the file list. Base them on `COMMITS` and `CHANGED_FILES`.

## Edge cases

Exclusive states — check in order, first match wins:

1. `EMPTY_REPO = true` → `New repository. Untracked files: <UNTRACKED>`. Nothing else to show.
2. `DETACHED = true` → header `Branch: detached at <BRANCH>`, then the rest of the report.
3. `CONFLICTS` non-empty → lead with `MERGE CONFLICTS:` and the file list, then the normal report.
4. `ON_DEFAULT_BRANCH = true` or `MERGE_BASE = NONE` → no diff vs default; show `Recent commits:` from `COMMITS`; skip "Changed files" and "Hot files".

Modifiers — apply independently:

- `HAS_UPSTREAM = false` → header `Branch: <BRANCH> (no upstream)`; omit ahead/behind.
- No changes (`STAGED`, `UNSTAGED`, `UNTRACKED` all 0) → skip Changes, Changed files, Hot files.

## Rules

- The script runs only read-only git commands.
- No agent — format inline in this turn.
- Limits: max 20 commits, max 50 file lines, max 10 stash entries.