Aktar
PT
BaixarBaixar

Linha de comando

Faça upload pelo terminal com o aktar

Um comando, um link: aktar upload report.pdf envia o arquivo para o seu próprio bucket pelo app Aktar e mostra a URL, o Markdown ou o JSON completo. Feito para scripts, jobs de CI e editores como o Typora.

Com npm
npm install -g @getaktar/cli
Com Homebrew
brew install getaktar/tap/aktar-cli

Ou experimente sem instalar: npx @getaktar/cli upload file.png

Leia a documentação @getaktar/cli getaktar/cliv0.6.0

aktar upload em um terminal, mostrando links, uma imagem em Markdown e JSON

Comandos

  • aktar upload <file>…

    Envia um ou mais arquivos e mostra um link por arquivo, à medida que cada um termina.

  • --format markdown

    Mostra Markdown, HTML ou o seu modelo personalizado do Aktar em vez da URL simples.

  • --json

    Mostra tudo em JSON: URL, todos os formatos, chave do objeto, tamanho e quando o arquivo expira.

  • -d --folder --expires

    Escolhe um destino pelo nome, envia para uma pasta ou deixa o bucket excluir o arquivo após 1, 7, 14 ou 30 dias.

  • --clipboard

    Envia o arquivo ou a imagem da área de transferência.

  • --name cover

    Envia um único arquivo com outro nome, que o modelo de caminho do destino e o histórico do Aktar passam a usar.

  • --qr aktar qr

    Mostra um código QR abaixo de cada link para abri-lo no celular. aktar qr mostra um para qualquer link ou para um envio do histórico.

  • "reused": true

    Quando o mesmo arquivo já está no bucket, o Aktar devolve o link dele em vez de enviá-lo de novo, e o aktar avisa no stderr.

  • aktar replace

    Grava um arquivo novo por cima de um envio e mantém o link, por ID de envio, link ou chave. Precisa do Aktar para Mac 0.14.0 ou Windows 0.7.0.

  • --short aktar short

    Imprime o link curto do encurtador do próprio destino. aktar short cria um para um envio do histórico. Precisa do Aktar para Mac 0.17.0 ou Windows 0.10.0.

  • aktar mcp aktar skill

    Permite que agentes de IA como Claude, Cursor, VS Code e Codex enviem arquivos, pesquisem seus envios e criem links, como servidor MCP ou com uma skill de agente.

  • aktar login

    Salva o token dos Ajustes do Aktar, depois de verificar que ele funciona.

  • status destinations history

    Mostra a conexão, os seus destinos e um histórico de envios pesquisável.

Todos os comandos, opções e exemplos na documentação

Configure em um minuto

  1. No Aktar para Mac ou Windows, abra Ajustes > Integrações e ative Permitir conexões locais.
  2. Copie o token que aparece ali.
  3. Execute aktar login e cole o token. Pronto: o aktar upload agora usa o destino selecionado no Aktar.

Imagens do Typora no seu próprio bucket

Defina o aktar como o uploader de imagens personalizado do Typora e toda imagem que você colar em um documento é enviada para o seu bucket, com o link escrito no Markdown.

Configurar o Typora

Feito para scripts

Os links vão para a saída padrão, um por linha, e todo o resto vai para a saída de erro, então URL=$(aktar upload build.zip) simplesmente funciona. --json traz todos os detalhes, e o código de saída diz o que aconteceu. No CI, defina AKTAR_TOKEN em vez de fazer login.

Código de saída
0Tudo foi enviado
1Pelo menos um envio falhou; os outros foram concluídos
2Argumentos inválidos ou arquivo inexistente; nada foi enviado
3O Aktar não está acessível, o token está errado ou o app na porta não conseguiu provar que é o Aktar

Suas chaves ficam no Aktar

O CLI nunca vê suas credenciais de armazenamento. Ele envia os arquivos para o app Aktar em 127.0.0.1, que faz o upload com as chaves guardadas no seu Keychain ou no Gerenciador de Credenciais.

A API local do Aktar fica desligada até você ativá-la, nunca aceita conexões de outros computadores e toda requisição precisa do seu token. O CLI guarda o token em um arquivo que só você consegue ler e verifica que o app na porta é mesmo o Aktar antes de enviá-lo.

Requisitos

  • Aktar para Mac 0.18.0 ou Aktar para Windows 0.11.0 ou posterior, com pelo menos um destino (o aktar 0.5.0 e anteriores funcionam com o Aktar para Mac 0.4.0 ou posterior)
  • Node.js 18 ou posterior (o Homebrew instala para você)
  • Reutilizar links de arquivos já enviados: Aktar para Mac 0.10.0 ou Aktar para Windows 0.3.0
  • aktar replace: aktar 0.3.0 e Aktar para Mac 0.14.0 ou Windows 0.7.0
  • aktar mcp e aktar skill: aktar 0.4.0
  • Links curtos: aktar 0.5.0 e Aktar para Mac 0.17.0 ou Windows 0.10.0
  • Open source (MIT) no GitHub

Perguntas

O CLI funciona sem o app Aktar?

Não. Ele é um controle remoto do app: o Aktar guarda as chaves de armazenamento e faz o envio, então precisa estar aberto com Permitir conexões locais ativado. É também por isso que o CLI nunca precisa das suas chaves de acesso.

Posso usar no CI ou em um servidor?

Só onde o Aktar roda, já que o CLI conversa com ele na mesma máquina. Em um agente de build Mac ou Windows isso funciona bem; em um servidor Linux, use o CLI do seu próprio provedor.

Quais armazenamentos ele suporta?

Todos que o Aktar suporta: Amazon S3, Cloudflare R2, Backblaze B2, DigitalOcean Spaces, MinIO e qualquer serviço compatível com S3. Veja os guias de configuração.

Claude, Cursor ou outros agentes de IA podem usá-lo?

Sim. aktar mcp é um servidor MCP: adicione-o com claude mcp add aktar -- aktar mcp --root ~/Projects (ou com a configuração JSON da documentação) e seu agente poderá enviar arquivos, pesquisar seus envios e criar links temporários. --root é a pasta da qual ele pode enviar, segredos como chaves SSH e arquivos .env nunca são enviados, --allow-replace permite substituir um arquivo mantendo o link, e --read-only deixa de fora tudo o que grava. Para agentes sem MCP, aktar skill imprime uma skill que os ensina a usar o CLI.

Onde o token fica guardado?

Em ~/.config/aktar/cli.json no Mac (%APPDATA%\aktar\cli.json no Windows), com leitura permitida só para o seu usuário. aktar logout remove o token, e gerar um novo token no Aktar desconecta todos os clientes.

Novidades deste app

Todas as mudanças para CLI & MCP Feed RSS de CLI & MCP