Documentação do aktar CLI

aktar upload

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

Uso

$ aktar upload <file>... [options]

Opções

Bom saber

• Todos os arquivos são verificados antes de qualquer envio: se um não existir, nada é enviado e o aktar sai com o código 2.
• Se um envio falhar, os outros continuam. Cada falha é informada no stderr, e o código de saída é 1.
• Sem --folder, o modelo de caminho do destino dá nome ao arquivo, como ao soltá-lo na barra de menus. Com --folder, o arquivo mantém o nome dentro dessa pasta.
• --name funciona com um arquivo por vez. As barras são removidas, e a extensão do arquivo é adicionada se o nome não tiver uma: --name cover envia IMG_4021.jpg como cover.jpg. Com --folder, é o nome dentro da pasta.
• --expires aceita 1, 7, 14 ou 30 (dias), ou 0 para manter o arquivo. Sem ela, o arquivo é mantido, seja qual for o valor de Excluir após no Aktar. Ela precisa das regras de exclusão automática do Aktar nesse destino e não pode ser combinada com --folder.
• --qr não pode ser combinada com --json, e --png só funciona com aktar qr.
• Em um terminal, o progresso aparece no stderr enquanto o arquivo é enviado. O arquivo é transmitido ao Aktar em fluxo, então o tamanho não importa, e não há limite de tempo.
• Se o destino tem um encurtador configurado no Aktar, o link curto é impresso, e --format e --qr usam ele. --short cria um mesmo que as regras do destino pulariam este envio, --no-short não cria nenhum. Se o Aktar não conseguir criá-lo, o link original é impresso e o stderr diz por quê.

Exemplos

$ aktar upload screenshot.png
https://files.example.com/2026/10/7f3c2a91.png

