Overzicht
aktar is een afstandsbediening voor de Aktar-app op dezelfde computer. Je geeft het bestanden, het geeft ze door aan Aktar op 127.0.0.1, en Aktar uploadt ze met de bestemmingen, sleutels, padsjablonen en linkinstellingen die je al hebt ingesteld. De link komt terug in je terminal.
Wat het is
- Een klein Node.js-commando voor scripts, CI-jobs op je eigen Mac of Windows-computer en editors zoals Typora
- Een manier om bestanden en het klembord te uploaden, QR-codes te tonen en je bestemmingen en uploadgeschiedenis op te vragen
- Gratis en open source (MIT), net als de app
Wat het niet is
- Niet zelfstandig: zonder draaiende Aktar kan het niets uploaden. Het bewaart nooit je opslagsleutels
- Niet voor Linux-servers of externe machines: het praat alleen met Aktar op dezelfde computer. Gebruik daar de eigen CLI van je opslagprovider
Vereisten
- Aktar voor Mac 0.18.0 of Aktar voor Windows 0.11.0 of nieuwer, met minstens één bestemming. aktar 0.5.0 en ouder werken met Aktar voor Mac 0.4.0 of nieuwer
- Node.js 18 of nieuwer (Homebrew installeert het voor je)
-
--name,--qrenaktar qrvereisen aktar 0.2.0 of nieuwer - De link hergebruiken van een bestand dat al geüpload is, vereist aktar 0.2.0 en Aktar voor Mac 0.10.0 of Aktar voor Windows 0.3.0
-
aktar replacevereist aktar 0.3.0 en Aktar voor Mac 0.14.0 of Aktar voor Windows 0.7.0 of nieuwer -
--short,--no-shortenaktar shorthebben aktar 0.5.0 en Aktar voor Mac 0.17.0 of Aktar voor Windows 0.10.0 nodig, met een linkverkorter op de bestemming
Installeren
Installeer het één keer, met npm of Homebrew. Allebei zetten ze het commando aktar in je pad.
Met npm (macOS en Windows)
npm install -g @getaktar/cliMet Homebrew (macOS)
brew install getaktar/tap/aktar-cliOf voer het één keer uit zonder iets te installeren:
npx @getaktar/cli upload file.pngControleer welke versie je hebt:
aktar --version
0.6.0Verbinden met Aktar
- Open in Aktar voor Mac of Windows Instellingen > Integraties en zet Sta lokale verbindingen toe aan. Aktar luistert dan alleen op
127.0.0.1, poort 47913, tenzij je die daar wijzigt. - Kopieer het token dat eronder staat.
- Voer
aktar loginuit en plak het token bij de promptToken:. Het blijft verborgen terwijl je typt, en het wordt bij Aktar gecontroleerd voordat het wordt opgeslagen, dus een typfout wordt niet bewaard.
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.jsonWaar het token wordt bewaard
aktar login slaat het token en de poort op in ~/.config/aktar/cli.json op een Mac (of in $XDG_CONFIG_HOME/aktar/cli.json als je die hebt ingesteld) en in %APPDATA%\aktar\cli.json op Windows. Alleen jouw gebruiker kan het lezen.
Voordat aktar het token verstuurt, vraagt het de app op de poort te bewijzen dat die hetzelfde token heeft, zonder het te versturen. Draait Aktar niet en luistert er een ander programma op die poort, dan krijgt dat programma dus noch het token, noch je bestanden. Dit vereist Aktar voor Mac 0.18.0 of Aktar voor Windows 0.11.0 of nieuwer; met een oudere Aktar stopt aktar en vraagt het je om bij te werken.
aktar logout verwijdert dat bestand. Om alle clients in één keer buiten te sluiten, klik je in Aktar op Genereer opnieuw naast het token; voer daarna aktar login opnieuw uit met het nieuwe token.
Scripts en CI
Sla op een buildmachine aktar login over en stel AKTAR_TOKEN in (en AKTAR_PORT als je de poort hebt gewijzigd). Die gaan voor het opgeslagen bestand. Aktar moet op die machine draaien, ingelogd in dezelfde gebruikerssessie.
AKTAR_TOKEN="$AKTAR_SECRET" aktar upload dist/app.zip -d Builds| Variabele | Wat het doet |
|---|---|
AKTAR_TOKEN | Het token uit Instellingen > Integraties van Aktar. Wordt gebruikt in plaats van het opgeslagen token. |
AKTAR_PORT | De poort van Aktars lokale API, als je die hebt gewijzigd. --port gaat ervoor. |
NO_COLOR | Tekent QR-codes met gewone tekens in plaats van terminalkleuren. |
XDG_CONFIG_HOME | Waar de configuratiemap staat op macOS (standaard ~/.config). Op Windows wordt %APPDATA% gebruikt. |
Commando's
Alle commando's praten met Aktar, behalve aktar qr met gewone tekst of een link. Zonder -d gaan uploads naar de bestemming die in de menubalk van Aktar is geselecteerd, en ze verschijnen in Aktars geschiedenis zoals elke andere upload. aktar --help toont dezelfde lijst. Met Aktar voor Mac 0.14.0 of Aktar voor Windows 0.7.0 of nieuwer volgt een upload zonder -d eerst de regels bij Gebruiken voor van de bestemmingen, zodat een afbeelding naar je bestemming voor schermafbeeldingen kan gaan en een build naar een andere.
aktar uploadaktar upload --clipboardaktar replaceaktar shortaktar qraktar loginaktar logoutaktar statusaktar destinationsaktar historyaktar mcpaktar skill
aktar upload
Uploadt een of meer bestanden en toont per bestand één link, in volgorde, zodra elk bestand klaar is.
Gebruik
aktar upload <file>... [options]Opties
| Vlag | Waarde | Beschrijving |
|---|---|---|
-d, --destination | <name|id> | Bestemming om naar te uploaden, op naam of ID. Standaard: de bestemming die in Aktar is geselecteerd. |
-f, --format | <format> | Wat er wordt getoond: url (standaard), markdown, html of custom (je eigen sjabloon in Aktar). |
--name | <name> | Upload één bestand onder deze naam. De extensie blijft behouden als de naam er geen heeft. |
--folder | <path> | Behoud de bestandsnaam en upload naar deze map. |
--expires | <days> | Laat de bucket het bestand na 1, 7, 14 of 30 dagen verwijderen. 0 bewaart het. |
--short | Maak een korte link met de linkverkorter van de bestemming, ook als de regels deze upload zouden overslaan. | |
--no-short | Maak deze keer geen korte link. | |
--qr | Toon ook een QR-code van elke link. | |
--json | Toon een JSON-array met alle details van elke upload, in plaats van links. | |
--port | <port> | De poort van Aktars lokale API, alleen voor dit commando. Gaat voor AKTAR_PORT en de opgeslagen poort. |
Goed om te weten
- Elk bestand wordt gecontroleerd voordat er iets wordt geüpload: als er een niet bestaat, wordt niets geüpload en stopt
aktarmet code 2. - Als één upload mislukt, gaan de andere gewoon door. Elke fout wordt gemeld op stderr, en de exitcode is 1.
- Zonder
--folderbepaalt het padsjabloon van de bestemming de bestandsnaam, net als bij slepen naar de menubalk. Met--folderhoudt het bestand zijn naam in die map. --namewerkt met één bestand tegelijk. Schuine strepen worden verwijderd, en de extensie van het bestand wordt toegevoegd als de naam er geen heeft:--name coveruploadtIMG_4021.jpgalscover.jpg. Met--folderis het de naam in de map.--expiresaccepteert 1, 7, 14 of 30 (dagen), of 0 om het bestand te bewaren. Zonder deze optie blijft het bestand bewaard, wat Verwijder na in Aktar ook is. Het vereist de regels voor automatisch verwijderen van Aktar op die bestemming, en het kan niet worden gecombineerd met--folder.--qrkan niet worden gecombineerd met--json, en--pngwerkt alleen metaktar qr.- In een terminal wordt de voortgang op stderr getoond terwijl een bestand uploadt. Het bestand wordt naar Aktar gestreamd, dus de grootte maakt niet uit, en er is geen tijdslimiet.
- Heeft de bestemming in Aktar een linkverkorter, dan wordt de korte link afgedrukt, en
--formaten--qrgebruiken die.--shortmaakt er een, ook als de regels van de bestemming deze upload zouden overslaan,--no-shortmaakt er geen. Lukt het Aktar niet, dan wordt de oorspronkelijke link afgedrukt en zegt stderr waarom.
Voorbeelden
aktar upload screenshot.png
https://files.example.com/2026/10/7f3c2a91.pngaktar upload *.png -f markdown

