---
name: set_exe_icon
lang: go
domain: infra
version: 0.1.0
description: "CLI Windows que embebe un .ico en un .exe (post-build) sin dependencias externas. Wrapper sobre la funcion set_exe_icon_go_infra del registry. Crea backup .bak antes de modificar."
tags: [windows, pe, exe, icon, cli]
uses_functions:
  - set_exe_icon_go_infra
uses_types: []
framework: ""
entry_point: "main.go"
dir_path: "apps/set_exe_icon"
---

## Build

```bash
# Linux nativo
go build -o set_exe_icon .

# Cross-compile a Windows
GOOS=windows GOARCH=amd64 CGO_ENABLED=0 go build -ldflags "-s -w" -o set_exe_icon.exe .
```

## Uso

```cmd
set_exe_icon.exe miapp.exe logo.ico
```

Crea `miapp.exe.bak` y sobrescribe `miapp.exe` con el icono embebido.

## Limitaciones

- No soporta .exe que ya tienen seccion `.rsrc` (devuelve error y restaura el backup).
- El checksum PE se pone a 0 (Windows lo ignora salvo para drivers/ntoskrnl).
- Authenticode signing queda invalidado tras la modificacion.


## Capability growth log

Una linea por bump SemVer. Bump-type segun `.claude/commands/version.md`:
- `major`: breaking observable (CLI args, schema BBDD propia, formato wire).
- `minor`: feature aditiva (nuevo panel, endpoint, opcion).
- `patch`: bugfix sin cambio observable.

- v0.1.0 (2026-05-18) — baseline.