? v2.5.0 — VIRO Edition — 2026-08-26
Binarios disponibles en filecage.com/cli/linux y filecage.com/cli/windows
Cliente de línea de comandos para FileCage API — sube, descarga, lista y elimina archivos desde la terminal, en Windows y Linux, sin dependencias.
filecage-cli es un binario compilado en Go que interactúa con la FileCage API. Se distribuye como ejecutable único — sin instalación, sin runtime externo.
Fue diseñado para:
A partir de v2.0.0, el CLI incluye VIRO, una mascota ASCII interactiva que cambia de estado según el comando ejecutado.
list upload download delete
+---------+ +---------+ | +---------+ ¦ +---------+
¦ - - ¦ ¦ 0 0 ¦/ \ ¦ 0 0 ¦ ¦ ¦ X X ¦
¦ ___ ¦ ¦ \___/ ¦ ¦ ¦ . ¦ ¦ ¦ --- ¦
¦ +-+ ¦ ¦ +-+ ¦ ¦ ¦ +-+ ¦\ / ¦ +-+ ¦
+---------+ +---------+ ¦ +---------+ | +---------+
Colores ANSI full — compatible con Windows 10+ (PowerShell, Windows Terminal) y cualquier terminal Linux/macOS.
# Linux / macOS — curl
curl -fsSL https://filecage.com/cli/linux -o filecage \
&& chmod +x filecage \
&& sudo mv filecage /usr/local/bin/
# Linux / macOS — wget
wget -q https://filecage.com/cli/linux -O filecage \
&& chmod +x filecage \
&& sudo mv filecage /usr/local/bin/
# Windows PowerShell
irm https://filecage.com/cli/windows -OutFile filecage.exe
Move-Item filecage.exe C:\Windows\System32\filecage.exe
| Sistema | URL |
|---|---|
| Linux x64 | https://filecage.com/cli/linux |
| Windows x64 | https://filecage.com/cli/windows |
El cliente se configura mediante variables de entorno. No acepta credenciales como parámetros para evitar que queden expuestas en el historial de comandos.
| Variable | Descripción | Ejemplo |
|---|---|---|
FILECAGE_URL |
URL base de la API | https://filecage.com |
FILECAGE_UID |
UID de la carpeta | U0STN573 |
FILECAGE_PASSWORD |
Contraseña de la carpeta | tu-password |
export FILECAGE_URL=https://filecage.com
export FILECAGE_UID=TU_UID
export FILECAGE_PASSWORD=TU_PASSWORD
$env:FILECAGE_URL = "https://filecage.com"
$env:FILECAGE_UID = "TU_UID"
$env:FILECAGE_PASSWORD = "TU_PASSWORD"
[System.Environment]::SetEnvironmentVariable("FILECAGE_URL", "https://filecage.com", "User")
[System.Environment]::SetEnvironmentVariable("FILECAGE_UID", "TU_UID", "User")
[System.Environment]::SetEnvironmentVariable("FILECAGE_PASSWORD", "TU_PASSWORD", "User")
Go respeta automáticamente las variables de entorno estándar. No hace falta cambiar el código:
export HTTPS_PROXY=http://proxy.empresa.com:1082
$env:HTTPS_PROXY = "http://proxy.empresa.com:1082"
filecage --help
Salida:
+---------+
¦ - - ¦
¦ ___ ¦
¦ +-+ ¦
+---------+
VIRO · filecage CLI v2.5.0
? Servicio: https://filecage.com [ OK · 46ms ]
Variables de entorno requeridas:
FILECAGE_URL URL del servidor https://filecage.com
FILECAGE_UID UID de tu carpeta A1B2C3D4
FILECAGE_PASSWORD Contraseña de la carpeta tu-password
El health check hace GET a /health con timeout de 5 segundos y muestra la latencia en ms.
filecage list
filecage upload -f ./archivo.txt
filecage upload -f /ruta/absoluta/backup.zip
filecage download -f archivo.txt
filecage download -f archivo.txt -o /tmp/destino.txt
filecage delete -f archivo.txt
| Flag | Descripción |
|---|---|
-f |
Nombre o ruta del archivo |
-o |
Ruta de salida (solo download) |
--help |
Muestra VIRO + health check + ayuda |
--version |
Muestra versión |
GOOS=linux GOARCH=amd64 go build -ldflags="-s -w" -o filecage-linux-amd64 .
GOOS=windows GOARCH=amd64 go build -ldflags="-s -w" -o filecage-windows-amd64.exe .
| Paquete | Uso |
|---|---|
net/http |
Cliente HTTP (stdlib) |
mime/multipart |
Upload multipart (stdlib) |
github.com/joho/godotenv |
Carga de .env |
github.com/spf13/cobra |
Parsing de comandos y flags |
github.com/fatih/color |
ANSI colors cross-platform (Windows + Linux) |
| Versión | Fecha | Cambios |
|---|---|---|
| v1.0.0 | 2026-08-26 | Release inicial — list, upload, download, delete |
| v2.0.0 | 2026-08-26 | VIRO mascota ASCII con ANSI colors |
| v2.5.0 | 2026-08-26 | Health check en --help, env vars documentadas, sin tagline |
Página vinculada: FileCage API