- Riga di comando
- v0.6.0
Carica dal terminale con aktar
Un comando, un link: aktar upload report.pdf invia il file al tuo bucket tramite l'app Aktar e stampa il suo URL, il Markdown o il JSON completo. Pensato per script, job di CI ed editor come Typora.
Oppure provalo senza installarlo: npx @getaktar/cli upload file.png
aktar upload in un terminale, che stampa link, un'immagine Markdown e JSON
aktar upload <file>…
Carica uno o più file e stampa un link per file, man mano che ciascuno termina.
--format markdown
Stampa Markdown, HTML o il tuo modello personalizzato di Aktar al posto del semplice URL.
--json
Stampa tutto in JSON: URL, ogni formato, chiave oggetto, dimensione e scadenza del file.
-d · --folder · --expires
Sceglie una destinazione per nome, carica in una cartella o fa eliminare il file dal bucket dopo 1, 7, 14 o 30 giorni.
--clipboard
Carica il file o l'immagine negli Appunti.
--name cover
Carica un singolo file con un altro nome, usato dal modello di percorso della destinazione e dalla cronologia di Aktar.
--qr · aktar qr
Stampa un codice QR sotto ogni link per aprirlo sul telefono.
aktar qrne mostra uno per qualsiasi link o per un caricamento della cronologia."reused": true
Se lo stesso file è già nel bucket, Aktar restituisce il suo link invece di caricarlo di nuovo, e
aktarlo segnala su stderr.aktar replace
Scrive un nuovo file al posto di un caricamento e ne mantiene il link, tramite ID del caricamento, link o chiave. Richiede Aktar per Mac 0.14.0 o Windows 0.7.0.
--short · aktar short
Stampa il link breve dell'accorciatore della destinazione.
aktar shortne crea uno per un caricamento della cronologia. Richiede Aktar per Mac 0.17.0 o Windows 0.10.0.aktar mcp · aktar skill
Permette ad agenti AI come Claude, Cursor, VS Code e Codex di caricare file, cercare tra i tuoi caricamenti e creare link, come server MCP o con una skill per agenti.
aktar login
Salva il token dalle Impostazioni di Aktar, dopo aver verificato che funzioni.
status · destinations · history
Mostra la connessione, le tue destinazioni e una cronologia dei caricamenti ricercabile.
Pronto in un minuto
- In Aktar per Mac o Windows, apri Impostazioni > Integrazioni e attiva Consenti connessioni locali.
Copia il token
Copia il token mostrato lì.Esegui aktar login
Eseguiaktar logine incollalo. Fatto: oraaktar uploadusa la destinazione selezionata in Aktar.
Pensato per gli script
I link vanno sullo standard output, uno per riga, e tutto il resto sullo standard error, quindi URL=$(aktar upload build.zip) funziona e basta. --json ti dà tutti i dettagli e il codice di uscita ti dice cosa è successo. In CI, imposta AKTAR_TOKEN invece di fare il login.
| Codice di uscita | Codice di uscita |
|---|---|
| 0 | È stato caricato tutto |
| 1 | Almeno un caricamento non è riuscito; gli altri sono andati a buon fine |
| 2 | Argomenti non validi o file mancante; non è stato caricato nulla |
| 3 | Aktar non è raggiungibile, il token è sbagliato oppure l'app sulla porta non è riuscita a dimostrare di essere Aktar |
Le immagini di Typora, sul tuo bucket
Imposta aktar come uploader di immagini personalizzato di Typora e ogni immagine che incolli in un documento viene caricata sul tuo bucket, con il link scritto nel Markdown.
Configura TyporaLe tue chiavi restano in Aktar
La CLI non vede mai le credenziali del tuo spazio di archiviazione. Invia i file all'app Aktar su 127.0.0.1, che li carica con le chiavi conservate nel Portachiavi o in Gestione credenziali.
L'API locale di Aktar resta disattivata finché non la attivi, non accetta mai connessioni da altri computer e ogni richiesta richiede il tuo token. La CLI lo conserva in un file che puoi leggere solo tu, e verifica che l'app sulla porta sia davvero Aktar prima di inviarlo.
Requisiti
- Aktar per Mac 0.18.0 o Aktar per Windows 0.11.0 o successivo, con almeno una destinazione (aktar 0.5.0 e precedenti funzionano con Aktar per Mac 0.4.0 o successivo)
- Node.js 18 o successivo (Homebrew lo installa per te)
- Riutilizzo dei link di file già caricati: Aktar per Mac 0.10.0 o Aktar per Windows 0.3.0
-
aktar replace: aktar 0.3.0 e Aktar per Mac 0.14.0 o Windows 0.7.0 -
aktar mcpeaktar skill: aktar 0.4.0 - Link brevi: aktar 0.5.0 e Aktar per Mac 0.17.0 o Windows 0.10.0
- Open source (MIT) su GitHub
Domande
La CLI funziona senza l'app Aktar?
Posso usarla in CI o su un server?
Quali spazi di archiviazione supporta?
Claude, Cursor o altri agenti AI possono usarla?
aktar mcp è un server MCP: aggiungilo con claude mcp add aktar -- aktar mcp --root ~/Projects (o con la configurazione JSON nella documentazione) e il tuo agente può caricare file, cercare tra i tuoi caricamenti e creare link temporanei. --root è la cartella da cui può caricare, i segreti come le chiavi SSH e i file .env non vengono mai caricati, --allow-replace gli permette di sostituire un file mantenendone il link, e --read-only esclude tutto ciò che scrive. Per gli agenti senza MCP, aktar skill stampa una skill che insegna loro la CLI.Dove viene salvato il token?
~/.config/aktar/cli.json su Mac (%APPDATA%\aktar\cli.json su Windows), leggibile solo dal tuo utente. aktar logout lo rimuove, e rigenerare il token in Aktar disconnette tutti i client.Integrazioni
Dove lavori già.
- Aktar per RaycastCarica gli appunti o i file selezionati, cerca nella cronologia con le miniature e sfoglia i tuoi bucket. Chiedi a Raycast AI un link di 2 ore a un file.Comandi e configurazione
- Server MCP per agenti AIClaude, Cursor, VS Code e Codex caricano file, cercano nei tuoi caricamenti e creano link, mentre le chiavi restano in Aktar.Configura il tuo agente
- Il tuo bucket, dentro ObsidianIncolla, trascina o sposta gli allegati nel tuo bucket. Le chiavi restano sul dispositivo.Come funziona il plugin
