Documentation de la CLI aktar

aktar upload

Envoie un ou plusieurs fichiers et affiche un lien par fichier, dans l'ordre, au fur et à mesure.

Utilisation

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

Options

Bon à savoir

• Tous les fichiers sont vérifiés avant le moindre envoi : si l'un d'eux n'existe pas, rien n'est envoyé et aktar se termine avec le code 2.
• Si un envoi échoue, les autres aboutissent quand même. Chaque échec est signalé sur stderr, et le code de sortie est 1.
• Sans --folder, c'est le modèle de chemin de la destination qui nomme le fichier, comme pour un dépôt sur la barre des menus. Avec --folder, le fichier garde son nom dans ce dossier.
• --name fonctionne avec un seul fichier à la fois. Les barres obliques sont retirées, et l'extension du fichier est ajoutée si le nom n'en a pas : --name cover envoie IMG_4021.jpg sous le nom cover.jpg. Avec --folder, c'est le nom dans le dossier.
• --expires accepte 1, 7, 14 ou 30 (jours), ou 0 pour conserver le fichier. Sans cette option, le fichier est conservé, quel que soit le réglage Supprimer après dans Aktar. Elle nécessite les règles de suppression automatique d'Aktar sur cette destination, et ne se combine pas avec --folder.
• --qr ne se combine pas avec --json, et --png ne fonctionne qu'avec aktar qr.
• Dans un terminal, la progression s'affiche sur stderr pendant l'envoi. Le fichier est transmis à Aktar en flux continu : sa taille n'a pas d'importance, et il n'y a pas de limite de temps.
• Si la destination a un raccourcisseur configuré dans Aktar, c’est le lien court qui est affiché, et --format et --qr l’utilisent. --short en crée un même si les règles de la destination ignoreraient cet envoi, --no-short n’en crée aucun. Si Aktar ne peut pas le créer, le lien d’origine est affiché et stderr indique pourquoi.

Exemples

$ 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

Envoie le fichier ou l'image du presse-papiers, comme le raccourci presse-papiers d'Aktar.

Utilisation

$ aktar upload --clipboard [options]

Options

Bon à savoir

• Passez des fichiers ou --clipboard, pas les deux.
• --name et --folder ne fonctionnent qu'avec des fichiers. -d, -f, --expires, --qr et --json fonctionnent comme avec des fichiers.
• Avec --json, la sortie reste un tableau, avec une seule entrée.

Exemples

$ 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

Écrit un nouveau fichier par-dessus un envoi, si bien que sa clé et son lien restent les mêmes. Tous ceux qui ont le lien voient le nouveau fichier.

Utilisation

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

Options

Bon à savoir

• Le premier argument est un ID d’envoi ou un lien tiré de aktar history (l’entrée de l’historique d’Aktar est mise à jour), sinon une clé dans le bucket de -d (sans -d, la destination sélectionnée dans Aktar). Un lien absent de l’historique d’Aktar est refusé : indiquez plutôt sa clé avec -d.
• Aktar retire les métadonnées du fichier et le redimensionne comme le veut la destination, mais ne le convertit jamais dans un autre format : l’extension de la clé reste. Un fichier sous tmp/{N}d/ recommence ses N jours.
• La clé n’est jamais numérotée et rien d’autre n’est envoyé. --folder, --expires, --name et --clipboard ne s’appliquent pas et sont refusés.
• D’anciennes copies peuvent rester un moment dans le cache d’un CDN. Le Cache de courte durée d’une destination ou le vidage du cache Cloudflare dans Aktar s’en charge.
• Nécessite Aktar pour Mac 0.14.0 ou Aktar pour Windows 0.7.0 ou ultérieur.

Exemples

$ 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

Crée un lien court pour un envoi de l’historique avec le raccourcisseur de sa destination, et l’affiche. Si l’envoi en a déjà un, c’est celui-là qui est affiché.

Utilisation

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

Options

Bon à savoir

• Passez un ID d’envoi ou un lien de aktar history ; son lien court fonctionne aussi. aktar le cherche parmi les 1 000 derniers envois.
• La destination doit avoir un raccourcisseur dans la section Liens courts d’Aktar : Shlink, YOURLS, Kutt, Dub, Short.io ou une requête personnalisée. Le lien court vient de ce raccourcisseur : vos liens et vos données de clics restent dans votre infrastructure.
• --json affiche les détails du lien court : fournisseur, état, et clics et dernier clic quand le raccourcisseur les compte. --qr ajoute son QR code. Les deux ne peuvent pas être combinés.
• Nécessite Aktar pour Mac 0.17.0 ou Aktar pour Windows 0.10.0. Les versions plus anciennes répondent qu’elles ne créent pas encore de liens courts.

Exemples

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

aktar qr

Affiche dans le terminal le code QR d'un lien ou de n'importe quel texte, pour l'ouvrir sur un téléphone. Avec l'ID d'un envoi, affiche le lien de cet envoi et son code QR.

Utilisation

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

Options

Bon à savoir

• Passez exactement un argument, et mettez entre guillemets un texte qui contient des espaces.
• L'ID d'un envoi est le champ id de aktar history --json ou aktar upload --json. aktar le cherche parmi les 1 000 derniers envois de l'historique d'Aktar ; pour du texte ou un lien, Aktar n'est pas nécessaire du tout.
• Dans un terminal, le code est dessiné en noir sur blanc, quel que soit le thème. Quand la sortie n'est pas un terminal, ou si NO_COLOR est défini, il est dessiné sans couleurs.
• --png enregistre le code QR en PNG au lieu de l'afficher.
• Pour un envoi qui a un lien court, il affiche le lien court.

