Documentación de la CLI aktar

aktar upload

Sube uno o varios archivos y muestra un enlace por archivo, en orden, a medida que terminan.

Uso

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

Opciones

Conviene saber

• Todos los archivos se comprueban antes de subir nada: si uno no existe, no se sube ninguno y aktar termina con el código 2.
• Si una subida falla, las demás siguen adelante. Cada fallo se indica en stderr, y el código de salida es 1.
• Sin --folder, la plantilla de ruta del destino pone el nombre al archivo, igual que al soltarlo en la barra de menús. Con --folder, el archivo conserva su nombre dentro de esa carpeta.
• --name funciona con un solo archivo cada vez. Se quitan las barras, y se añade la extensión del archivo si el nombre no la tiene: --name cover sube IMG_4021.jpg como cover.jpg. Con --folder, es el nombre dentro de la carpeta.
• --expires admite 1, 7, 14 o 30 (días), o 0 para conservar el archivo. Sin esta opción, el archivo se conserva, tenga lo que tenga Eliminar tras en Aktar. Necesita las reglas de eliminación automática de Aktar en ese destino y no se puede combinar con --folder.
• --qr no se puede combinar con --json, y --png solo funciona con aktar qr.
• En una terminal, el progreso aparece en stderr mientras se sube un archivo. El archivo se envía a Aktar como un flujo, así que su tamaño da igual, y no hay límite de tiempo.
• Si el destino tiene un acortador configurado en Aktar, se imprime el enlace corto, y --format y --qr lo usan. --short crea uno aunque las reglas del destino se saltarían esta subida, --no-short no crea ninguno. Si Aktar no puede crearlo, se imprime el enlace original y stderr dice por qué.

Ejemplos

$ 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

Sube el archivo o la imagen que tengas en el portapapeles, como el propio atajo de portapapeles de Aktar.

Uso

$ aktar upload --clipboard [options]

Opciones

Conviene saber

• Pasa archivos o --clipboard, no las dos cosas.
• --name y --folder solo funcionan con archivos. -d, -f, --expires, --qr y --json funcionan igual que con archivos.
• Con --json, sigue mostrando un array, con una sola entrada.

Ejemplos

$ 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

Escribe un archivo nuevo sobre una subida, así su clave y su enlace siguen igual. Quien tenga el enlace ve el archivo nuevo.

Uso

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

Opciones

Conviene saber

• El primer argumento es un ID de subida o un enlace de aktar history (se actualiza la entrada del historial de Aktar), o si no una clave en el bucket de -d (sin -d, el destino seleccionado en Aktar). Un enlace que no está en el historial de Aktar se rechaza: indica su clave con -d.
• Aktar quita los metadatos del archivo y lo redimensiona según el destino, pero nunca lo convierte a otro formato, así que la extensión de la clave se mantiene. Un archivo bajo tmp/{N}d/ vuelve a empezar sus N días.
• La clave nunca se numera y no se sube nada más. --folder, --expires, --name y --clipboard no se aplican y se rechazan.
• Las copias antiguas pueden quedarse un rato en la caché de una CDN. La Caché corta de un destino o la limpieza de la caché de Cloudflare en Aktar se ocupan de eso.
• Necesita Aktar para Mac 0.14.0 o Aktar para Windows 0.7.0 o posterior.

Ejemplos

$ 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

Crea un enlace corto para una subida del historial con el acortador de su destino y lo imprime. Si la subida ya tiene uno, imprime ese.

Uso

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

Opciones

Conviene saber

• Pasa un ID de subida o un enlace de aktar history; su enlace corto también sirve. aktar lo busca entre las últimas 1.000 subidas.
• El destino necesita un acortador en la sección Enlaces cortos de Aktar: Shlink, YOURLS, Kutt, Dub, Short.io o una petición personalizada. El enlace corto sale de ese acortador, así que tus enlaces y datos de clics se quedan en tu infraestructura.
• --json imprime los detalles del enlace corto: proveedor, estado, y clics y último clic cuando el acortador los cuenta. --qr añade su código QR. No se pueden combinar.
• Necesita Aktar para Mac 0.17.0 o Aktar para Windows 0.10.0. Las versiones anteriores responden que aún no crean enlaces cortos.

Ejemplos

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

aktar qr

Muestra en la terminal un código QR de un enlace o de cualquier texto, para abrirlo en el móvil. Con el ID de una subida, muestra el enlace de esa subida y su código QR.

Uso

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

Opciones

Conviene saber

• Pasa exactamente un argumento, y pon entre comillas el texto con espacios.
• El ID de una subida es el id de aktar history --json o aktar upload --json. aktar lo busca entre las últimas 1.000 subidas del historial de Aktar; para texto o un enlace, no necesita Aktar en absoluto.
• En una terminal, el código se dibuja en negro sobre blanco, sea cual sea su tema. Cuando la salida no es una terminal, o NO_COLOR está definida, se dibuja sin colores.
• --png guarda el código QR como PNG en lugar de mostrarlo.
• Para una subida con enlace corto, muestra el enlace corto.

Ejemplos

$ 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

Comprueba un token con Aktar y lo guarda, para que los demás comandos puedan conectarse.