aktar upload IMG_4021.jpg --name cover --folder blog/2026
https://files.example.com/blog/2026/cover.jpgaktar upload photo.jpg
aktar: photo.jpg: already uploaded, reused the existing link
https://files.example.com/2026/09/4d2a8c61.jpgaktar upload talk.pdf --short
https://s.example.com/k3Tq9aktar upload --clipboard
Uploadt het bestand of de afbeelding op het klembord, net als de eigen klembordsneltoets van Aktar.
Gebruik
aktar upload --clipboard [options]Opties
| Vlag | Waarde | Beschrijving |
|---|---|---|
--clipboard | Upload wat er op het klembord staat in plaats van bestanden. | |
-d, --destination | <name|id> | Bestemming om naar te uploaden, op naam of ID. Standaard: de bestemming die in Aktar is geselecteerd. |
-f, --format | <format> | Wat er wordt getoond: url (standaard), markdown, html of custom (je eigen sjabloon in Aktar). |
--expires | <days> | Laat de bucket het bestand na 1, 7, 14 of 30 dagen verwijderen. 0 bewaart het. |
--short | Maak een korte link met de linkverkorter van de bestemming, ook als de regels deze upload zouden overslaan. | |
--no-short | Maak deze keer geen korte link. | |
--qr | Toon ook een QR-code van elke link. | |
--json | Toon een JSON-array met alle details van elke upload, in plaats van links. | |
--port | <port> | De poort van Aktars lokale API, alleen voor dit commando. Gaat voor AKTAR_PORT en de opgeslagen poort. |
Goed om te weten
- Geef bestanden of
--clipboardop, niet allebei. --nameen--folderwerken alleen met bestanden.-d,-f,--expires,--qren--jsonwerken zoals bij bestanden.- Met
--jsontoont het nog steeds een array, met één item.
Voorbeelden
aktar upload --clipboard
https://files.example.com/2026/10/9a4c03be.pngaktar upload --clipboard -f markdown -d Blog
aktar upload --clipboard --expires 1
https://files.example.com/tmp/1d/2026/10/38f0d7c2.pngaktar replace
Schrijft een nieuw bestand over een upload heen, zodat de sleutel en de link hetzelfde blijven. Iedereen met de link ziet het nieuwe bestand.
Gebruik
aktar replace <upload-id|link|key> <file> [options]Opties
| Vlag | Waarde | Beschrijving |
|---|---|---|
-d, --destination | <name|id> | Voor een sleutel: de bestemming in wiens bucket die staat, op naam of ID. Standaard: de bestemming die in Aktar is geselecteerd. |
-f, --format | <format> | Wat er wordt getoond: url (standaard), markdown, html of custom (je eigen sjabloon in Aktar). |
--qr | Toon ook een QR-code van elke link. | |
--json | Toon een JSON-array met alle details van elke upload, in plaats van links. | |
--port | <port> | De poort van Aktars lokale API, alleen voor dit commando. Gaat voor AKTAR_PORT en de opgeslagen poort. |
Goed om te weten
- Het eerste argument is een upload-ID of een link uit
aktar history(het geschiedenisitem in Aktar wordt bijgewerkt), of anders een sleutel in de bucket van-d(de bestemming die in Aktar is geselecteerd als je die weglaat). Een link die niet in Aktars geschiedenis staat, wordt geweigerd: geef dan de sleutel op met-d. - Aktar verwijdert de metadata van het bestand en verkleint het zoals de bestemming aangeeft, maar zet het nooit om naar een ander formaat, dus de extensie van de sleutel blijft. Voor een bestand onder
tmp/{N}d/beginnen de N dagen opnieuw. - De sleutel krijgt nooit een nummer en er wordt niets anders geüpload.
--folder,--expires,--nameen--clipboardzijn niet van toepassing en worden geweigerd. - Oude kopieën kunnen nog een tijdje in de cache van een CDN blijven staan. Korte cachetijd van een bestemming of het legen van de Cloudflare-cache in Aktar lost dat op.
- Vereist Aktar voor Mac 0.14.0 of Aktar voor Windows 0.7.0 of nieuwer.
Voorbeelden
aktar replace 0B6C2F8E-3D1A-4C55-9E2B-7A41D0C3E9F1 report-v2.pdf
https://files.example.com/2026/09/0e7d51b3.pdfaktar replace docs/guide.pdf guide.pdf -d Blog -f markdown
[guide.pdf](https://blog-assets.example.com/docs/guide.pdf)aktar short
Maakt met de linkverkorter van de bestemming een korte link voor een upload uit de geschiedenis en drukt die af. Heeft de upload er al een, dan wordt die afgedrukt.
Gebruik
aktar short <upload-id|link> [--json | --qr]Opties
| Vlag | Waarde | Beschrijving |
|---|---|---|
--json | Druk de details van de korte link af als JSON: aanbieder, status en kliks. | |
--qr | Druk ook de QR-code van de korte link af. | |
--port | <port> | De poort van Aktars lokale API, alleen voor dit commando. Gaat voor AKTAR_PORT en de opgeslagen poort. |
Goed om te weten
- Geef een upload-ID of een link uit
aktar history; de korte link werkt ook.aktarzoekt in de laatste 1.000 uploads. - De bestemming heeft een linkverkorter nodig in het onderdeel Korte links van Aktar: Shlink, YOURLS, Kutt, Dub, Short.io of een eigen verzoek. De korte link komt van die verkorter, dus je links en klikgegevens blijven in je eigen infrastructuur.
--jsondrukt de details van de korte link af: aanbieder, status, en kliks en laatste klik als de verkorter die telt.--qrvoegt de QR-code toe. Ze zijn niet te combineren.- Vereist Aktar voor Mac 0.17.0 of Aktar voor Windows 0.10.0. Oudere versies antwoorden dat ze nog geen korte links maken.
Voorbeelden
aktar short 0B6C2F8E-3D1A-4C55-9E2B-7A41D0C3E9F1
https://s.example.com/Qm3xZaktar qr
Toont een QR-code van een link of willekeurige tekst in de terminal, zodat je die op een telefoon kunt openen. Met een upload-ID toont het de link van die upload en de QR-code ervan.
Gebruik
aktar qr <link|text|upload-id> [--png <file>]Opties
| Vlag | Waarde | Beschrijving |
|---|---|---|
--png | <file> | Sla de QR-code op als PNG-bestand in plaats van hem te tonen. |
--port | <port> | De poort van Aktars lokale API, alleen voor dit commando. Gaat voor AKTAR_PORT en de opgeslagen poort. |
Goed om te weten
- Geef precies één argument op, en zet tekst met spaties tussen aanhalingstekens.
- Een upload-ID is de
iduitaktar history --jsonofaktar upload --json.aktarzoekt die op in de laatste 1.000 uploads in Aktars geschiedenis; voor gewone tekst of een link heeft het Aktar helemaal niet nodig. - De code wordt zwart op wit getekend in een terminal, welk thema die ook heeft. Als de uitvoer geen terminal is, of
NO_COLORis ingesteld, wordt hij zonder kleuren getekend. --pngslaat de QR-code op als PNG in plaats van hem te tonen.- Voor een upload met een korte link toont hij de korte link.
Voorbeelden
aktar qr https://files.example.com/2026/10/demo.mp4aktar qr 0B6C2F8E-3D1A-4C55-9E2B-7A41D0C3E9F1 --png cover-qr.png
Saved to cover-qr.pngaktar login
Controleert een token bij Aktar en slaat het op, zodat de andere commando's verbinding kunnen maken.
Gebruik
aktar login [--token <token>] [--port <port>]Opties
| Vlag | Waarde | Beschrijving |
|---|---|---|
--token | <token> | Het token, in plaats van de prompt. |
--port | <port> | De poort van Aktar, opgeslagen samen met het token. Standaard 47913. |
Goed om te weten
- In een terminal vraagt het om het token en verbergt het wat je typt. Als de invoer via een pipe binnenkomt, leest het het token daaruit.
--tokenslaat de prompt over, maar andere programma's kunnen het token zien zolang het commando draait, en het belandt in je shellgeschiedenis, dusaktarwaarschuwt ervoor. Het via een pipe doorgeven ofAKTAR_TOKENvoorkomt dat.- Een token dat Aktar weigert, wordt niet opgeslagen, en de exitcode is 3.
Voorbeelden
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.jsonpbpaste | aktar login
Connected to Aktar 0.10.0. Saved to /Users/you/.config/aktar/cli.jsonaktar waarschuwt dat het token zichtbaar was.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.jsonaktar logout
Verwijdert het opgeslagen token en de poort.
Gebruik
aktar logoutOpties
Geen opties.
Goed om te weten
AKTAR_TOKENwerkt, als het is ingesteld, nog steeds naaktar logout.- Het verbreekt de verbinding van andere clients niet. Genereer daarvoor het token opnieuw in Aktar.
Voorbeelden
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
Toont met welke Aktar je verbonden bent, op welke poort, welke bestemming in Aktar is geselecteerd en waar het configuratiebestand staat.
Gebruik
aktar status [--json]Opties
| Vlag | Waarde | Beschrijving |
|---|---|---|
--json | Toon JSON in plaats van tekst. | |
--port | <port> | De poort van Aktars lokale API, alleen voor dit commando. Gaat voor AKTAR_PORT en de opgeslagen poort. |
Goed om te weten
- Een snelle manier om de verbinding in een script te controleren: het stopt met code 3 als Aktar niet bereikbaar is of het token niet klopt.
Voorbeelden
aktar status
Aktar 0.10.0 (build 28) on port 47913
Destination: Screenshots (Cloudflare R2, screenshots)
Config: /Users/you/.config/aktar/cli.jsonaktar status --json
{
"app": "Aktar",
"version": "0.10.0",
"build": "28",
"apiVersion": 1,
"defaultDestinationId": "5D1A9C3E-7B2F-4E61-8A0D-3C9B6F2E1A47",
"outputFormat": "url",
"port": 47913
}aktar destinations
Toont je bestemmingen met hun provider, bucket en ID. * markeert de bestemming die in Aktar is geselecteerd.
Gebruik
aktar destinations [--json]Opties
| Vlag | Waarde | Beschrijving |
|---|---|---|
--json | Toon JSON in plaats van tekst. | |
--port | <port> | De poort van Aktars lokale API, alleen voor dit commando. Gaat voor AKTAR_PORT en de opgeslagen poort. |
Goed om te weten
- Gebruik een naam of een ID met
-d. Bij namen maakt het niet uit of je hoofdletters of kleine letters gebruikt; een ID werkt altijd, ook na een naamswijziging. --jsongeeft per bestemmingid,name,provider,providerName,bucket,publicBaseURLenisDefault.
Voorbeelden
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-9D5F2A7E4B13aktar destinations --json | jq -r '.[] | select(.isDefault) | .name'
Screenshotsaktar history
Toont recente uploads, nieuwste eerst: datum, bestandsnaam en link. Woorden na history doorzoeken de geschiedenis.
Gebruik
aktar history [search] [options]Opties
| Vlag | Waarde | Beschrijving |
|---|---|---|
-n, --limit | <n> | Hoeveel uploads er worden getoond. Standaard 20. |
-d, --destination | <name|id> | Alleen uploads naar deze bestemming, op naam of ID. |
--json | Toon JSON in plaats van tekst. | |
--port | <port> | De poort van Aktars lokale API, alleen voor dit commando. Gaat voor AKTAR_PORT en de opgeslagen poort. |
Goed om te weten
- Het toont 20 uploads, tenzij je
-nopgeeft. --jsongeeft dezelfde velden alsaktar upload --json, inclusief deidvan elke upload vooraktar qr.
Voorbeelden
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.pdfaktar 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.pdfaktar history -d Builds -n 1 --json | jq -r '.[0].url'
https://acme-builds.s3.amazonaws.com/2026/10/app-3f9c2e1.zipaktar mcp
Draait een Model Context Protocol (MCP)-server, zodat AI-agents zoals Claude, Cursor, VS Code en Codex bestanden via Aktar kunnen uploaden, eerdere uploads kunnen vinden en links kunnen maken. Je voegt hem één keer toe aan je agent; de agent start hem wanneer nodig.
Gebruik
aktar mcp [--root <folder>]... [--read-only | --allow-replace | --allow-delete] [--max-link-minutes <n>] [--log <file>]Opties
| Vlag | Waarde | Beschrijving |
|---|---|---|
--root | <folder> | Upload alleen bestanden uit deze map. Herhaal voor meer mappen. Standaard: de map waarin de server draait, of geen als dat je thuismap of de hoofdmap van de schijf is. |
--read-only | Biedt alleen de tools die niets in een bucket wijzigen: zoeken, lijsten, tijdelijke links en miniaturen. | |
--allow-replace | Biedt ook replace_file, dat een bestand in een bucket overschrijft. | |
--allow-delete | Biedt ook delete_upload, dat een bestand uit zijn bucket verwijdert, en replace_file. | |
--max-link-minutes | <n> | Hoe lang een tijdelijke link hoogstens werkt, in minuten. Standaard 60, hoogstens 10080 (7 dagen). |
--log | <file> | Voegt elke toolaanroep (tijd, tool, argumenten, resultaat) toe aan dit bestand, dat alleen jij kunt lezen. |
--port | <port> | De poort van Aktars lokale API, alleen voor dit commando. Gaat voor AKTAR_PORT en de opgeslagen poort. |
Goed om te weten
- Voer eerst
aktar loginuit. De server leest bij elke aanroep het opgeslagen token, dus opnieuw inloggen werkt zonder de agent te herstarten. - Uploaden publiceert een bestand: iedereen met de link kan het openen. Agents vragen om bevestiging voordat ze een tool aanroepen, tenzij je dat toestaat.
- Bestanden worden alleen geüpload uit de mappen die je met
--rootopgeeft, of anders uit de map waarin de server draait. Is dat je thuismap of de hoofdmap van de schijf, zoals bij sommige apps, dan worden er geen lokale bestanden geüpload totdat je--roottoevoegt.--root ~staat je hele thuismap toe, als je dat echt wilt. Paden worden herleid, symlinks inbegrepen, voordat ze worden gecontroleerd. - Geheimen worden nooit geüpload, waar ze ook staan: SSH- en privésleutels,
.env-bestanden, inloggegevens van cloud- en pakketbeheerders (~/.aws,~/.kube,~/.npmrcen andere), de eigen configuratie van Aktar, de Sleutelhanger, browserprofielen en wachtwoorddatabases. Bestanden met meerdere harde links worden ook geweigerd. Wil je er een van delen, upload het dan zelf metaktar upload. --read-onlybiedt alleen de tools die niets in een bucket wijzigen.replace_fileoverschrijft een bestand zoals verwijderen dat zou doen, dus wordt het alleen aangeboden met--allow-replace, endelete_uploadalleen met--allow-delete(dat ookreplace_fileaanbiedt).create_temporary_linkmaakt links van hoogstens 60 minuten, tenzij--max-link-minutesmeer toestaat.upload_clipboardblijft weg als je--rootopgeeft, omdat het klembord van alles kan bevatten.- Toolresultaten beginnen met een opmerking dat bestandsnamen, sleutels en berichten erin gegevens zijn, geen instructies, en
--loghoudt elke aanroep bij. Er lopen hoogstens 4 toolaanroepen tegelijk. - Zonder globale installatie gebruik je
npx -y @getaktar/cli mcp --root ~/Projectsals commando. - Ondersteunt de huidige MCP-versie (2026-07-28) en de eerdere die met
initializebeginnen (2024-11-05 tot 2025-11-25), via stdio. Vereist aktar 0.4.0; de beperkingen hierboven komen met aktar 0.6.0.
Tools
| Tool | Wat het doet |
|---|---|
upload_file | Uploadt een bestand en geeft de link, Markdown en HTML terug. Bestemming, naam, map en vervaltijd zijn optioneel. short vraagt om een korte link, of om geen. |
upload_clipboard | Uploadt het bestand of de afbeelding op het klembord. short vraagt om een korte link, of om geen. Weggelaten als --root is opgegeven. |
replace_file | Schrijft een nieuw bestand over een upload of een willekeurig bestand in een bucket heen en behoudt de link. Alleen met --allow-replace of --allow-delete. Vereist Aktar voor Mac 0.14.0 of Windows 0.7.0. |
create_short_link | Maakt met de linkverkorter van de bestemming een korte link voor een upload, of geeft de bestaande terug. Weggelaten met --read-only. Vereist Aktar voor Mac 0.17.0 of Windows 0.10.0. |
search_uploads | Doorzoekt de uploadgeschiedenis. |
list_destinations | Toont de bestemmingen en voor welke bestandstypen elke bestemming wordt gebruikt. |
list_bucket | Toont de mappen en bestanden van een bucket, ook bestanden die niet met Aktar zijn geüpload. |
create_temporary_link | Maakt een link die na een tijdje niet meer werkt (een presigned URL). Tot dan kan iedereen met de link het bestand downloaden, ook uit een privébucket. Hoogstens 60 minuten, tenzij --max-link-minutes meer toestaat. |
get_thumbnail | Toont de agent een voorbeeld van een upload. Vereist Aktar voor Mac 0.13.0 of Windows 0.6.0. |
list_watched_folders | Toont de bewaakte mappen en hun status. |
get_status | Controleert de verbinding met Aktar. |
delete_upload | Verwijdert een upload uit zijn bucket. Alleen met --allow-delete. |
Voorbeelden
claude mcp add aktar -- aktar mcp --root ~/Projects
codex mcp add aktar -- aktar mcp --root ~/Projectsclaude mcp add aktar -- aktar mcp --root ~/Projects --root ~/Desktop --allow-replaceclaude mcp add aktar -- aktar mcp --root ~/Projects --log ~/aktar-mcp.logaktar skill
Drukt een agent-skill (SKILL.md) af die agents leert het aktar-commando met --json te gebruiken: wat ze moeten uitvoeren, hoe ze het resultaat lezen en dat ze alleen uploaden wat jij wilde delen. Voor agents die skills gebruiken maar geen MCP.
Gebruik
aktar skillOpties
Geen opties.
Goed om te weten
- Bewaar hem waar je agent naar skills zoekt, bijvoorbeeld
~/.claude/skills/aktar/voor Claude Code.
Voorbeelden
mkdir -p ~/.claude/skills/aktar
aktar skill > ~/.claude/skills/aktar/SKILL.mdOpties voor elk commando
| Vlag | Waarde | Beschrijving |
|---|---|---|
-h, --help | Toon de lijst met commando's en opties. | |
-v, --version | Toon de versie van aktar. | |
--port | <port> | De poort van Aktars lokale API, alleen voor dit commando. Gaat voor AKTAR_PORT en de opgeslagen poort. |
Uitvoer
Formaten
-f bepaalt wat er per upload wordt getoond. Zonder deze optie toont aktar de kale URL, welk formaat de menubalk van Aktar ook kopieert. Markdown en HTML sluiten afbeeldingen in en linken naar al het andere, net zoals Aktar dat doet.
| Formaat | Getoond voor photo.jpg |
|---|---|
-f url | https://files.example.com/2026/10/7f3c2a91.jpgDe link (standaard). |
-f markdown | Een Markdown-afbeelding, of een Markdown-link voor andere bestanden. |
-f html | <img src="https://files.example.com/2026/10/7f3c2a91.jpg" alt="">Een <img>-tag, of een <a>-link voor andere bestanden. |
-f custom | Je sjabloon uit de instellingen van Aktar, met {url}, {filename} en de andere variabelen ingevuld. |
stdout en stderr
Standaarduitvoer krijgt alleen de links, één per regel, in de volgorde van de bestanden (en de QR-codes, met --qr). Al het andere gaat naar standaardfout: voortgang, fouten en meldingen zoals aktar: photo.jpg: already uploaded, reused the existing link. Zo krijgen url=$(aktar upload file) en aktar upload *.png > links.txt altijd schone links.
aktar upload photo.jpg
aktar: photo.jpg: already uploaded, reused the existing link
https://files.example.com/2026/09/4d2a8c61.jpgJSON
--json toont een array met één item per geüpload bestand, nadat ze allemaal klaar zijn. Mislukte uploads worden weggelaten (ze worden op stderr gemeld), dus controleer ook de exitcode.
aktar upload photo.jpg --json
[
{
"id": "0B6C2F8E-3D1A-4C55-9E2B-7A41D0C3E9F1",
"filename": "photo.jpg",
"objectKey": "2026/10/7f3c2a91.jpg",
"url": "https://files.example.com/2026/10/7f3c2a91.jpg",
"shortUrl": null,
"destinationId": "5D1A9C3E-7B2F-4E61-8A0D-3C9B6F2E1A47",
"destinationName": "Screenshots",
"mimeType": "image/jpeg",
"size": 482113,
"createdAt": "2026-10-01T12:00:00Z",
"expiresAt": null,
"formats": {
"url": "https://files.example.com/2026/10/7f3c2a91.jpg",
"markdown": "",
"html": "<img src=\"https://files.example.com/2026/10/7f3c2a91.jpg\" alt=\"\">",
"custom": ""
},
"reused": false
}
]| Veld | Betekenis |
|---|---|
id | De ID van de upload in Aktars geschiedenis. aktar qr accepteert die. |
filename | De bestandsnaam waaronder Aktar het bestand kent: de eigen naam, of --name. |
objectKey | Waar het bestand in de bucket staat. |
url | De link. |
shortUrl | De korte link, of null als er geen is. formats gebruiken hem al. |
destinationId | De ID van de bestemming. |
destinationName | De naam van de bestemming. |
mimeType | Het type van het bestand, na een eventuele omzetting door Aktar. |
size | Grootte in bytes, zoals opgeslagen. |
createdAt | Wanneer het is geüpload (ISO 8601, UTC). |
expiresAt | Wanneer de bucket het verwijdert, of null als het bewaard blijft. |
replacedAt | Wanneer het bestand voor het laatst is vervangen (ISO 8601, UTC). Ontbreekt tot het wordt vervangen, en bij Aktar-versies vóór Mac 0.14.0 en Windows 0.7.0. |
formats | De link in alle vier formaten: url, markdown, html en custom. |
reused | true als er niets is geüpload omdat hetzelfde bestand er al stond. Ontbreekt bij Aktar-versies vóór Mac 0.10.0 en Windows 0.3.0. |
shortLinkError | Waarom Aktar de korte link niet kon maken; url is dan de oorspronkelijke link. Weggelaten als alles goed ging. |
Exitcodes
| Code | Betekenis |
|---|---|
0 | Alles is gelukt. |
1 | Minstens één upload of verzoek is mislukt; de andere zijn wel doorgegaan. Fouten van Aktar zelf, zoals automatisch verwijderen dat niet is ingesteld, komen ook hier terecht. |
2 | Ongeldige argumenten, een bestand dat niet bestaat, of een bestemmingsnaam die Aktar niet kent. Er is niets geüpload. |
3 | Niet ingelogd, Aktar draait niet, de lokale API staat uit, het token klopt niet, of de app op de poort kon niet bewijzen dat het Aktar is (of is daar te oud voor). |
Recepten
Kopiëren, bestandsnamen aanpassen, klaar. Elk recept gebruikt alleen wat hierboven is beschreven.
De link in een variabele bewaren
Alleen de link komt op standaarduitvoer, dus command substitution krijgt precies de URL. || exit 1 stopt het script als de upload is mislukt.
url=$(aktar upload build/report.pdf) || exit 1
echo "Report: $url"
Report: https://files.example.com/2026/10/0e7d51b3.pdfEen build uploaden en de link posten
Zip een build, upload die naar een bestemming met de naam Builds onder de korte hash van de commit, en post de link naar elke webhook die JSON accepteert (een chatkanaal, een issuetracker, je eigen endpoint). set -e stopt voor het posten als de upload mislukt.
#!/bin/sh
set -e
zip -qr app.zip dist
url=$(aktar upload app.zip -d Builds --name "app-$(git rev-parse --short HEAD)")
curl -fsS -X POST "$WEBHOOK_URL" \
-H 'Content-Type: application/json' \
-d "{\"text\": \"New build: $url\"}"Een Makefile-target
make share uploadt het rapport onder de datum van vandaag en bewaart de link in .last-link. In een Makefile geeft $$ een $ door aan de shell, en de commandoregel begint met een tab.
Afbeeldingsuploader voor Typora
Open in Typora Settings > Image, kies Custom Command als image uploader en vul het volledige pad naar aktar in (het pad dat which aktar toont), gevolgd door upload. Typora geeft de paden van de afbeeldingen door en leest één link per regel.
/opt/homebrew/bin/aktar uploadStap voor stap, met de instelling When Insert…: Typora-afbeeldingen uploaden naar S3.
Uploaden vanuit de Finder of Opdrachten
Voeg op een Mac een actie Run Shell Script toe aan een opdracht, of aan een snelle taak in Automator die bestanden ontvangt in de Finder, en stel in dat de invoer as arguments wordt doorgegeven. Opdrachten en Automator laden het PATH van je shell niet, vandaar de eerste regel. Selecteer bestanden, voer het uit, en de links staan op het klembord.
export PATH="/opt/homebrew/bin:/usr/local/bin:$PATH"
aktar upload "$@" | pbcopy
osascript -e 'display notification "Link copied" with title "aktar"'Het uploadt bestanden, geen mappen. Meerdere bestanden geven meerdere links, één per regel.
Tijdelijke bestanden
Laat de bucket een log, een schermopname of iets anders dat niet hoeft te blijven zelf verwijderen. De bestemming heeft eerst de regels voor automatisch verwijderen van Aktar nodig: stel die één keer in via Verwijder na in de menubalk van Aktar of in de instellingen van de bestemming.
aktar upload crash.log --expires 1
aktar upload screen-recording.mov --expires 7 --qrVerlopende bestanden komen onder tmp/1d/, tmp/7d/ enzovoort in de bucket, en de bucket verwijdert ze ook als Aktar niet draait.
Een link openen op je telefoon
--qr toont een QR-code onder de link; richt de camera van je telefoon op de terminal. Om hem later opnieuw te tonen, geef je de ID van een upload door aan aktar qr, hier de nieuwste upload die overeenkomt met ‘demo’.
aktar upload demo.mp4 --qr
aktar qr "$(aktar history demo -n 1 --json | jq -r '.[0].id')"Windows PowerShell
Hetzelfde werkt in PowerShell. $LASTEXITCODE bevat de exitcode, en ConvertFrom-Json leest --json.
Aktar in Claude Desktop, Cursor of VS Code
Apps die een JSON-configuratie voor MCP-servers accepteren (Claude Desktop, Cursor, Windsurf en andere) hebben dit item nodig. VS Code gebruikt hetzelfde item onder servers in .vscode/mcp.json. Vraag je agent daarna een bestand te uploaden, de screenshots van vorige week te zoeken of een tijdelijke link te maken.
Als de app aktar niet kan vinden, gebruik dan het volledige pad (which aktar), of npx met ["-y", "@getaktar/cli", "mcp", "--root", "/Users/you/Projects"] als argumenten. Zet na --root de map waaruit je agent mag uploaden (op Windows bijvoorbeeld C:\\Users\\you\\Projects).
Wat Aktar voor je doet
De CLI geeft alleen bestanden door; Aktar doet de rest, met de instellingen van elke bestemming. Alles wat je in de app hebt ingesteld, geldt dus ook voor aktar upload, zonder extra opties, en de link die je krijgt is die van het bestand zoals het is opgeslagen.
-
Padsjablonen
Het objectpad van de bestemming bepaalt de bestandsnaam, met
{year},{uuid},{filename}en de rest.{md5}en{sha256}geven bestanden een naam op basis van hun inhoud. -
Beeldbewerking
Als de bestemming afbeeldingen omzet naar WebP of AVIF, comprimeert of verkleint, krijgen uploads via de CLI dezelfde behandeling, en wijst de link naar het omgezette bestand.
-
Fotometadata
Afbeeldingsmetadata in de standaardinstellingen voor uploads van de bestemming verwijdert de locatie uit foto's, of alle metadata, voordat ze je computer verlaten.
-
Zelfde bestand, zelfde link
Met Hergebruik links voor dubbele bestanden aan krijgt dezelfde inhoud in dezelfde bestemming de bestaande link in plaats van een tweede upload.
aktarmeldt dat op stderr. -
Grote bestanden
Grote bestanden gaan in delen omhoog, zonder limiet van 5 GB, worden na een verbroken verbinding opnieuw geprobeerd en gaan verder waar ze waren gestopt.
aktarstreamt het bestand naar Aktar en laadt het dus nooit in het geheugen. -
Openbare of tijdelijke links
Of de link openbaar is of een tijdelijke (presigned) link die ook werkt voor een privébucket, kiest de bestemming, net als in de app.
Dubbele links, beeldbewerking, {md5} en {sha256} en uploads in delen kwamen met Aktar voor Mac 0.10.0 en Windows 0.3.0: wat er nieuw is in 0.10.0.
Problemen oplossen
Foutmeldingen van aktar beginnen met aktar: en gaan naar stderr. De exitcode vertelt je wat voor probleem het is.
Aktar isn't running, or its local API is turned off
Open Aktar en controleer of Sta lokale verbindingen toe aan staat in Instellingen > Integraties. Als je daar de poort hebt gewijzigd, geef die dan op met --port of AKTAR_PORT, of voer aktar login --port opnieuw uit. Exitcode 3.
Not connected to Aktar yet
Er is geen opgeslagen token en geen AKTAR_TOKEN. Voer aktar login uit met het token uit Instellingen > Integraties van Aktar. Exitcode 3.
The token doesn't match Aktar's anymore
Het token is opnieuw gegenereerd in Aktar, of er zit een typfout in. Voer aktar login opnieuw uit met het huidige token. Als AKTAR_TOKEN is ingesteld, gaat dat voor het opgeslagen token, dus werk het ook bij of verwijder het. Exitcode 3.
The app on port … couldn't prove it's Aktar
Iets antwoordde op de poort van Aktar, maar kon niet aantonen dat het je token heeft, dus is het token niet verstuurd. Als Aktar draait, is het token waarschijnlijk gewijzigd: voer aktar login opnieuw uit. Als Aktar niet draait, open het dan. Exitcode 3.
This version of Aktar can't prove it's Aktar
aktar 0.6.0 en nieuwer controleren de app voordat ze het token versturen, en dat vereist Aktar voor Mac 0.18.0 of Aktar voor Windows 0.11.0 of nieuwer. Werk Aktar bij (het biedt zelf updates aan), en het commando werkt weer. Exitcode 3.
MCP: This server doesn't upload local files
De agent heeft aktar mcp in je thuismap of in de hoofdmap van de schijf gestart, en er is geen --root. Voeg --root met de map waaruit bestanden mogen komen toe aan het commando of de configuratie van de server, bijvoorbeeld aktar mcp --root ~/Projects, en herstart de agent.
Auto-delete isn't set up for this destination
--expires heeft de regels voor automatisch verwijderen van de bucket nodig. Stel die één keer in via Verwijder na in de menubalk van Aktar of in de instellingen van de bestemming, of upload zonder --expires. Exitcode 1.
No destination named "…"
De melding toont de namen die Aktar kent. Controleer de spelling, zet namen met spaties tussen aanhalingstekens (-d "Client work"), of gebruik de ID uit aktar destinations. Exitcode 2.
Een grote upload duurt lang
Dat is de snelheid van de opslagprovider: aktar heeft geen tijdslimiet voor uploads en toont in een terminal de voortgang op stderr. Laat Aktar draaien tot het klaar is. Als de verbinding wegvalt of Aktar stopt (Aktar closed the connection before the request finished), upload hetzelfde bestand dan opnieuw: Aktar voor Mac 0.10.0 en Windows 0.3.0 gaan verder vanaf het laatste deel.
aktar start niet: SyntaxError of parseArgs
Je Node.js is ouder dan versie 18. Controleer het met node --version en werk het bij, of installeer aktar met Homebrew, dat zijn eigen Node.js meebrengt.
PowerShell meldt dat het uitvoeren van scripts is uitgeschakeld
Het uitvoeringsbeleid van PowerShell blokkeert het script dat npm voor aktar installeert. Voer in plaats daarvan aktar.cmd uit, of sta lokale scripts één keer toe met Set-ExecutionPolicy -Scope CurrentUser RemoteSigned.
