Instalación — Docs AKOS

Antes de empezar: macOS trae Python 3.9 y AKOS necesita Python 3.10+. Instala uno más nuevo (brew install python@3.12) o apunta AKOS al intérprete correcto con AKOS_PYTHON_BIN. install.sh es no destructivo: crea backup, verifica el manifest y restaura si algo falla.

Requisitos

· macOS o Linux (Windows vía WSL2)
· Git 2.30+
· Bash 5.x o Zsh
· Python 3.10+ disponible en el PATH
· ~/bin en el PATH (export PATH="$HOME/bin:$PATH")
· Node.js 18+ (opcional, para integraciones con IDE)

Instalar

terminal

git clone https://github.com/ipaud/AKOS.git ~/DEV/AKOS
cd ~/DEV/AKOS
./install.sh
./doctor.sh

El repositorio ipaud/AKOS es público (MIT): el clonado por HTTPS no requiere credenciales. Reinicia la sesión del agente tras instalar — las skills se enumeran al arrancar la sesión.

Instalar como plugin

terminal

# Claude Code
/plugin marketplace add ipaud/AKOS
/plugin install akos@akos

# Codex CLI
codex plugin marketplace add ipaud/AKOS
codex plugin add akos@akos

El plugin instala una copia en caché. Si vas a editar packs propios, usa el clon local: enlaza por symlink y los cambios se ven al instante.

Activar en un proyecto

terminal

cd ~/mi-proyecto
akos install-project    # AGENTS.md, CLAUDE.md, .cursor/rules/akos.mdc, GEMINI.md

Verificar la instalación

terminal

akos doctor
# 68 OK · 1 warning · 0 failures  (estado estable actual del repositorio)

Actualizar

terminal

cd ~/DEV/AKOS && git pull && ./install.sh

Reejecutar install.sh reconcilia symlinks y manifest. Consulta el roadmap para lo que todavía falta cubrir.

Desinstalar

terminal

./uninstall.sh   # borra solo symlinks propios; nunca toca packs/personal/

Introducción Configuración