Metadata-Version: 2.3
Name: zpx
Version: 0.2.4
Summary: CLI de ZPX Forge: conecta tu Claude Code o Codex con tu fábrica de software
Keywords: zpx,zpx-forge,ai-agents,claude-code,codex,cli
Author: Zynplex
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development
Requires-Dist: filelock>=3.16
Requires-Dist: httpx>=0.28
Requires-Dist: prompt-toolkit>=3.0.43,<4
Requires-Python: >=3.10
Project-URL: Homepage, https://zpxforge.com
Project-URL: Documentation, https://zpxforge.com/docs
Description-Content-Type: text/markdown

# zpx

CLI de [ZPX Forge](https://zpxforge.com): conecta tu Claude Code o Codex con tu fábrica de software.

## Uso

```bash
uvx zpx health          # probar sin instalar nada
pipx install zpx        # instalarlo de forma permanente
uv tool install zpx     # o con uv
pip install zpx         # o con pip, dentro de un entorno virtual
```

```bash
zpx                     # panel interactivo con comandos /
zpx doctor              # credencial local, proyecto efectivo y siguiente paso
zpx doctor --json       # diagnóstico sin red para agentes y scripts
zpx help review         # buscar una acción en el idioma activo
zpx guide evidencia     # preparar la evidencia de una entrega
zpx login               # aprobar el código desde el navegador
zpx config language es  # español (en para volver al inglés)
zpx version             # versión del CLI
zpx health              # salud de la plataforma
zpx health --json       # en JSON
zpx health --url http://localhost:3000   # otra instancia
```

El CLI inicia en inglés. También puedes elegir el idioma en `/config` o durante `/setup`.

La URL por defecto es `https://www.zpxforge.com`; también se puede fijar con la variable `ZPX_URL`.

Documentación: https://zpxforge.com/docs

## Publicar en PyPI

Con la versión ya construida, ejecuta:

```bash
cd ~/zynplex/zpxforge/cli && uv publish
```

### Sincronizar el harness del proyecto

Desde el repositorio del cliente, ejecuta `zpx` y selecciona `/setup`. Al elegir el proyecto, el CLI descarga desde Forge la versión asignada de su plantilla, las políticas, la configuración del proyecto, los roles y las skills activas (incluidas las propias). Claude Code y Codex reciben sus definiciones en sus respectivas carpetas.

Después de cambiar la configuración en Forge, repite `/setup` o ejecuta `zpx skill install` en ese repositorio. El CLI actualiza y retira los archivos administrados según el registro de `.zpx/installed.json` y señala los conflictos con ediciones locales.

Forge identifica la configuración efectiva de cada proyecto por su contenido. El panel de skills muestra la revisión vigente. Al abrir el CLI en un repositorio vinculado, y al consultar `zpx context`, el CLI compara esa revisión con la última instalada. Claude y Codex reciben la instrucción de sincronizar al consultar el contexto. Para integraciones, `zpx context --json` expone `harness.revision` y `harness.sync.required`.

Desde 0.2.4, `zpx audit [RUTA] --json` examina los nombres del índice Git para localizar archivos de entorno versionados y workflows de GitHub Actions. Funciona sin iniciar sesión. `zpx guide hito` explica la aceptación y la entrega. `zpx guide agente` muestra, para el sitio configurado, la dirección de las [instrucciones completas para Claude o Codex](https://www.zpxforge.com/es/docs/instrucciones-agente).
