Fast.io

fastio

Una interfaz de línea de comandos para la plataforma de almacenamiento en la nube Fastio. Construida en Rust para velocidad, fiabilidad y soporte multiplataforma.

Instalación

npm (recomendado)

npm install -g @vividengine/fastio-cli

O ejecútalo sin instalarlo:

npx @vividengine/fastio-cli --help

Script de shell

curl -fsSL https://raw.githubusercontent.com/MediaFire/fastio_cli/main/install.sh | sh

Descarga de binarios

Los binarios precompilados para macOS, Linux y Windows están disponibles en la página de Releases.

Desde el código fuente

Requiere Rust 1.88+ (edición 2024):

cargo install --path .

Inicio rápido

# Log in (opens browser for PKCE authentication)
fastio auth login

# Or log in with email/password
fastio auth login --email user@example.com --password ****

# Check auth status
fastio auth status

# List organizations
fastio org list

# Create a workspace
fastio workspace create --org <org_id> "My Workspace"

# Upload a file
fastio upload file --workspace <workspace_id> ./document.pdf

# Download a file
fastio download file --workspace <workspace_id> <node_id> --output ./downloads/

# Ask the AI about your workspace
fastio ai chat --workspace <workspace_id> "What files do I have?"

# Log out
fastio auth logout

Autenticación

La CLI admite múltiples métodos de autenticación, verificados en este orden:

1. --token bandera (token bearer de un solo uso)
2. FASTIO_TOKEN variable de entorno
3. FASTIO_API_KEY variable de entorno
4. Credenciales almacenadas de --profile (o perfil predeterminado)

Inicio de sesión con navegador PKCE (recomendado)

fastio auth login

# Request an admin (`rwa`) access mode, or a read-only one
fastio auth login --admin
fastio auth login --read-only

# Also request permission to change account settings (`userdetails:*:rw`)
fastio auth login --account-settings

Abre tu navegador para una autenticación OAuth segura. Los tokens se almacenan localmente y se renuevan automáticamente.

--admin y --read-only solicitan un techo, no un rol: la página de consentimiento puede otorgar menos de lo que pediste. Ejecuta fastio auth scopes después para ver en vivo lo que la credencial puede hacer — fastio auth status solo muestra los alcances almacenados en caché cuando el perfil inició sesión.

Inicio de sesión con correo electrónico/contraseña

fastio auth login --email user@example.com --password ****

Clave API

# Create an API key
fastio auth api-key create --name "CI pipeline"

# Create one scoped to a single organization, with admin access
fastio auth api-key create --name "release bot" --org 1234567890123456789 --admin

# Use it for subsequent commands
export FASTIO_API_KEY=your-key-here
fastio org list

Los alcances son cadenas entity_type:entity_id:access_mode, donde el modo de acceso es r, rw o rwa (administrador). --org / --workspace / --share (repetibles) y --all seleccionan las entidades, --admin / --read-only establecen el modo de acceso, y --account-settings agrega userdetails:*:rw para cambios de contraseña, correo electrónico y registro de 2FA — rwa solo no otorga esos permisos. Un api-key update reemplaza todo el conjunto de alcances de la clave, así que ejecuta fastio auth api-key get <key-id> primero y vuelve a declarar cada alcance que deba conservar. Si esos alcances no usan todos el mismo modo de acceso, vuelve a declararlos con la forma cruda --scopes '[...]': --admin y --read-only se aplican a cada entidad en la solicitud, por lo que ninguno puede expresar un conjunto mixto. Un --admin general eleva un alcance de solo lectura a administrador junto con el que querías elevar; un --read-only general degrada un alcance de escritura o administrador junto con el que querías reducir. fastio auth oauth narrow <session-id> cede autoridad en una sesión de inicio de sesión y surte efecto en su próxima renovación de token.

Autenticación de dos factores

# Check 2FA status
fastio auth 2fa status

# Enable 2FA
fastio auth 2fa setup --channel totp

# Verify 2FA code after login
fastio auth 2fa verify --code <CODE>

Formatos de salida

Todos los comandos admiten --format para controlar la salida:

# Table format (default for terminals)
fastio org list

# Markdown format (default when piped; optimized for LLM consumers)
fastio org list | cat

# JSON format (for scripts that parse structured output)
fastio org list --format json

# CSV format
fastio org list --format csv