Uso

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

Opciones

Conviene saber

• En una terminal, te pide el token y oculta lo que escribes. Cuando la entrada llega por una tubería, lee el token de ahí.
• --token se salta el aviso, pero otros programas pueden ver el token mientras se ejecuta el comando y acaba en el historial de tu shell, así que aktar te lo advierte. Pasarlo por una tubería o usar AKTAR_TOKEN lo evita.
• Un token que Aktar rechaza no se guarda, y el código de salida es 3.

Ejemplos

$ 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

Elimina el token y el puerto guardados.

Uso

$ aktar logout

Opciones

Sin opciones.

Conviene saber

• AKTAR_TOKEN, si está definida, sigue funcionando después de aktar logout.
• No desconecta a otros clientes. Para eso, regenera el token en Aktar.

Ejemplos

$ 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

Muestra a qué Aktar estás conectado, en qué puerto, el destino seleccionado en Aktar y dónde está el archivo de configuración.

Uso

$ aktar status [--json]

Opciones

Conviene saber

• Una forma rápida de comprobar la conexión en un script: termina con el código 3 si no se puede contactar con Aktar o el token no es correcto.

Ejemplos

$ 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

Muestra tus destinos con su proveedor, bucket e ID. * marca el seleccionado en Aktar.

Uso

$ aktar destinations [--json]

Opciones

Conviene saber

• Usa un nombre o un ID con -d. Los nombres no distinguen entre mayúsculas y minúsculas; un ID siempre funciona, incluso después de cambiar el nombre.
• --json da id, name, provider, providerName, bucket, publicBaseURL e isDefault de cada uno.

Ejemplos

$ 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

Muestra las subidas recientes, de la más nueva a la más antigua: fecha, nombre de archivo y enlace. Las palabras que pongas después de history buscan en el historial.

Uso

$ aktar history [search] [options]

Opciones

Conviene saber

• Muestra 20 subidas salvo que pases -n.
• --json da los mismos campos que aktar upload --json, incluido el id de cada subida para aktar qr.

Ejemplos

$ 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

Ejecuta un servidor Model Context Protocol (MCP), para que agentes de IA como Claude, Cursor, VS Code y Codex puedan subir archivos con Aktar, encontrar subidas anteriores y crear enlaces. Lo añades una vez a tu agente; el agente lo inicia cuando lo necesita.

Uso

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

Opciones

Conviene saber

• Ejecuta primero aktar login. El servidor lee el token guardado en cada llamada, así que volver a iniciar sesión funciona sin reiniciar el agente.
• Subir un archivo lo publica: cualquiera con su enlace puede abrirlo. Los agentes preguntan antes de llamar a una herramienta salvo que lo permitas.
• Los archivos solo se suben desde las carpetas que indiques con --root, o si no, desde la carpeta en la que se ejecuta el servidor. Si esa es tu carpeta de inicio o la raíz del disco, como hacen algunas apps, no se sube ningún archivo local hasta que añadas --root. --root ~ permite toda tu carpeta de inicio, si de verdad lo quieres. Las rutas se resuelven, enlaces simbólicos incluidos, antes de comprobarse.
• Los secretos nunca se suben, estén donde estén: claves SSH y privadas, archivos .env, credenciales de la nube y de gestores de paquetes (~/.aws, ~/.kube, ~/.npmrc y otros), la propia configuración de Aktar, el llavero, los perfiles del navegador y las bases de datos de contraseñas. También se rechazan los archivos con varios enlaces físicos. Para compartir uno de ellos, súbelo tú mismo con aktar upload.
• --read-only ofrece solo las herramientas que no cambian nada en un bucket. replace_file sobrescribe un archivo igual que lo haría un borrado, así que solo se ofrece con --allow-replace, y delete_upload solo con --allow-delete (que también ofrece replace_file).
• create_temporary_link crea enlaces de 60 minutos como máximo, salvo que --max-link-minutes permita más. upload_clipboard se omite cuando indicas --root, porque el portapapeles puede contener cualquier cosa.
• Los resultados de las herramientas empiezan con una nota que dice que los nombres de archivo, claves y mensajes que contienen son datos, no instrucciones, y --log guarda un registro de cada llamada. Ejecuta como mucho 4 llamadas a herramientas a la vez.
• Sin instalación global, usa npx -y @getaktar/cli mcp --root ~/Projects como comando.
• Habla la versión actual de MCP (2026-07-28) y las anteriores que empiezan con initialize (de 2024-11-05 a 2025-11-25), por stdio. Necesita aktar 0.4.0; los límites descritos arriba llegaron con aktar 0.6.0.

Herramientas

Ejemplos

$ 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 un skill de agente (SKILL.md) que enseña a los agentes a usar el comando aktar con --json: qué ejecutar, cómo leer el resultado y subir solo lo que pediste compartir. Para agentes que usan skills pero no MCP.

Uso

$ aktar skill

Opciones

Sin opciones.

Conviene saber

• Guárdalo donde tu agente busca skills, por ejemplo ~/.claude/skills/aktar/ para Claude Code.

Ejemplos

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

Opciones para todos los comandos