---
name: pass_list
kind: function
lang: bash
domain: infra
version: "1.0.0"
purity: impure
signature: "pass_list([prefix: string]) -> json"
description: "Lista entradas del password store como JSON array. Filtra opcionalmente por prefijo."
tags: [pass, secret, credential, list]
uses_functions: []
uses_types: []
returns: []
returns_optional: false
error_type: "error_go_core"
imports: []
params:
  - name: prefix
    desc: "prefijo para filtrar entradas (opcional; ej: agentes)"
output: "JSON array de nombres de entradas"
tested: true
tests: ["lista todas las entradas", "filtra por prefijo"]
test_file_path: "bash/functions/infra/pass_test.sh"
file_path: "bash/functions/infra/pass_list.sh"
---

## Ejemplo

```bash
source pass_list.sh
entries=$(pass_list agentes)
# ["dataforge-token","egutierrez-token","gitea-url"]
```

## Notas

Parsea el output tree de `pass ls` y lo convierte a JSON array. Cada entrada es un string con el nombre relativo al prefijo.