Exemples

$ 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

Vérifie un jeton auprès d'Aktar et l'enregistre, pour que les autres commandes puissent se connecter.

Utilisation

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

Options

Bon à savoir

• Dans un terminal, la commande demande le jeton et masque la saisie. Quand l'entrée vient d'un pipe, elle lit le jeton depuis celui-ci.
• --token évite l'invite, mais d'autres programmes peuvent voir le jeton pendant que la commande s'exécute, et il se retrouve dans l'historique de votre shell : aktar vous en avertit donc. Le passer par un pipe ou par AKTAR_TOKEN évite cela.
• Un jeton refusé par Aktar n'est pas enregistré, et le code de sortie est 3.

Exemples

$ 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

Supprime le jeton et le port enregistrés.

Utilisation

$ aktar logout

Options

Aucune option.

Bon à savoir

• AKTAR_TOKEN, s'il est défini, fonctionne toujours après aktar logout.
• Cela ne déconnecte pas les autres clients. Pour cela, régénérez le jeton dans Aktar.

Exemples

$ 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

Indique à quel Aktar vous êtes connecté, sur quel port, la destination sélectionnée dans Aktar et l'emplacement du fichier de configuration.

Utilisation

$ aktar status [--json]

Options

Bon à savoir

• Un moyen rapide de vérifier la connexion dans un script : la commande se termine avec le code 3 quand Aktar est injoignable ou que le jeton est incorrect.

Exemples

$ 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

Liste vos destinations avec leur fournisseur, leur bucket et leur ID. * marque celle sélectionnée dans Aktar.

Utilisation

$ aktar destinations [--json]

Options

Bon à savoir

• Utilisez un nom ou un ID avec -d. Les noms sont comparés sans tenir compte de la casse ; un ID fonctionne toujours, même après un renommage.
• --json donne id, name, provider, providerName, bucket, publicBaseURL et isDefault pour chacune.

Exemples

$ 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

Liste les envois récents, du plus récent au plus ancien : date, nom du fichier et lien. Les mots placés après history lancent une recherche dans l'historique.

Utilisation

$ aktar history [search] [options]

Options

Bon à savoir

• Elle liste 20 envois, sauf si vous passez -n.
• --json donne les mêmes champs que aktar upload --json, y compris l'id de chaque envoi pour aktar qr.

Exemples

$ 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

Lance un serveur Model Context Protocol (MCP), pour que des agents IA comme Claude, Cursor, VS Code et Codex puissent envoyer des fichiers via Aktar, retrouver d'anciens envois et créer des liens. Vous l'ajoutez une fois à votre agent ; l'agent le démarre quand il en a besoin.

Utilisation

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

Options

Bon à savoir

• Lancez d'abord aktar login. Le serveur lit le jeton enregistré à chaque appel, donc se reconnecter fonctionne sans redémarrer l'agent.
• Envoyer un fichier le publie : toute personne ayant son lien peut l'ouvrir. Les agents demandent confirmation avant d'appeler un outil, sauf si vous l'autorisez.
• Les fichiers ne sont envoyés que depuis les dossiers indiqués avec --root, ou à défaut depuis le dossier où tourne le serveur. Si c'est votre dossier personnel ou la racine du disque, comme avec certaines apps, aucun fichier local n'est envoyé tant que vous n'ajoutez pas --root. --root ~ autorise tout votre dossier personnel, si vous le voulez vraiment. Les chemins sont résolus, liens symboliques compris, avant d'être vérifiés.
• Les secrets ne sont jamais envoyés, où qu'ils se trouvent : clés SSH et clés privées, fichiers .env, identifiants cloud et de gestionnaires de paquets (~/.aws, ~/.kube, ~/.npmrc et d'autres), la configuration d'Aktar lui-même, le trousseau, les profils de navigateur et les bases de mots de passe. Les fichiers qui ont plusieurs liens physiques sont aussi refusés. Pour partager l'un d'eux, envoyez-le vous-même avec aktar upload.
• --read-only ne propose que les outils qui ne modifient rien dans un bucket. replace_file écrase un fichier comme le ferait une suppression : il n'est donc proposé qu'avec --allow-replace, et delete_upload qu'avec --allow-delete (qui propose aussi replace_file).
• create_temporary_link crée des liens de 60 minutes au plus, sauf si --max-link-minutes autorise davantage. upload_clipboard est exclu quand vous indiquez --root, car le presse-papiers peut contenir n'importe quoi.
• Les résultats des outils commencent par une note précisant que les noms de fichiers, clés et messages qu'ils contiennent sont des données, pas des instructions, et --log garde une trace de chaque appel. Il exécute au plus 4 appels d'outils à la fois.
• Sans installation globale, utilisez npx -y @getaktar/cli mcp --root ~/Projects comme commande.
• Il parle la version actuelle de MCP (2026-07-28) et les précédentes qui commencent par initialize (2024-11-05 à 2025-11-25), via stdio. Nécessite aktar 0.4.0 ; les limites ci-dessus sont arrivées avec aktar 0.6.0.

Outils

Exemples

$ 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

Affiche un skill d'agent (SKILL.md) qui apprend aux agents à utiliser la commande aktar avec --json : quoi lancer, comment lire le résultat, et n'envoyer que ce que vous avez demandé de partager. Pour les agents qui utilisent des skills mais pas MCP.

Utilisation

$ aktar skill

Options

Aucune option.

Bon à savoir

• Enregistrez-le là où votre agent cherche ses skills, par exemple ~/.claude/skills/aktar/ pour Claude Code.

Exemples

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

Options communes à toutes les commandes