pbAID: "mini IDE" para PowerBuilder o mi "PBSearch"

Los que me seguís sabéis que me paso media vida dentro de soluciones PowerBuilder grandes. Y hay tareas del día a día (buscar dónde se usa algo, ver qué ha cambiado, localizar funciones que ya no llama nadie, lanzar la aplicación para probar un arreglo) para las que abrir el IDE entero me parecía matar moscas a cañonazos.

Y aquí tengo que dar las gracias a Roland Smith (Topwiz Software) y a su PBSearch, que lleva años siendo mi herramienta de cabecera para buscar en los workspaces de siempre y que es la inspiración de todo esto. Cuando pasé a trabajar con soluciones de PowerBuilder 2025, con los fuentes en carpetas, noté que con ellas se me hacía algo lento, y de ahí nació la idea de construir algo pensado desde cero para el modo solución.

Desde que PowerBuilder 2025 guarda las librerías como carpetas con los fuentes en disco, esos fuentes están ahí, legibles. Así que me puse a construir una herramienta que trabajara directamente sobre ellos. Empezó como un apaño para mí y, a base de usarla a diario, ha acabado siendo un producto con nombre propio: pbAID.

El nombre es un juego de palabras: PB de PowerBuilder, AI de inteligencia artificial, y AID, que suena casi como IDE. Todo junto, un mini IDE pensado para trabajar con PowerBuilder y con IA. Y, de paso, aid en inglés es «ayuda», que es justo lo que pretende ser.

En este artículo os lo enseño entero, pantalla a pantalla.

Descarga: pbaid.rsrsystem.com · Ayuda: en español y en inglés

¿Qué es pbAID?

Un IDE de PowerBuilder 2025 en el navegador. Lee los fuentes de una solución .pbsln directamente del disco y te deja trabajar con ellos desde su propia ventana:

• navegar por el disco y abrir cualquier solución, con el árbol de sus librerías y objetos;
• convertir un workspace de toda la vida (.pbw) en solución, sin abrir el IDE;
• ver y editar el código de los once tipos de objeto, con el coloreado del IDE;
• buscar y reemplazar en toda la solución, y comprobar al terminar que sigue compilando;
• sacar informes: referencias cruzadas, objetos y código sin usar, dónde vive el SQL…;
• trabajar con Git (commit, push, pull, revertir) sin salir;
• compilar, ejecutar y publicar la aplicación sin abrir el IDE;
• dejar tareas en la To-Do List del IDE y abrir objetos en el IDE;
• consultar y editar tablas de SQL Server desde una consola SQL;
• y pedirle todo eso a Claude con vuestras palabras, con el complemento IA.

Que quede claro desde el principio: no sustituye al IDE, lo acompaña. Para pintar ventanas y DataWindows, el IDE sigue siendo el sitio. pbAID se ocupa de todo lo que rodea al código. Y lo que escribe son exactamente los mismos ficheros de fuente que usa PowerBuilder, en su codificación y con sus saltos de línea. Para compilar y publicar usa el PowerBuilder 2025 que tengáis instalado (el IDE o PowerBuilder Utilities); para ejecutar basta el runtime.

Y habla vuestro idioma: la interfaz, la ayuda, la web y el instalador están en español y en inglés. De entrada sigue el idioma de Windows, y se cambia en Configuración › Programa › Idioma.

pbAID con Claude: pedírselo con tus palabras

Esta es, para mí, la gracia del programa. Con el complemento IA, Claude Code maneja pbAID por vosotros: le pedís las cosas con vuestras palabras y él busca, reemplaza, compila, abre objetos en vuestra ventana o saca informes, con las mismas herramientas que usáis vosotros. Va incluido gratis con cualquier licencia y durante la prueba, y se instala aparte (pbAID-IA.exe, un ejecutable pequeño) para que quien no use Claude no cargue con él.

Cosas que se le pueden pedir:

• «Busca OpenWithParm en la solución Materials y dime en qué ventanas está.»
• «Cambia gf_nombre_empresa( por gf_nombre_empresa_abr( en las funciones y compila para ver que no se rompe nada.» Claude os enseña primero cuántos cambios haría y los aplica cuando se lo confirmáis.
• «Abre d_emp_report en mi ventana y márcame las líneas que no te convencen.» El objeto se abre en vuestro pbAID con las líneas resaltadas, cada una con su motivo.
• «Pásame el informe de miembros sin usar.»
• «¿Qué tengo sin commitear? Haz commit de lo que he tocado en gf_mensaje.»
• «¿Cuántos clientes hay dados de alta?»: consultas de solo lectura contra vuestra base de datos.

Se instala desde Configuración › Programa › Complemento IA (o desde la web), y el botón Conectar con Claude lo registra en Claude Code. A partir de ahí, lo tenéis en cualquier carpeta en la que trabajéis.

Y tan importante como lo que hace es lo que no hace, a propósito: nada que no tenga vuelta atrás. Revertir cambios, borrar o mover objetos, hacer push o escribir en la base de datos se hace desde la interfaz, con el ratón. Cuando Claude escribe, lo hace con las mismas protecciones que vosotros: no pisa un fichero que haya cambiado en disco y, si el resultado no es el esperado, lo deja como estaba.

Para scripts y ficheros .bat, pbAID-IA.exe es también un programa de consola con los mismos verbos. Lo que escribe se ensaya por defecto y solo se aplica con --aplicar:

pbAID-IA buscar Materials "OpenWithParm" --tipos srw
pbAID-IA reemplazar Materials viejo nuevo --tipos srf            (ensayo)
pbAID-IA reemplazar Materials viejo nuevo --tipos srf --aplicar
pbAID-IA compilar Materials

Instalar: un único .exe

Ya sabéis que la simplicidad es mi obsesión, y aquí también:

• Descargáis pbAID.exe de pbaid.rsrsystem.com. Es un único fichero: sin instalador, sin Python, sin nada que montar antes.
• La primera vez os ofrece colocarse en su sitio (%LOCALAPPDATA%\Programs\pbAID) con un acceso directo en el Escritorio. Podéis decir que no y usarlo desde donde esté; la diferencia es que, instalado en su sitio, se actualiza solo sin permisos de administrador.
• Al arrancar mira si hay versión nueva y, si la hay, os la ofrece: Actualizar y reiniciar la descarga, comprueba su firma y vuelve a abrirse en la versión nueva, sin tocar vuestra configuración. Si no hay conexión, se abre igual.
• Se desinstala limpio desde Aplicaciones instaladas de Windows, enseñando antes la lista de lo que va a borrar y preguntando aparte por vuestros datos.

Requisitos: Windows 10 u 11 de 64 bits y soluciones de PowerBuilder 2025 con las librerías como carpetas (si todavía tenéis un workspace, pbAID os lo convierte; lo cuento más abajo). Todo lo demás es opcional y solo lo necesita la función que lo usa:

Para	Hace falta
La ventana propia	Edge o Chrome instalados (sin ellos, se abre en vuestro navegador)
Ejecutar la aplicación	El runtime de PowerBuilder 2025, sin IDE (si el pcode aún no está compilado, lo de la fila siguiente)
Compilar, publicar y comprobar el pcode tras guardar o reemplazar	El IDE de PowerBuilder 2025 o PowerBuilder Utilities (el paquete de Appeon con PBAutoBuild), más el runtime
Convertir un workspace en solución	Lo mismo que para compilar, y además un Python de 32 bits (la primera vez pbAID os pregunta y lo descarga él)
Publicar para PowerClient y PowerServer	El IDE de PowerBuilder 2025 o PowerBuilder Utilities, si usáis un build file exportado antes desde el IDE con «Export Build File». Ojo: el build file lleva la versión dentro, así que al subirla hay que volver a exportarlo (pbAID os avisa si no cuadra)
Abrir en el IDE y la To-Do List del IDE	El IDE de PowerBuilder 2025 (la To-Do List vive en su configuración)
Git	Git para Windows (y GitHub CLI si usáis varias cuentas)
Consola SQL	Un driver ODBC de SQL Server
pbAID con Claude	El complemento IA (gratis, se instala aparte), Claude Code con vuestra cuenta y la IA activada en Configuración
Comentario del commit con IA	Claude Code con vuestra cuenta

Si falta algo, el botón que lo necesita sale apagado y, al pasar el ratón, os dice qué falta y dónde lo ha buscado. Lo demás sigue funcionando.

Y un detalle que me parece interesante: buena parte de pbAID funciona sin nada de PowerBuilder instalado. El explorador, Edit Source (leer, editar y guardar), buscar y reemplazar en la solución, los informes, quitar el código muerto, la vista Librería, Git, la consola SQL y pbAID con Claude van sin IDE y sin runtime. Para ejecutar basta el runtime, y para compilar y publicar no hace falta el IDE: sirve PowerBuilder Utilities. El IDE solo es imprescindible para publicar PowerClient, para abrir objetos en él y para su To-Do List.

La pantalla

Si habéis usado el IDE, os vais a sentir en casa:

• Arriba, la barra con los botones agrupados: Solución (Buscar, Informes, Librería, Tocados), Ejecución (Ejecutar, Versión, Publicar), Git, Herramientas (SQL, Config, Ayuda) y Vista.
• A la izquierda, el explorador.
• En el centro, los objetos abiertos, uno por pestaña.
• Abajo, el panel Detalle: resultados de búsquedas, informes y consolas de compilación, cada uno en su pestaña.

Los paneles se redimensionan arrastrando el borde y se pliegan con doble clic. pbAID recuerda cómo los dejasteis.

El explorador

Hay dos formas de llegar a una solución:

• Por carpetas (la de serie, como el IDE): navegáis el disco tal cual. Las carpetas que contienen una solución llevan un punto azul y el número de objetos; un clic y se abre.
• Automático: pbAID busca todas las soluciones que hay debajo de vuestra carpeta de proyectos (la raíz de trabajo) y os las lista.

La barra de direcciones funciona como la de Windows: escribís una ruta y Enter. A su derecha está la raíz de trabajo, que se pone en ámbar si navegáis fuera de ella. Y si hay carpetas que no queréis ver (copias, árboles de otros…), se listan en un fichero .pbaidignore y desaparecen al momento.

La lente de tipos decide qué tipos de objeto veis (Window, DataWindow, Function, User object…), con cuántos hay de cada uno. Si desmarcáis alguno, el botón lo dice en ámbar («3 de 11») para que nunca os falte un objeto sin saber por qué.

Abrir una solución

Al abrirla, el árbol pasa a ser el de sus librerías y objetos. Doble clic abre un objeto; el botón derecho sobre la solución, una librería o un objeto abre su menú de acciones. Si la solución está en Git, cada objeto lleva la marca de su estado.

Como hace el IDE, al abrir una solución pbAID comprueba con qué runtime se compiló. Si no es el que tenéis, os ofrece compilarla con la versión nueva; si canceláis, se abre sin tocar nada.

Abrir un workspace (desde la 1.2.8)

Muchos seguimos teniendo aplicaciones en el formato de siempre: un .pbw con sus .pbl binarias. En el explorador, una carpeta con workspace y sin solución sale con el punto hueco y la marca workspace. Al pulsarla, pbAID os pregunta si la convertís en solución, igual que hace el IDE al abrir un workspace. Solo que aquí no hace falta abrir el IDE:

• Convierte en la misma carpeta: el .pbw pasa a .pbsln, cada .pbt a .pbproj y cada librería a una carpeta con un fichero por objeto. Lo original se guarda en _BackupFiles, como hace el IDE.
• No toca nada hasta tenerlo todo a salvo: primero exporta a una carpeta aparte y copia lo viejo al backup comprobando que la copia es idéntica. Si algo falla a mitad, lo deshace y la carpeta queda exactamente como estaba.
• Una librería que el proyecto usa desde fuera de su carpeta también se convierte, en su sitio y con su copia en el _BackupFiles de su carpeta, y sigue en la solución, como en el IDE; el diálogo os dice cuál. Las .pbl de la carpeta que el proyecto no usa se dejan como están.
• Al terminar abre la solución y la compila entera, para comprobar que ha quedado bien.

Para esto hacen falta dos cosas: el IDE de PowerBuilder 2025 o PowerBuilder Utilities (con el runtime), porque la conversión usa sus propias herramientas, y un Python de 32 bits, porque esas herramientas son de 32 bits. Lo he comprobado también convirtiendo solo con Utilities, sin el IDE: el resultado es idéntico. No tenéis que instalar nada a mano: la primera vez que convertís, pbAID os pregunta y lo descarga él. Solo lo usa esta función; el resto del programa no lo necesita.

Y si el workspace está en Git, se ocupa también de eso: ajusta el .gitignore (quita las líneas que romperían la solución y añade las del backup y lo que genera la compilación) y deja la conversión preparada como renombrados, de modo que cada objeto conserva su historia. El commit no lo hace: eso lo decidís vosotros.

Para darlo por bueno, convertí el mismo ejemplo con pbAID y con el IDE y comparé el resultado: más de mil ficheros, idénticos byte a byte.

¿Y por qué pbAID no hace más cosas con los workspaces, aparte de convertirlos? Pues porque para eso ya existe PBSearch, y lo hace muy bien. pbAID está pensado para las soluciones; si seguís con workspaces, os recomiendo PBSearch sin dudarlo.

Edit Source

Cada objeto se abre en su Edit Source: el fuente completo, con números de línea y el coloreado del IDE. Vale para los once tipos, DataWindows incluidas.

• Guardar (Ctrl+S) escribe el fichero en su codificación y con sus saltos de línea. Antes de darlo por bueno comprueba que el objeto se sigue pudiendo leer; si no, deja el fichero como estaba y os avisa.
• Tras guardar, compila el pcode de la solución y enseña el resultado en la consola. Si habéis roto algo, lo sabéis al momento.
• Si el fichero cambia en disco mientras lo tenéis abierto (lo habéis tocado en el IDE, por ejemplo), lo recarga si no teníais cambios y, si los teníais, os pregunta. Nunca guarda encima de un cambio hecho por fuera sin avisar.
• Las ventanas se abren en solo lectura: su fuente guarda solo lo que cambia respecto al ancestro, y editarlas a mano puede romper la herencia. Para eso está el IDE, y pbAID os las abre allí con un clic.

Dentro del editor tenéis Ctrl+F y Ctrl+H, con mayúsculas, palabra completa, expresiones regulares (con $1 para los grupos) y todos los aciertos resaltados.

Buscar y reemplazar en toda la solución

Con Ctrl+Shift+F elegís la solución, las librerías y los tipos de objeto, y afináis:

• distinguir mayúsculas;
• palabra entera, para que gf_nombre no case dentro de gf_nombre_largo;
• expresiones regulares, con una chuleta de ejemplos sobre fuentes de PowerBuilder;
• y dónde cuenta un acierto: todo el fuente, solo código, fuera de comentarios, solo comentarios o solo textos entre comillas.

Los aciertos salen agrupados por objeto y con su línea, sin tope. Doble clic y se abre el objeto. Y para reemplazar, marcáis los aciertos que queréis cambiar, escribís el texto nuevo y listo:

Antes de escribir nada os dice cuántos aciertos y objetos va a cambiar y, si la solución no está en Git, que no habrá vuelta atrás. Al terminar vuelve a buscar y compila. Y aquí hay un detalle del que estoy especialmente contento: si la compilación falla, os dice cuántos de los errores nombran objetos que acabáis de tocar, para distinguir lo que habéis roto vosotros de lo que ya fallaba antes.

Informes: conocer la solución de verdad

Esta es la parte que más uso. Cuando heredas (o llevas veinte años haciendo crecer) una aplicación, las preguntas son siempre las mismas: ¿quién usa esto?, ¿esto se usa?, ¿dónde se escribe en esta tabla? Los informes contestan eso:

Resúmenes	Objetos por tipo y por librería, lo que ocupan y sus líneas de código.
Salud	Nombres demasiado largos, duplicados y objetos corruptos (fuentes que no se pueden leer bien).
Referencias cruzadas	Qué usa cada objeto y, al revés, quién lo usa a él.
Lo que sobra	Objetos que no nombra nadie, funciones que nadie llama y variables locales sin usar.
Arquitectura de datos	Funciones por SQL y tablas que tocan, DataWindows actualizables (y quién llama de verdad a su Update()), objetos que escriben en la base de datos y la matriz CRUD objeto × tabla.

Cada informe es una tabla en la que podéis ordenar, mover columnas, filtrar cada columna como en Excel y exportar a Excel o a PDF con el filtro que tengáis puesto. Doble clic en una fila abre el objeto, y con un botón mandáis filas a la To-Do List del IDE.

Quitar el código muerto

El informe Miembros sin usar señala las funciones y variables locales que nadie usa.

Doble clic en una fila abre el objeto con todo su código muerto marcado en rojo y tres botones que actúan exactamente sobre lo marcado:

1. Comentar: comenta lo muerto con una marca propia. Si en una línea conviven variables usadas y sin usar, solo se van las que sobran.
2. Compiláis y probáis vuestra aplicación.
3. Si algo falló, Descomentar lo deja exactamente como estaba. Si todo va bien, Borrar elimina lo que pbAID comentó, y solo eso: vuestros propios comentarios no se tocan.

¿Por qué en tres pasos? Porque son candidatos, no certezas. PowerBuilder puede llamar a una función por su nombre dentro de una cadena (TriggerEvent, Post, Dynamic), y eso no se ve en el código. Que compile no demuestra que sobre, así que siempre hay vuelta atrás. Limpiar una aplicación de veinte años deja de ser un acto de fe.

Librería

La vista de librería de toda la vida: sus objetos con fecha de modificación y de compilación, tamaño y comentario. Desde aquí se exporta un objeto, varios o la librería entera en el formato de exportación de PowerBuilder, se importan objetos y se borran o mueven entre librerías (siempre con confirmación).

Git, como en el IDE

Si la solución está en un repositorio, cada objeto y cada librería lleva su marca: sin cambios, modificado (✓), nuevo (+) o ignorado (○). El diálogo de commit es el del IDE, Git Commit to Branch, con unas cuantas ayudas:

• vienen marcados los ficheros que pbAID ha escrito en esta sesión; el resto se ve, desmarcado;
• solo entra lo marcado, nunca «todo lo que haya», y lo que Git ignora ni aparece;
• Dry-run enseña qué se commitearía, sin hacerlo;
• si usáis varias cuentas de GitHub, el push se hace con la cuenta dueña del repositorio;
• y +IA redacta el comentario a partir de lo marcado (lo cuento más abajo).

También hay Pull (que solo trae cambios si no hay que fusionar nada; si hiciera falta, no toca nada y os lo dice), Revertir cambios (el Git Revert del IDE: descarta cambios locales, con confirmación nombrando los ficheros) y la pestaña Tocados, que lista todo lo modificado y marca lo que se ha cambiado fuera de pbAID.

Ejecutar, compilar y publicar

• Ejecutar lanza la aplicación desde su pcode, sin abrir el IDE, en 64 o 32 bits. Mientras corre, el botón pasa a Detener.
• Publicar enseña solo los tipos de proyecto que tiene de verdad la solución: Classic genera el ejecutable y los .pbd; PowerClient y PowerServer permiten un ensayo, compilar en local o publicar al servidor (esto último pide confirmación cada vez). En su línea Build file elegís si pbAID lo genera solo (necesita el IDE) o usa uno exportado desde el IDE con «Export Build File» (basta con Utilities); se recuerda por solución y entorno.
• Cada compilación y publicación se sigue en directo en su consola, que termina diciendo si fue bien.

Y uno que me ahorra mucho tiempo: Subir versión sube a la vez la versión de todos los proyectos de la solución (Classic, PowerClient y PowerServer). Os avisa si no estaban a la par (y los iguala) y si la versión no casa con el runtime.

To-Do List del IDE y Abrir en el IDE

pbAID trabaja con la To-Do List del IDE (Tools › To-Do List) en los dos sentidos: lo que apuntáis aquí aparece en el IDE, y lo que apuntáis en el IDE se ve aquí. Podéis mandar a la lista un objeto, el resultado de una búsqueda o las filas de un informe, y elegir si la tarea abrirá el objeto en su painter o en su Edit Source. Es la evolución de lo que os conté en el artículo de agosto.

Un aviso importante: para escribir en la lista, el IDE tiene que estar cerrado. Si está abierto, al cerrarse guardaría su propia copia y se perdería lo añadido. pbAID os lo dice antes de que lo intentéis. Y Abrir en el IDE abre el objeto en su painter, o la solución entera; si el IDE ya está abierto, no abre otro.

Consola SQL

Para no tener que saltar a otra herramienta cada vez que queréis mirar una tabla:

• perfiles de conexión a SQL Server (autenticación de SQL Server o de Windows), con las contraseñas guardadas cifradas;
• tablas, vistas y campos a la izquierda, con buscador; al elegirlos se compone el SELECT;
• resultados con los mismos filtros y exportaciones que los informes;
• y si la consulta es de una sola tabla con clave primaria, el resultado se puede editar: insertar, eliminar y guardar, todo o nada.

El comentario del commit, con IA

Además del complemento, hay otra IA, más pequeña y al revés: aquí no es Claude quien usa pbAID, sino pbAID quien le pide algo a Claude. En concreto, redactar el comentario de un commit (el botón +IA). Es un interruptor que viene apagado: sin él, pbAID funciona exactamente igual. Para activarlo, instaláis el CLI de Claude con vuestra cuenta y lo encendéis en Configuración › Programa. Si la IA falla (sin red, sin saldo…), pbAID os avisa y pone un comentario genérico, y siempre se dice si el comentario lo ha redactado la IA o no.

Atajos de teclado

F1	Ayuda
Ctrl+Shift+F	Buscar en toda la solución
Ctrl+S / Ctrl+Z	Guardar / deshacer en el editor
Ctrl+F / Ctrl+H	Buscar / reemplazar en el objeto
F3 / Shift+F3	Siguiente / anterior acierto
Ctrl+Enter	Reemplazar todo (en el objeto) / ejecutar (en la consola SQL)
Una letra	En el árbol, salta a la siguiente librería que empieza por ella

Licencia y precios

pbAID es un producto comercial y se prueba 30 días gratis, completo, desde la primera vez que lo abrís. Después, el plan se elige según cuántos equipos lo van a usar:

Plan	Equipos	Precio	Renovación anual
Individual	1	49 €	10 €
Equipo	20	199 €	20 €
Empresa	Ilimitados	995 €	— (no hace falta)

Precios sin IVA.

• Todos los planes incluyen el complemento IA (pbAID con Claude), también durante la prueba.
• La licencia es perpetua: la versión que tenéis funciona para siempre, renovéis o no.
• Incluye un año de actualizaciones. Pasado el año seguís con la última versión que salió dentro de él; si queréis las siguientes, renováis por el precio de la tabla y tenéis otro año. El plan Empresa no renueva: tiene todas las actualizaciones incluidas, siempre.
• Una licencia es un email con su número de equipos. Se activa desde el propio programa y, una vez activada, funciona sin conexión.
• ¿Cambiáis de ordenador? Se libera el antiguo y se activa el nuevo.

Todo el detalle está en la ayuda (también en inglés), y la descarga, en pbaid.rsrsystem.com. También lo tenéis en la sección de productos de mi web, rsrsystem.com.

Para comprar o para cualquier duda, escribidme por LinkedIn.

Y si os pica la curiosidad por saber qué más ando cocinando (otros productos, proyectos y lo que se me va ocurriendo), pasaos por mi web: rsrsystem.com.

Lo que he aprendido por el camino

• Los fuentes en carpetas lo cambian todo. Desde PowerBuilder 2025 el código está a la vista, y eso abre la puerta a herramientas que antes no eran posibles.
• Nunca romper lo que ya funciona. Por eso pbAID compila después de cada cambio, respeta la codificación de cada fichero y no guarda encima de nada sin avisar.
• Candidatos, no certezas. En un lenguaje en el que se puede llamar a una función por su nombre dentro de una cadena, ningún análisis es infalible. Mejor decirlo y dar siempre vuelta atrás.
• El IDE manda. pbAID trabaja con los mismos ficheros y las mismas convenciones del IDE; lo acompaña, no compite con él.

Si lo probáis, me encantará saber qué os parece y qué echáis en falta.

Y si vais a la PowerBuilder Regional Conference de Barcelona el 27 de octubre, allí nos vemos: os lo cuento aquí.

---

pbAID · © Ramón San Félix Ramón · software propietario. PowerBuilder es una marca de Appeon.

¡Nos vemos en el próximo artículo! Y recuerda: en PowerBuilder, los límites solo están en nuestra imaginación. 🚀