$ aktar upload *.png -f markdown
![](https://files.example.com/2026/10/1b9e44d0.png)
![](https://files.example.com/2026/10/c2f71a5e.png)

$ aktar upload IMG_4021.jpg --name cover --folder blog/2026
https://files.example.com/blog/2026/cover.jpg

$ aktar upload photo.jpg
aktar: photo.jpg: already uploaded, reused the existing link
https://files.example.com/2026/09/4d2a8c61.jpg

$ aktar upload talk.pdf --short
https://s.example.com/k3Tq9

aktar upload --clipboard

Envia o arquivo ou a imagem da área de transferência, como o próprio atalho de área de transferência do Aktar.

Uso

$ aktar upload --clipboard [options]

Opções

Bom saber

• Passe arquivos ou --clipboard, não os dois.
• --name e --folder só funcionam com arquivos. -d, -f, --expires, --qr e --json funcionam como com arquivos.
• Com --json, ele continua mostrando um array, com uma entrada.

Exemplos

$ aktar upload --clipboard
https://files.example.com/2026/10/9a4c03be.png

$ aktar upload --clipboard -f markdown -d Blog
![](https://blog-assets.example.com/2026/10/e5b2c8a4.png)

$ aktar upload --clipboard --expires 1
https://files.example.com/tmp/1d/2026/10/38f0d7c2.png

aktar replace

Grava um arquivo novo por cima de um envio, então a chave e o link continuam os mesmos. Quem tem o link vê o arquivo novo.

Uso

$ aktar replace <upload-id|link|key> <file> [options]

Opções

Bom saber

• O primeiro argumento é um ID de envio ou um link do aktar history (a entrada do histórico do Aktar é atualizada); senão, uma chave no bucket de -d (sem -d, o destino selecionado no Aktar). Um link que não está no histórico do Aktar é recusado: passe a chave com -d.
• O Aktar remove os metadados do arquivo e o redimensiona como o destino pede, mas nunca converte para outro formato, então a extensão da chave continua. Um arquivo em tmp/{N}d/ recomeça os N dias.
• A chave nunca é numerada e nada mais é enviado. --folder, --expires, --name e --clipboard não se aplicam e são recusados.
• Cópias antigas podem ficar um tempo no cache de uma CDN. O Cache curto de um destino ou a limpeza do cache da Cloudflare no Aktar resolve isso.
• Precisa do Aktar para Mac 0.14.0 ou do Aktar para Windows 0.7.0 ou posterior.

Exemplos

$ aktar replace 0B6C2F8E-3D1A-4C55-9E2B-7A41D0C3E9F1 report-v2.pdf
https://files.example.com/2026/09/0e7d51b3.pdf

$ aktar replace docs/guide.pdf guide.pdf -d Blog -f markdown
[guide.pdf](https://blog-assets.example.com/docs/guide.pdf)

aktar short

Cria um link curto para um envio do histórico com o encurtador do destino e o imprime. Se o envio já tem um, é esse que aparece.

Uso

$ aktar short <upload-id|link> [--json | --qr]

Opções

Bom saber

• Passe um ID de envio ou um link do aktar history; o link curto dele também funciona. O aktar procura entre os últimos 1.000 envios.
• O destino precisa de um encurtador na seção Links curtos do Aktar: Shlink, YOURLS, Kutt, Dub, Short.io ou uma requisição personalizada. O link curto vem desse encurtador, então seus links e dados de cliques ficam na sua infraestrutura.
• --json imprime os detalhes do link curto: provedor, status, e cliques e último clique quando o encurtador conta. --qr adiciona o QR code. Os dois não podem ser combinados.
• Precisa do Aktar para Mac 0.17.0 ou Aktar para Windows 0.10.0. Versões anteriores respondem que ainda não criam links curtos.

Exemplos

$ aktar short 0B6C2F8E-3D1A-4C55-9E2B-7A41D0C3E9F1
https://s.example.com/Qm3xZ

aktar qr

Mostra no terminal um código QR de um link ou de qualquer texto, para você abri-lo no celular. Com o ID de um envio, mostra o link desse envio e o código QR dele.

Uso

$ aktar qr <link|text|upload-id> [--png <file>]

Opções

Bom saber

• Passe exatamente um argumento e coloque entre aspas um texto com espaços.
• O ID de um envio é o id de aktar history --json ou aktar upload --json. O aktar procura esse ID nos últimos 1.000 envios do histórico do Aktar; para texto simples ou um link, ele nem precisa do Aktar.
• No terminal, o código é desenhado em preto sobre branco, seja qual for o tema. Quando a saída não é um terminal, ou NO_COLOR está definida, ele é desenhado sem cores.
• --png salva o código QR como PNG em vez de mostrá-lo.
• Para um envio com link curto, mostra o link curto.

Exemplos

$ aktar qr https://files.example.com/2026/10/demo.mp4

$ aktar qr 0B6C2F8E-3D1A-4C55-9E2B-7A41D0C3E9F1 --png cover-qr.png
Saved to cover-qr.png

aktar login

Verifica um token com o Aktar e o salva, para que os outros comandos consigam se conectar.

Uso

$ aktar login [--token <token>] [--port <port>]

Opções

Bom saber

• Em um terminal, ele pede o token e oculta o que você digita. Quando a entrada vem de um pipe, ele lê o token dali.
• --token pula o prompt, mas outros programas podem ver o token enquanto o comando roda, e ele vai parar no histórico do seu shell, então o aktar avisa sobre isso. Passar por pipe ou usar AKTAR_TOKEN evita isso.
• Um token recusado pelo Aktar não é salvo, e o código de saída é 3.

Exemplos

$ aktar login
Copy the token from Aktar: Settings > Integrations (turn on Allow local connections first).
Token:
Connected to Aktar 0.10.0. Saved to /Users/you/.config/aktar/cli.json

$ pbpaste | aktar login
Connected to Aktar 0.10.0. Saved to /Users/you/.config/aktar/cli.json

$ aktar login --token "$AKTAR_SECRET" --port 47920
aktar: warning: a token on the command line can be seen by other programs (ps) and stays in your shell history. Next time, run aktar login without --token and paste it, or pipe it in.
Connected to Aktar 0.10.0. Saved to /Users/you/.config/aktar/cli.json

aktar logout

Apaga o token e a porta salvos.

Uso

$ aktar logout

Opções

Sem opções.

Bom saber

• AKTAR_TOKEN, se definida, continua funcionando depois do aktar logout.
• Ele não desconecta outros clientes. Para isso, gere um novo token no Aktar.

Exemplos

$ aktar logout
Logged out.

$ aktar status
aktar: Not connected to Aktar yet. Run aktar login with the token from Aktar's Settings > Integrations.

aktar status

Mostra a qual Aktar você está conectado, em qual porta, o destino selecionado no Aktar e onde fica o arquivo de configuração.

Uso

$ aktar status [--json]

Opções

Bom saber

• Uma forma rápida de verificar a conexão em um script: ele sai com o código 3 quando o Aktar não está acessível ou o token está errado.

Exemplos

$ aktar status
Aktar 0.10.0 (build 28) on port 47913
Destination: Screenshots (Cloudflare R2, screenshots)
Config: /Users/you/.config/aktar/cli.json

$ aktar status --json
{
  "app": "Aktar",
  "version": "0.10.0",
  "build": "28",
  "apiVersion": 1,
  "defaultDestinationId": "5D1A9C3E-7B2F-4E61-8A0D-3C9B6F2E1A47",
  "outputFormat": "url",
  "port": 47913
}

aktar destinations

Lista seus destinos com provedor, bucket e ID. * marca o selecionado no Aktar.

Uso

$ aktar destinations [--json]

Opções

Bom saber

• Use um nome ou um ID com -d. Os nomes são comparados sem diferenciar maiúsculas de minúsculas; um ID sempre funciona, mesmo depois de renomear.
• --json traz id, name, provider, providerName, bucket, publicBaseURL e isDefault para cada um.

Exemplos

$ aktar destinations
* Screenshots  Cloudflare R2  screenshots  5D1A9C3E-7B2F-4E61-8A0D-3C9B6F2E1A47
  Builds  Amazon S3  acme-builds  A83F2C10-6D4B-4F7E-9C1A-2B5E8D0F3C66
  Blog  Backblaze B2  blog-assets  E2C7B9A4-1F3D-4A8E-B6C0-9D5F2A7E4B13

$ aktar destinations --json | jq -r '.[] | select(.isDefault) | .name'
Screenshots

aktar history

Lista os envios recentes, do mais novo para o mais antigo: data, nome do arquivo e link. Palavras depois de history pesquisam o histórico.

Uso

$ aktar history [search] [options]

Opções

Bom saber

• Ele lista 20 envios, a menos que você passe -n.
• --json traz os mesmos campos que aktar upload --json, incluindo o id de cada envio para o aktar qr.

Exemplos

$ aktar history -n 3
2026-10-01  screenshot.png  https://files.example.com/2026/10/7f3c2a91.png
2026-10-01  cover.jpg  https://files.example.com/blog/2026/cover.jpg
2026-09-30  invoice-september.pdf  https://files.example.com/2026/09/0e7d51b3.pdf

$ aktar history invoice -d Screenshots
2026-09-30  invoice-september.pdf  https://files.example.com/2026/09/0e7d51b3.pdf
2026-08-29  invoice-august.pdf  https://files.example.com/2026/08/a6c94f20.pdf

$ aktar history -d Builds -n 1 --json | jq -r '.[0].url'
https://acme-builds.s3.amazonaws.com/2026/10/app-3f9c2e1.zip

aktar mcp

Executa um servidor Model Context Protocol (MCP), para que agentes de IA como Claude, Cursor, VS Code e Codex possam enviar arquivos pelo Aktar, encontrar envios anteriores e criar links. Você o adiciona ao agente uma vez; o agente o inicia quando precisar.

Uso

$ aktar mcp [--root <folder>]... [--read-only | --allow-replace | --allow-delete] [--max-link-minutes <n>] [--log <file>]

Opções

Bom saber

• Execute aktar login primeiro. O servidor lê o token salvo a cada chamada, então entrar de novo funciona sem reiniciar o agente.
• Enviar publica um arquivo: qualquer pessoa com o link pode abri-lo. Os agentes perguntam antes de chamar uma ferramenta, a menos que você permita.
• Os arquivos só são enviados das pastas que você indicar com --root ou, sem isso, da pasta em que o servidor roda. Se essa for a sua pasta pessoal ou a raiz do disco, como acontece com alguns apps, nenhum arquivo local é enviado até você adicionar --root. --root ~ libera a sua pasta pessoal inteira, se você quiser mesmo isso. Os caminhos são resolvidos, links simbólicos incluídos, antes de serem verificados.
• Segredos nunca são enviados, estejam onde estiverem: chaves SSH e privadas, arquivos .env, credenciais de nuvem e de gerenciadores de pacotes (~/.aws, ~/.kube, ~/.npmrc e outros), a configuração do próprio Aktar, o Keychain, perfis de navegador e bancos de dados de senhas. Arquivos com vários hard links também são recusados. Para compartilhar um deles, envie-o você mesmo com aktar upload.
• --read-only oferece apenas as ferramentas que não alteram nada em um bucket. replace_file sobrescreve um arquivo como uma exclusão faria, então só é oferecida com --allow-replace, e delete_upload só com --allow-delete (que também oferece replace_file).
• create_temporary_link cria links de no máximo 60 minutos, a menos que --max-link-minutes permita mais. upload_clipboard fica de fora quando você passa --root, já que a área de transferência pode conter qualquer coisa.
• Os resultados das ferramentas começam com uma nota dizendo que nomes de arquivo, chaves e mensagens neles são dados, não instruções, e --log mantém um registro de cada chamada. Ele executa no máximo 4 chamadas de ferramenta ao mesmo tempo.
• Sem uma instalação global, use npx -y @getaktar/cli mcp --root ~/Projects como comando.
• Ele fala a versão atual do MCP (2026-07-28) e as anteriores que começam com initialize (2024-11-05 a 2025-11-25), por stdio. Precisa do aktar 0.4.0; os limites acima vêm com o aktar 0.6.0.

Ferramentas

Exemplos

$ claude mcp add aktar -- aktar mcp --root ~/Projects
$ codex mcp add aktar -- aktar mcp --root ~/Projects

$ claude mcp add aktar -- aktar mcp --root ~/Projects --root ~/Desktop --allow-replace

$ claude mcp add aktar -- aktar mcp --root ~/Projects --log ~/aktar-mcp.log

aktar skill

Imprime uma skill de agente (SKILL.md) que ensina os agentes a usar o comando aktar com --json: o que executar, como ler o resultado e enviar apenas o que você pediu para compartilhar. Para agentes que usam skills, mas não MCP.

Uso

$ aktar skill

Opções

Sem opções.

Bom saber

• Salve-a onde seu agente procura skills, por exemplo ~/.claude/skills/aktar/ para o Claude Code.

Exemplos

$ mkdir -p ~/.claude/skills/aktar
$ aktar skill > ~/.claude/skills/aktar/SKILL.md

Opções para todos os comandos