# Explicit markdown (GitHub-flavored, byte-equivalent to the server's ?output=markdown)
fastio org list --format markdown
# `--format md` is accepted as an alias

# Filter specific fields
fastio org list --fields name,id,description

Markdown reemplazó a JSON como el valor predeterminado sin TTY el 2026-04-15. La salida renderizada es byte-equivalente a lo que la API de Fastio produce para ?output=markdown: un preámbulo **Result:** success|failure, errores con valor de objeto promovidos a una sección # Error inicial, y cada clave de nivel superior restante como una sección H1 en orden de inserción. Los arreglos de registros asociativos se renderizan como tablas de tuberías GFM (unión de claves en orden de inserción); las listas escalares se renderizan como listas con viñetas.

Nota sobre el escape: los valores de viñetas y el texto de los encabezados no están escapados — el renderizador adopta un enfoque ligero que coincide con el contrato del servidor, porque la salida está destinada a leerse o renderizarse, no a incrustarse en otro markdown. Los consumidores posteriores que rendericen la salida a HTML DEBEN sanitizarla. El renderizador sí elimina los caracteres de control Unicode bidireccionales, de ancho cero y C0/C1 como defensa contra Trojan-Source; las celdas de tabla escapan |, \, `, y nuevas líneas; el contenido de celdas similar a HTML se envuelve en cercas de código en línea.

Las canalizaciones que necesitan salida analizable por máquina pueden volver a optar por --format json.

Comandos

Autenticación y usuario

Grupo	Descripción
auth	Inicio de sesión, cierre de sesión, 2FA, claves API, sesiones OAuth
user	Perfil de usuario, búsqueda, activos, invitaciones
configure	Perfiles y configuración de la CLI

Organizaciones y espacios de trabajo

Grupo	Descripción
org	CRUD de organización, facturación, miembros, tokens de transferencia, descubrimiento, activos
workspace	CRUD de espacio de trabajo, búsqueda, límites, jobs-status (consultar trabajos asíncronos)
member	Gestión de miembros del espacio de trabajo/compartición
invitation	Listar, aceptar, rechazar, eliminar invitaciones; join acepta o rechaza una por su clave de correo electrónico
dashboard	Fuente de tarjetas del panel por espacio de trabajo: obtener, descartar, restaurar

Archivos y almacenamiento

Grupo	Descripción
search	Búsqueda unificada — una consulta en un espacio de trabajo o compartido, agrupada en cubos files / metadata / comments. Comienza aquí para cualquier "encontrar X"
files	Listar, crear carpetas, mover, copiar, renombrar, eliminar, papelera, versiones, búsqueda (lista de archivos plana, --workspace o --share), content (el texto extraído de un archivo como fragmentos direccionables — relevancia --query, --page, --chunk-from/--chunk-to o --nodes para puntuar hasta 10 archivos a la vez), bloqueo
upload	Carga de archivos (fragmentada con progreso), carga de texto, importación por URL, gestión de sesiones
download	Descarga de archivos (transmisión con progreso), ZIP de carpetas, lote
lock	Adquirir, verificar estado, latido, liberar bloqueos de archivos
metadata	Extracción y búsqueda de metadatos: eligible, details, search y extract asíncrono de un solo archivo (GASTA CRÉDITOS DE IA — necesita --confirm-ai-spend; --wait consulta hasta un estado terminal)

Comparticiones y colaboración

Grupo	Descripción
share	CRUD de compartición, archivos, miembros, autenticación por contraseña
fileshare	Comparticiones de archivos — comparticiones de enlace de archivo único duraderas (reemplaza al QuickShare retirado): crear/listar/información/actualizar/eliminar, concesiones, descarga/versiones/vista previa, escritura de carga, actividad, token ws
comment	Comentarios, respuestas, reacciones, adjuntos
event	Eventos de actividad, búsqueda, consulta
preview	URLs de vista previa de archivos y transformaciones
asset	Gestión de activos de organización/espacio de trabajo/usuario

IA

Grupo	Descripción
ripley	Agente de IA delegado de Fastio — preguntar, chatear, historial, gestión de mensajes, summary, transactions (ai es un alias oculto). Buscar no es un verbo de Ripley — usa search

Plataforma

Grupo	Descripción
apps	Listado de aplicaciones, detalles, lanzamiento
import	Proveedores de importación en la nube, identidades, fuentes, trabajos, escrituras
intents	Intenciones de agente — anuncia lo que estás haciendo para que los pares lo vean antes de colisionar: allocate, list, fill, get, release
mcp	Iniciar servidor MCP integrado para agentes de IA
completions	Generar completaciones de shell (bash, zsh, fish, PowerShell)

Utilidades

Grupo	Descripción
how-to	Respuestas fundamentadas de "cómo hago…" sobre Fastio mismo (alias howto)
id	Inspeccionar identificadores de Fastio sin conexión (sin autenticación, sin red): clasificar el tipo de entidad y la familia de un id
view	Renderizar una sola nota o nodo de archivo .md en la terminal
skill	Imprimir la guía de habilidades del agente integrado
system	Verificaciones de salud de la API: ping, status (sin autenticación requerida)

Modo servidor MCP

La CLI incluye un servidor Model Context Protocol integrado para la integración con agentes de IA. Ejecútalo como un subproceso:

fastio mcp

Esto expone la superficie de herramientas enrutadas por acciones de la CLI como herramientas MCP a través de stdio, compatible con Claude Desktop, VS Code y otros clientes compatibles con MCP. Algunas operaciones de alto riesgo o de bytes locales (firma de envío/anulación, escritura de carga de compartición de archivos y token ws) permanecen solo en la CLI, y la herramienta de firma aparece solo cuando E-Sign está habilitado.

Las respuestas de las herramientas se renderizan como Markdown con sabor a GitHub por defecto, byte-equivalente a la salida ?output=markdown de la API de Fastio. Markdown es sustancialmente más eficiente en tokens para LLMs que JSON con formato bonito, por lo que el servidor MCP lo usa para cada lectura y respuesta de estado.

{
  "mcpServers": {
    "fastio": {
      "command": "fastio",
      "args": ["mcp"]
    }
  }
}

Filtra qué herramientas están disponibles:

fastio mcp --tools auth,org,workspace,files,upload,download

La autenticación y el backend siguen las reglas estándar de la CLI: el servidor respeta las banderas globales --api-base, --token y --profile (y las variables de entorno FASTIO_TOKEN / FASTIO_API_KEY), para que puedas apuntarlo a un backend o perfil no predeterminado — por ejemplo, fastio --profile staging mcp o fastio --api-base https://api.example/current mcp.

Completaciones de shell

Genera completaciones de shell para tu shell:

# Bash
fastio completions bash > ~/.bash_completion.d/fastio

# Zsh
fastio completions zsh > ~/.zfunc/_fastio

# Fish
fastio completions fish > ~/.config/fish/completions/fastio.fish

# PowerShell
fastio completions powershell > _fastio.ps1

Perfiles

Gestiona múltiples cuentas con perfiles nombrados:

# Set up a profile interactively
fastio configure init

# Log in to a specific profile
fastio auth login --profile work

# Use a profile for a command
fastio org list --profile work

# Set default profile
fastio configure set-default work

# List all profiles
fastio configure list

Opciones globales

Bandera	Descripción
--format json|table|csv|markdown	Formato de salida (markdown es el predeterminado cuando se canaliza)
--fields name,id,...	Filtrar campos de salida
--detail terse|standard|full	Verbosidad de respuesta del lado del servidor a través de ?output=<detail>; cuando se omite, el servidor devuelve su forma full
--no-color	Deshabilitar salida de color
--quiet / -q	Suprimir toda la salida
--verbose / -v	Aumentar verbosidad; repetible (-v información, -vv depuración, -vvv rastrear llamadas API)
--profile <name>	Usar perfil nombrado
--token <jwt>	Token bearer de un solo uso
--api-base <url>	Anular URL base de la API
--version / -V	Imprimir versión (solo comando raíz, por ejemplo, fastio --version)

Configuración

Los archivos de configuración se almacenan en el directorio de configuración de la plataforma, bajo una carpeta fastio-cli: $XDG_CONFIG_HOME/fastio-cli (típicamente ~/.config/fastio-cli) en Linux, ~/Library/Application Support/fastio-cli en macOS y %APPDATA%\fastio-cli en Windows:

Archivo	Propósito
config.json	Configuración de perfil y URL base de la API
credentials.json	Tokens de autenticación almacenados

Licencia

Licencia Apache 2.0. Consulta LICENSE para más detalles.