fn_registry/bash/functions/pipelines/init_cli_app.md

name, kind, lang, domain, version, purity, signature, description, tags, uses_functions, uses_types, returns, returns_optional, error_type, imports, params, output, tested, tests, test_file_path, example, file_path

name	kind	lang	domain	version	purity	signature	description	tags	uses_functions	uses_types	returns	returns_optional	error_type	imports	params	output	tested	tests	test_file_path	example	file_path
init_cli_app	pipeline	bash	pipelines	1.0.0	impure	init_cli_app(nombre: string, [--with-tui]) -> void	Scaffold de Go CLI app con subcomandos (version/status/help) routed via os.Args. Con --with-tui genera model.go con un modelo Bubbletea fullscreen (lista filtrable + spinner + dark theme) y main.go arranca la TUI en modo fullscreen. Sin dependencias de cobra/urfave — consistente con las apps del registry.	init scaffold cli tui pipeline bash launcher	assert_command_exists_bash_shell new_base_model_go_tui dark_styles_go_tui run_fullscreen_go_tui new_spinner_go_tui new_filtered_list_go_tui			false	error_go_core		name desc nombre nombre de la CLI app (apps/{nombre}/); se usa como binario y como modulo Go name desc --with-tui anade model.go con modelo Bubbletea (lista + spinner + dark theme) y arranca TUI fullscreen al invocar sin args	CLI app en apps/{nombre}/ con main.go (subcommand routing), cmd_version.go, cmd_status.go, Makefile con targets build/run/install/test/vet/clean. Con --with-tui anade model.go y el default sin args arranca TUI.	false			fn run init_cli_app my_cli --with-tui	bash/functions/pipelines/init_cli_app.sh

Sinopsis

fn run init_cli_app <nombre> [--with-tui]

Ejemplo rapido

# CLI clasica
fn run init_cli_app mytool
cd apps/mytool
make build
./mytool version
./mytool status

# CLI + TUI fullscreen
fn run init_cli_app deploy_helper --with-tui
cd apps/deploy_helper
make build
./deploy_helper          # arranca TUI
./deploy_helper version  # subcomando

Archivos generados

Archivo	Descripcion
main.go	Entry con switch os.Args[1]; subcomandos: version, status, help
cmd_version.go	Imprime nombre + version
cmd_status.go	Imprime app/version/go/os/arch
go.mod	Modulo Go con replace fn-registry; con --with-tui agrega bubbletea/bubbles/lipgloss
Makefile	Targets build, run (ARGS=...), install (~/.local/bin/), test, vet, clean
.gitignore	Binario + IDE files
app.md	Tag cli (o cli,tui,bubbletea con --with-tui)

Con --with-tui anade:

• model.go — Model con spinner (spinner.Dot), lista Bubbletea con 4 items de ejemplo, dark theme (lipgloss con colores 7D56F4 / 06B6D4), keys enter/q/ctrl+c
• main.go arranca la TUI con tea.NewProgram(model, tea.WithAltScreen()) si no hay args

Flags

Flag	Efecto
--with-tui	Anade model.go con Bubbletea y TUI fullscreen como default

Post-setup

cd apps/{nombre}
make build                       # construye ./{nombre}
./{nombre} version
./{nombre} status
make install                     # copia a ~/.local/bin/{nombre}
make run ARGS="status"           # build + run con argumentos

Notas

Pipeline impuro: genera archivos, ejecuta go mod tidy y go vet al final.

Los ejemplos del modelo TUI (items "Deploy", "Status", "Logs", "Exit") son placeholders — reemplazar con la logica real de la app. El modelo usa los componentes estandar de bubbles (list, spinner) y lipgloss para estilos.

Las funciones del registry new_base_model_go_tui, dark_styles_go_tui, run_fullscreen_go_tui, new_spinner_go_tui, new_filtered_list_go_tui son referenciadas en el frontmatter como deps conceptuales aunque el scaffold inline el codigo Bubbletea directamente (las funciones del registry son stubs que delegan a devfactory/tui).

Abort si apps/{nombre}/ ya existe.

El tag launcher permite que aparezca en el Pipeline Launcher TUI (aunque una CLI con TUI interactiva normalmente no se lanza como subprocess).