argosai

Instalador de línea de comandos para ArgosAI: un framework agnóstico de agente (Claude, Codex) para desarrollar software con IA de forma ordenada — spec-driven development, bugfixing documentado con causa raíz y verificación, y diseño frontend conectado opcionalmente al Figma Dev Mode MCP server.

Funciona igual que herramientas como specify (spec-kit) o el CLI de RAISE: se instala una vez como paquete de Python y luego se usa el comando argosai dentro de cualquier proyecto, nuevo o ya avanzado.

Manual completo: docs/MANUAL.md — instalación, los cuatro flujos de trabajo, referencia completa de comandos, monorepo, CI/hooks, costos, y todo lo demás. Este README es solo el quickstart.

Instalación

Desde el código fuente de este paquete (aún no publicado en PyPI):

pip install .
# o, para desarrollo/edición del propio framework:
pip install -e .

Una vez publicado en PyPI (paso que requiere tu cuenta, ver más abajo), sería simplemente:

pip install argosai

Uso

# Proyecto nuevo o ya existente — instala AGENTS.md, CLAUDE.md, skills, plantillas, carpetas
argosai init /ruta/a/tu/proyecto
argosai init .            # o directo en el proyecto donde ya estás parado

# Volver a instalar sobre archivos ya existentes (excepto constitution.md, que nunca se pisa)
argosai init . --force

# Crear una nueva feature (spec.md numerado y con slug automático)
argosai new-feature "login social"

# Crear un nuevo bug (report.md)
argosai new-bug "el checkout no hace nada en Safari"

# Crear un nuevo esfuerzo de diseño (design-brief.md)
argosai new-design "rediseño del onboarding"

argosai --version
argosai --help

Después de argosai init, si el proyecto ya tiene código, dile a tu agente (Claude o Codex):

"Corre el skill argos-onboard para analizar este proyecto."

Configurar tu agente por defecto (para no repetir --agent siempre)

# Una sola vez — aplica a todos tus proyectos
argosai config set-agent claude

# Si un proyecto puntual necesita el otro agente, se sobreescribe solo ahí
argosai config set-agent codex --project

# Ver qué queda configurado (global, de proyecto, y el valor efectivo)
argosai config show

# Opcional: que run/ideate ya no pidan --yes tampoco (pierdes el freno del dry-run por defecto)
argosai config set-yes true

Con esto, en el día a día:

argosai run implement 003-user-auth --yes
argosai run review 003-user-auth --agent codex --yes   # revisión cruzada: explícito cuando quieras el otro agente
argosai ideate "una app para..." --yes

Orden de resolución: --agent/--yes explícitos en el comando > variables de entorno ARGOSAI_AGENT / ARGOSAI_YES > .argos/config/settings.json del proyecto > ~/.argosai/config.json global. Si nada de eso está configurado, argosai run/ideate te lo dicen claramente en vez de fallar en silencio. --dry-run fuerza el modo seguro para una sola llamada aunque tengas auto_yes activado por defecto.

Qué instala argosai init

AGENTS.md              ← instrucciones canónicas (Codex las lee nativo)
CLAUDE.md                ← apuntador a AGENTS.md (Claude lo lee nativo)
.argos/
  memory/constitution.md    ← plantilla de principios del proyecto (no se pisa si ya existe)
  memory/patterns.md        ← log corto de cosas ya aprendidas
  templates/                 ← spec, plan, tasks, bug-report, bug-fix-plan, design-brief, adr,
                                review, audit, analyze
  config/agents-setup.md    ← cómo queda conectado con Claude y Codex
.claude/skills/            ← 12 skills para Claude Code
.agents/skills/              ← mismas 12 skills, para Codex CLI
specs/  bugs/  design/  audits/  docs/  ← carpetas de trabajo vacías, listas para usarse

A diferencia de la versión de "copiar carpetas" del framework, aquí los skills viven en un solo lugar dentro del paquete instalado — argosai init los copia a ambas rutas (.claude/skills y .agents/skills) automáticamente en cada instalación, así que no hay riesgo de que se desincronicen entre Claude y Codex. Re-correr argosai init --force actualiza esos archivos a la versión más reciente sin pisar nunca tus personalizaciones (ver sección 14 del manual).

Más allá del quickstart

El CLI también trae: argosai lint (chequeos deterministas de consistencia), argosai dashboard (snapshot visual en HTML), argosai hooks install/ci (git pre-commit y GitHub Actions, opt-in), argosai costs (log de $ y tokens por corrida), soporte de monorepo (--package en new-feature/new-bug/new-design), lock de ejecución concurrente, y un ciclo de revisión con escalación automática si argos-review se atora. Todo documentado con ejemplos en docs/MANUAL.md.

Publicar en PyPI (cuando quieras)

Este paquete está listo para publicarse tal cual. Cuando quieras que pip install argosai funcione desde cualquier lado:

pip install build twine
python -m build
twine upload dist/*

twine upload te pedirá tu usuario/token de PyPI — eso solo lo puedes hacer tú, con tu cuenta. Antes de publicar, confirma que el nombre argosai sigue disponible en pypi.org (nombres se apartan por orden de llegada).

Desarrollo

El código del CLI vive en src/argosai/cli.py. Las plantillas y skills que se copian a cada proyecto están en src/argosai/resources/ — edítalas ahí, no en un proyecto ya instalado, para que la próxima versión del paquete las propague a todos.