Metadata-Version: 2.4
Name: claude-work-setup
Version: 0.2.2
Summary: Asistente CLI multiplataforma para desplegar la estructura de un workspace de Claude Cowork (Claude-Work).
Author-email: Saúl Wade León <saul.wade@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/saulwadeleon/Claude-Work
Project-URL: Repository, https://github.com/saulwadeleon/Claude-Work
Project-URL: Issues, https://github.com/saulwadeleon/Claude-Work/issues
Keywords: claude,cowork,workspace,setup,wizard,cli
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: rich>=13.7
Requires-Dist: python-docx>=1.1
Requires-Dist: pydantic[email]>=2.5
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: pytest-cov>=5.0; extra == "dev"
Requires-Dist: ruff>=0.4; extra == "dev"
Requires-Dist: mypy>=1.10; extra == "dev"

# claude-work-setup

> Repositorio: <https://github.com/saulwadeleon/Claude-Work>

Asistente CLI multiplataforma para desplegar la estructura de un workspace de **Claude Cowork** (`Claude-Work/`) con contenido personalizado: archivos de contexto (`about-me.md`, `my-voice.md`, `my-rules.md`), READMEs de las carpetas operativas (`PROYECTOS`, `PLANTILLAS`, `RESULTADOS`, `skills`) y la guía de configuración (`GUIA-CONFIGURACION.md`).

Funciona en **Windows, macOS y Linux**. Importa opcionalmente un CV `.docx` para prellenar los datos personales y captura las rutas externas, las preferencias de voz y la selección de plugins/conectores recomendados desde un wizard interactivo en terminal.

## Características

- Asistente paso a paso en terminal con [Rich](https://rich.readthedocs.io/) (preguntas con valores por defecto, validación, paneles y colores).
- Importación opcional de **CV en `.docx`** (perfil profesional, experiencia, formación, certificaciones, idiomas) usando `python-docx`.
- Generación de archivos Markdown personalizados a partir del modelo capturado.
- **Backup automático** con timestamp en `_backup/` antes de sobrescribir cualquier archivo previo.
- Scripts de arranque por sistema operativo: `install.ps1` para Windows, `install.sh` para macOS y Linux.
- Sin dependencias gráficas: solo Python ≥ 3.10 y dos librerías (`rich`, `python-docx`).

## Requisitos

- Python 3.10 o superior.
- Permisos de escritura en la carpeta de destino que indiques.

## Instalación rápida

### Recomendado: con `pipx` (UX equivalente a `npm i -g`)

`pipx` instala el CLI en su propio entorno aislado y agrega el ejecutable al `PATH` del usuario. Es la forma más limpia en Windows, macOS y Linux.

```bash
# Si todavía no tienes pipx:
python -m pip install --user pipx
python -m pipx ensurepath

# Instalar la app:
pipx install claude-work-setup
claude-work-setup
```

Para actualizar a una versión nueva basta con `pipx upgrade claude-work-setup`. Para desinstalarla, `pipx uninstall claude-work-setup`.

### Alternativa: con `pip` clásico

```bash
pip install claude-work-setup
claude-work-setup
```

### Modo desarrollo (clonar el repositorio)

Solo necesario si quieres modificar el código fuente o contribuir.

```bash
git clone https://github.com/saulwadeleon/Claude-Work.git
cd Claude-Work/PROYECTOS/claude-work-setup
```

#### Windows (PowerShell)

```powershell
.\install.ps1
```

#### macOS / Linux (bash o zsh)

```bash
chmod +x install.sh
./install.sh
```

#### Manual (sin script)

```bash
python -m venv venv
# Windows: .\venv\Scripts\activate
source venv/bin/activate
pip install -e ".[dev]"
claude-work-setup
```

Los scripts `install.ps1` e `install.sh` crean un `venv/` local y dejan la app lista para ejecutar; conviene usarlos durante desarrollo, no como ruta de distribución.

## Uso

Al ejecutar `claude-work-setup` el wizard te guía por seis pasos:

1. **Workspace.** Confirma o escoge la carpeta destino donde se creará `Claude-Work/`.
2. **Datos personales.** Captura manual de los campos o importación desde un CV `.docx`.
3. **Rutas externas.** Captura las rutas de tus proyectos de código, memoria histórica, expedientes institucionales, etc.
4. **Voz y reglas.** Idioma, tono, AI-isms a evitar, reglas de proyecto y comunicación.
5. **Plugins y conectores.** Marca los recomendados que quieres incluir en la guía.
6. **Confirmación y escritura.** Resumen final y aplicación de cambios con backup automático.

## Estructura del proyecto

```
claude-work-setup/
├── README.md
├── pyproject.toml
├── requirements.txt
├── install.ps1                       ← script Windows
├── install.sh                        ← script macOS/Linux
├── claude_work_setup/
│   ├── __init__.py
│   ├── __main__.py                   ← entrada `python -m claude_work_setup`
│   ├── cli.py                        ← orquestador del wizard
│   ├── models.py                     ← modelos pydantic
│   ├── ui.py                         ← helpers de Rich
│   ├── backup.py                     ← respaldo y escritura idempotente
│   ├── filesystem.py                 ← creación de directorios
│   ├── steps/
│   │   ├── step_workspace.py
│   │   ├── step_personal.py
│   │   ├── step_paths.py
│   │   ├── step_voice_rules.py
│   │   ├── step_plugins.py
│   │   └── step_summary.py
│   ├── importers/
│   │   └── cv_docx.py                ← lectura de CV .docx
│   └── generators/
│       ├── about_me.py
│       ├── my_voice.py
│       ├── my_rules.py
│       ├── readmes.py
│       └── guia.py
└── tests/
    ├── test_models.py
    ├── test_backup.py
    ├── test_cv_docx.py
    └── test_generators.py
```

## Salida que produce

```
<destino>/Claude-Work/
├── GUIA-CONFIGURACION.md
├── SOBRE MÍ/
│   ├── about-me.md
│   ├── my-voice.md
│   └── my-rules.md
├── PROYECTOS/README.md
├── PLANTILLAS/README.md
├── RESULTADOS/README.md
├── skills/README.md                  ← skills propias visibles para Cowork
└── _backup/                          ← solo si había contenido previo
    └── <timestamp>/
        └── ...                       ← copia textual de lo que se sobrescribió
```

## Pruebas

```bash
pip install -e ".[dev]"
pytest
```

## Licencia

Uso interno. Adaptable libremente para los entornos personales de **Saúl Wade León** y colaboradores autorizados.
