---
name: git_repo_status
kind: function
lang: bash
domain: shell
version: "1.0.0"
purity: impure
signature: "git_repo_status() -> void"
description: "Muestra el estado completo de un repositorio Git: rama actual, upstream (ahead/behind), cambios pendientes, stash, remotes y últimos 8 commits. Sale con exit code 1 si el directorio actual no es un repo Git."
tags: [bash, git, status, repo, branch, pendiente-usar]
uses_functions: []
uses_types: []
returns: []
returns_optional: false
error_type: "error_go_core"
imports: []
params:
  - name: "(ninguno)"
    desc: "opera sobre el directorio de trabajo actual (cwd)"
output: "imprime el estado completo del repo a stdout; exit code 1 si no es un repo Git"
tested: false
tests: []
test_file_path: ""
file_path: "bash/functions/shell/git_repo_status.sh"
source_repo: "https://gitea-dgg044oo04woo4ggcsws4gk0.organic-machine.com/egutierrez/DevLauncher.git"
source_license: "MIT"
source_file: "scripts/linux/git_utils/estado_repo.sh"
---

## Ejemplo

```bash
# Desde un directorio con repo git
cd /home/user/my-project
source bash/functions/shell/git_repo_status.sh
git_repo_status
```

## Notas

No requiere dependencias externas más allá de git. Los colores del log de commits usan `--color=always` de git directamente. No produce output en stdout en caso de error — los mensajes de error van a stderr.
