Saltar al contenido principal

Instalación

Requisitos​

  • Node.js 18.0 o superior
  • npm 8.0 o superior (viene con Node.js)
  • Git (para características de control de versiones)

Instalar vía npm​

npm install -g archicore

Verificar Instalación​

archicore --version
# ArchiCore v0.1.0

Autenticación​

Antes de usar ArchiCore, necesitas autenticarte:

archicore login

Esto:

  1. Abrirá tu navegador en la página de inicio de sesión de ArchiCore
  2. Después de iniciar sesión, configurará automáticamente el CLI
  3. Almacenará las credenciales de forma segura

Flujo de Código de Dispositivo (Sin Navegador)​

Para servidores sin navegador:

archicore login --device-code

Esto muestra un código para ingresar en ArchiCore Device Auth.

Inicializar un Proyecto​

Navega al directorio de tu proyecto y ejecuta:

cd /ruta/a/tu/proyecto
archicore init

Esto crea un directorio .archicore/ con la configuración predeterminada.

Actualizar​

npm update -g archicore

Desinstalar​

npm uninstall -g archicore

Para también eliminar la configuración:

rm -rf ~/.archicore

Notas Específicas por Plataforma​

Windows​

Usa PowerShell o Git Bash. El Símbolo del sistema funciona pero tiene características limitadas.

# PowerShell
npm install -g archicore

Linux​

Puede que necesites sudo para instalación global:

sudo npm install -g archicore

O configura npm para usar un directorio local:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
npm install -g archicore

macOS​

npm install -g archicore

Si obtienes errores de permisos:

sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}
npm install -g archicore

Solución de Problemas​

"EACCES: permiso denegado"​

No uses sudo npm install. En su lugar, arregla los permisos de npm:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH

"archicore: comando no encontrado"​

Asegúrate de que el bin global de npm esté en PATH:

export PATH="$(npm bin -g):$PATH"

Añade a ~/.bashrc o ~/.zshrc para hacerlo permanente.

Detrás de un Proxy​

npm config set proxy http://proxy.empresa.com:8080
npm config set https-proxy http://proxy.empresa.com:8080
npm install -g archicore