claude-work-setup

Repositorio: https://github.com/saulwadeleon/claude-work-setup

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 (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.

# 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

pip install claude-work-setup
claude-work-setup

Modo desarrollo (clonar el repositorio)

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

git clone https://github.com/saulwadeleon/claude-work-setup.git
cd claude-work-setup

Windows (PowerShell)

.\install.ps1

macOS / Linux (bash o zsh)

chmod +x install.sh
./install.sh

Manual (sin script)

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

pip install -e ".[dev]"
pytest

Licencia

MIT © Saúl Wade León.