Fast.io
Compartilhamento e colaboração de arquivos com foco em IA. 251 ferramentas MCP oferecem aos agentes um espaço de trabalho completo: armazenamento de arquivos, compartilhamentos personalizados, comentários, fluxos de trabalho e RAG integrado. 50GB grátis, sem cartão de crédito.
Documentação
fastio
Uma interface de linha de comando para a plataforma de armazenamento em nuvem Fastio. Construída em Rust para velocidade, confiabilidade e suporte multiplataforma.
Instalação
npm (recomendado)
npm install -g @vividengine/fastio-cli
Ou execute sem instalar:
npx @vividengine/fastio-cli --help
Script de shell
curl -fsSL https://raw.githubusercontent.com/MediaFire/fastio_cli/main/install.sh | sh
Download do binário
Binários pré-compilados para macOS, Linux e Windows estão disponíveis na página de Releases.
A partir do código-fonte
Requer Rust 1.88+ (edição 2024):
cargo install --path .
Início 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
Autenticação
A CLI suporta múltiplos métodos de autenticação, verificados nesta ordem:
- Flag
--token(token bearer pontual) - Variável de ambiente
FASTIO_TOKEN - Variável de ambiente
FASTIO_API_KEY - Credenciais armazenadas de
--profile(ou perfil padrão)
Login via 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 seu navegador para autenticação OAuth segura. Os tokens são armazenados localmente e renovados automaticamente.
--admin e --read-only solicitam um teto, não um papel: a página de consentimento pode conceder menos do que você pediu. Execute fastio auth scopes depois para ver a visão ao vivo do que a credencial pode fazer — fastio auth status mostra apenas os escopos em cache quando o perfil fez login.
Login com E-mail/Senha
fastio auth login --email user@example.com --password ****
Chave de 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
Os escopos são strings entity_type:entity_id:access_mode, onde o modo de acesso é r, rw ou rwa (admin). --org / --workspace / --share (repetíveis) e --all selecionam as entidades, --admin / --read-only definem o modo de acesso, e --account-settings adiciona userdetails:*:rw para alterações de senha, e-mail e cadastro de 2FA — rwa sozinho não concede esses recursos. Um api-key update substitui todo o conjunto de escopos da chave, então execute fastio auth api-key get <key-id> primeiro e reafirme todos os escopos que ela deve manter. Se esses escopos não usarem todos o mesmo modo de acesso, reafirme-os com a forma bruta --scopes '[...]': --admin e --read-only se aplicam a todas as entidades na solicitação, então nenhum deles pode expressar um conjunto misto. Um --admin abrangente eleva um escopo somente leitura para admin junto com aquele que você pretendia elevar; um --read-only abrangente rebaixa um escopo gravável ou admin junto com aquele que você pretendia restringir. fastio auth oauth narrow <session-id> abre mão de autoridade em uma sessão de login e tem efeito na próxima renovação de token.
Autenticação de Dois Fatores
# 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 Saída
Todos os comandos suportam --format para controlar a saída:
# 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 substituiu JSON como o padrão não-TTY em 15/04/2026. A
saída renderizada é byte-equivalente ao que a API Fastio produz
para ?output=markdown: um preâmbulo **Result:** success|failure,
erros com valor de objeto promovidos a uma seção # Error inicial, e cada
chave de nível superior restante como uma seção H1 em ordem de inserção. Arrays de
registros associativos são renderizados como tabelas de pipe GFM (união de chaves em
ordem de inserção); listas escalares são renderizadas como listas com marcadores.
Nota sobre escape: valores de marcadores e texto de cabeçalho não são escapados —
o renderizador adota uma abordagem leve alinhada ao contrato do servidor,
porque a saída é destinada a leitura ou renderização, não a incorporação em
outro markdown. Consumidores downstream que renderizam a saída para HTML
DEVEM sanitizar. O renderizador remove caracteres de controle Unicode bidi, largura zero e
C0/C1 como defesa contra Trojan Source; células de tabela escapam
|, \, `, e novas linhas; conteúdo de célula semelhante a HTML é envolvido em
cercas de código inline.
Pipelines que precisam de saída analisável por máquina podem optar de volta com
--format json.
Comandos
Autenticação e Usuário
| Grupo | Descrição |
|---|---|
auth | Login, logout, 2FA, chaves de API, sessões OAuth |
user | Perfil do usuário, busca, ativos, convites |
configure | Perfis e configurações da CLI |
Organizações e Espaços de Trabalho
| Grupo | Descrição |
|---|---|
org | CRUD de organização, cobrança, membros, tokens de transferência, descoberta, ativos |
workspace | CRUD de espaço de trabalho, busca, limites, jobs-status (consultar trabalhos assíncronos) |
member | Gerenciamento de membros do espaço de trabalho/compartilhamento |
invitation | Listar, aceitar, recusar, excluir convites; join aceita ou recusa um pela sua chave de e-mail |
dashboard | Feed de cartões do painel por espaço de trabalho: obter, dispensar, desfazer dispensa |
Arquivos e Armazenamento
| Grupo | Descrição |
|---|---|
search | Busca unificada — uma consulta em um espaço de trabalho ou compartilhamento, agrupada em buckets files / metadata / comments. Comece aqui para qualquer "encontrar X" |
files | Listar, criar pastas, mover, copiar, renomear, excluir, lixeira, versões, busca (lista plana de arquivos, --workspace ou --share), content (texto extraído de um arquivo como blocos endereçáveis — relevância --query, --page, --chunk-from/--chunk-to ou --nodes para pontuar até 10 arquivos de uma vez), bloqueio |
upload | Upload de arquivo (em partes com progresso), upload de texto, importação por URL, gerenciamento de sessão |
download | Download de arquivo (streaming com progresso), ZIP de pasta, lote |
lock | Adquirir, verificar status, heartbeat, liberar bloqueios de arquivo |
metadata | Extração e busca de metadados: eligible, details, search e extract assíncrono de arquivo único (GASTA CRÉDITOS DE IA — requer --confirm-ai-spend; --wait consulta até um estado terminal) |
Compartilhamentos e Colaboração
| Grupo | Descrição |
|---|---|
share | CRUD de compartilhamento, arquivos, membros, autenticação por senha |
fileshare | Compartilhamentos de Arquivo — compartilhamentos duráveis de link de arquivo único (substitui o QuickShare descontinuado): criar/listar/informar/atualizar/excluir, concessões, download/versões/pré-visualização, gravação de upload, atividade, ws-token |
comment | Comentários, respostas, reações, anexos |
event | Eventos de atividade, busca, consulta |
preview | URLs de pré-visualização de arquivo e transformações |
asset | Gerenciamento de ativos de organização/espaço de trabalho/usuário |
IA
| Grupo | Descrição |
|---|---|
ripley | Agente de IA delegado da Fastio — perguntar, conversar, histórico, gerenciamento de mensagens, summary, transactions (ai é um alias oculto). Buscar não é um verbo do Ripley — use search |
Plataforma
| Grupo | Descrição |
|---|---|
apps | Listagem de aplicativos, detalhes, inicialização |
import | Provedores de importação em nuvem, identidades, fontes, trabalhos, gravações |
intents | Intenções de Agente — anuncie o que você está fazendo para que colegas vejam antes de colidirem: allocate, list, fill, get, release |
mcp | Iniciar servidor MCP integrado para agentes de IA |
completions | Gerar completions de shell (bash, zsh, fish, PowerShell) |
Utilitários
| Grupo | Descrição |
|---|---|
how-to | Respostas fundamentadas de "como faço…" sobre a própria Fastio (alias howto) |
id | Inspecionar identificadores Fastio offline (sem autenticação, sem rede): classificar o tipo de entidade e família de um id |
view | Renderizar uma única nota ou nó de arquivo .md no terminal |
skill | Imprimir o guia de habilidades do agente integrado |
system | Verificações de saúde da API: ping, status (sem autenticação necessária) |
Modo Servidor MCP
A CLI inclui um servidor Model Context Protocol integrado para integração com agentes de IA. Execute-o como um subprocesso:
fastio mcp
Isso expõe a superfície de ferramentas roteadas por ação da CLI como ferramentas MCP via stdio, compatível com Claude Desktop, VS Code e outros clientes compatíveis com MCP. Algumas operações de alto risco ou de bytes locais (assinatura de envio/anulação, upload de arquivo compartilhado com gravação e ws-token) permanecem apenas na CLI, e a ferramenta de assinatura aparece apenas quando o E-Sign está habilitado.
As respostas das ferramentas são renderizadas como Markdown no estilo GitHub por padrão,
byte-equivalente à saída ?output=markdown da API Fastio.
Markdown é substancialmente mais eficiente em tokens para LLMs do que
JSON com indentação, então o servidor MCP o usa para cada resposta de leitura e
status.
{
"mcpServers": {
"fastio": {
"command": "fastio",
"args": ["mcp"]
}
}
}
Filtre quais ferramentas estão disponíveis:
fastio mcp --tools auth,org,workspace,files,upload,download
Autenticação e backend seguem as regras padrão da CLI: o servidor honra as
flags globais --api-base, --token e --profile (e as variáveis de ambiente FASTIO_TOKEN /
FASTIO_API_KEY), então você pode apontá-lo para um backend ou perfil não padrão —
por exemplo, fastio --profile staging mcp ou
fastio --api-base https://api.example/current mcp.
Completions de Shell
Gere completions de shell para o seu 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
Perfis
Gerencie múltiplas contas com perfis nomeados:
# 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
Opções Globais
| Flag | Descrição |
|---|---|
--format json|table|csv|markdown | Formato de saída (markdown é o padrão quando canalizado) |
--fields name,id,... | Filtrar campos de saída |
--detail terse|standard|full | Verbosidade da resposta do servidor via ?output=<detail>; quando omitido, o servidor retorna sua forma full |
--no-color | Desabilitar saída colorida |
--quiet / -q | Suprimir toda a saída |
--verbose / -v | Aumentar verbosidade; repetível (-v info, -vv debug, -vvv rastrear chamadas de API) |
--profile <name> | Usar perfil nomeado |
--token <jwt> | Token bearer pontual |
--api-base <url> | Substituir URL base da API |
--version / -V | Imprimir versão (apenas comando raiz, ex.: fastio --version) |
Configuração
Os arquivos de configuração são armazenados no diretório de configuração da plataforma, sob uma pasta fastio-cli: $XDG_CONFIG_HOME/fastio-cli (tipicamente ~/.config/fastio-cli) no Linux, ~/Library/Application Support/fastio-cli no macOS e %APPDATA%\fastio-cli no Windows:
| Arquivo | Finalidade |
|---|---|
config.json | Configurações de perfil e URL base da API |
credentials.json | Tokens de autenticação armazenados |
Licença
Apache License 2.0. Consulte LICENSE para detalhes.