Ringkasan
aktar adalah remote control untuk app Aktar di komputer yang sama. Anda memberinya file, ia meneruskannya ke Aktar di 127.0.0.1, dan Aktar mengunggahnya dengan tujuan, kunci, template jalur, dan pengaturan tautan yang sudah Anda atur. Tautannya kembali ke terminal Anda.
Apa itu
- Perintah Node.js kecil untuk skrip, tugas CI di Mac atau mesin Windows Anda sendiri, dan editor seperti Typora
- Cara untuk mengunggah file dan isi papan klip, menampilkan kode QR, serta membaca tujuan dan riwayat unggahan Anda
- Gratis dan open source (MIT), seperti app-nya
Apa yang bukan
- Tidak berdiri sendiri: tanpa Aktar yang berjalan, ia tidak bisa mengunggah apa pun. Ia tidak pernah menyimpan kunci penyimpanan Anda
- Bukan untuk server Linux atau mesin jarak jauh: ia hanya berbicara dengan Aktar di komputer yang sama. Di sana, gunakan CLI milik penyedia penyimpanan Anda
Persyaratan
- Aktar untuk Mac 0.18.0 atau Aktar untuk Windows 0.11.0 atau lebih baru, dengan setidaknya satu tujuan. aktar 0.5.0 dan sebelumnya berfungsi dengan Aktar untuk Mac 0.4.0 atau lebih baru
- Node.js 18 atau lebih baru (Homebrew menginstalnya untuk Anda)
-
--name,--qr, danaktar qrmemerlukan aktar 0.2.0 atau lebih baru - Menggunakan kembali tautan file yang sudah diunggah memerlukan aktar 0.2.0 dan Aktar untuk Mac 0.10.0 atau Aktar untuk Windows 0.3.0
-
aktar replacememerlukan aktar 0.3.0 dan Aktar untuk Mac 0.14.0 atau Aktar untuk Windows 0.7.0 atau lebih baru -
--short,--no-short, danaktar shortbutuh aktar 0.5.0 serta Aktar untuk Mac 0.17.0 atau Aktar untuk Windows 0.10.0, dengan pemendek tautan yang diatur di tujuan
Instalasi
Instal sekali saja, dengan npm atau Homebrew. Keduanya menaruh perintah aktar di path Anda.
Dengan npm (macOS dan Windows)
npm install -g @getaktar/cliDengan Homebrew (macOS)
brew install getaktar/tap/aktar-cliAtau jalankan sekali tanpa menginstal apa pun:
npx @getaktar/cli upload file.pngPeriksa versi yang Anda miliki:
aktar --version
0.6.0Hubungkan ke Aktar
- Di Aktar untuk Mac atau Windows, buka Pengaturan > Integrasi dan nyalakan Izinkan koneksi lokal. Aktar lalu hanya mendengarkan di
127.0.0.1, port 47913 kecuali Anda mengubahnya di sana. - Salin token yang ditampilkan di bawahnya.
- Jalankan
aktar logindan tempel token di promptToken:. Token tetap tersembunyi saat Anda mengetik, dan diperiksa ke Aktar sebelum disimpan, jadi salah ketik tidak akan tersimpan.
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.jsonTempat token disimpan
aktar login menyimpan token dan port di ~/.config/aktar/cli.json di Mac (atau $XDG_CONFIG_HOME/aktar/cli.json jika Anda mengaturnya) dan di %APPDATA%\aktar\cli.json di Windows. Hanya pengguna Anda yang bisa membacanya.
Sebelum mengirim token, aktar meminta app di port tersebut membuktikan bahwa ia memiliki token yang sama, tanpa mengirimkannya. Jadi jika Aktar tidak berjalan dan program lain mendengarkan di port-nya, program itu tidak mendapatkan token maupun file Anda. Ini memerlukan Aktar untuk Mac 0.18.0 atau Aktar untuk Windows 0.11.0 atau lebih baru; dengan Aktar versi lama, aktar berhenti dan meminta Anda memperbarui.
aktar logout menghapus file itu. Untuk memutus semua klien sekaligus, klik Buat Ulang di samping token di Aktar, lalu jalankan aktar login lagi dengan token yang baru.
Skrip dan CI
Di mesin build, lewati aktar login dan atur AKTAR_TOKEN (serta AKTAR_PORT jika Anda mengubah port). Keduanya diutamakan di atas file yang tersimpan. Aktar harus berjalan di mesin itu, dalam sesi pengguna yang sama.
AKTAR_TOKEN="$AKTAR_SECRET" aktar upload dist/app.zip -d Builds| Variabel | Fungsinya |
|---|---|
AKTAR_TOKEN | Token dari Pengaturan > Integrasi di Aktar. Dipakai sebagai pengganti token yang tersimpan. |
AKTAR_PORT | Port API lokal Aktar, jika Anda mengubahnya. --port diutamakan di atasnya. |
NO_COLOR | Menggambar kode QR dengan karakter biasa, bukan warna terminal. |
XDG_CONFIG_HOME | Lokasi folder konfigurasi di macOS (default ~/.config). Di Windows, yang dipakai adalah %APPDATA%. |
Perintah
Semua perintah berbicara dengan Aktar, kecuali aktar qr dengan teks biasa atau tautan. Tanpa -d, unggahan masuk ke tujuan yang dipilih di bar menu Aktar, dan muncul di riwayat Aktar seperti unggahan lainnya. aktar --help mencetak daftar yang sama. Dengan Aktar untuk Mac 0.14.0 atau Aktar untuk Windows 0.7.0 atau lebih baru, unggahan tanpa -d lebih dulu mengikuti aturan Gunakan untuk pada tujuan, sehingga gambar bisa masuk ke tujuan tangkapan layar Anda dan build ke tujuan lain.
aktar uploadaktar upload --clipboardaktar replaceaktar shortaktar qraktar loginaktar logoutaktar statusaktar destinationsaktar historyaktar mcpaktar skill
aktar upload
Mengunggah satu file atau lebih dan mencetak satu tautan per file, berurutan, begitu masing-masing selesai.
Penggunaan
aktar upload <file>... [options]Opsi
| Flag | Nilai | Deskripsi |
|---|---|---|
-d, --destination | <name|id> | Tujuan unggahan, berdasarkan nama atau ID. Default: tujuan yang dipilih di Aktar. |
-f, --format | <format> | Apa yang dicetak: url (default), markdown, html, atau custom (template Anda di Aktar). |
--name | <name> | Unggah satu file dengan nama ini. Ekstensinya dipertahankan jika nama tidak memilikinya. |
--folder | <path> | Pertahankan nama file dan unggah ke folder ini. |
--expires | <days> | Biarkan bucket menghapus file setelah 1, 7, 14, atau 30 hari. 0 menyimpannya. |
--short | Buat tautan pendek dengan pemendek tautan milik tujuan, meski aturannya akan melewati unggahan ini. | |
--no-short | Kali ini jangan buat tautan pendek. | |
--qr | Cetak juga kode QR untuk setiap tautan. | |
--json | Cetak array JSON berisi detail lengkap setiap unggahan, bukan tautan. | |
--port | <port> | Port API lokal Aktar, hanya untuk perintah ini. Diutamakan di atas AKTAR_PORT dan port yang tersimpan. |
Perlu diketahui
- Setiap file diperiksa sebelum ada yang diunggah: jika salah satunya tidak ada, tidak ada yang diunggah dan
aktarkeluar dengan kode 2. - Jika satu unggahan gagal, yang lain tetap berjalan. Setiap kegagalan dilaporkan di stderr, dan kode keluarnya 1.
- Tanpa
--folder, template jalur tujuan yang menamai file, sama seperti saat file dijatuhkan ke bar menu. Dengan--folder, file tetap memakai namanya di dalam folder itu. --namebekerja dengan satu file sekaligus. Garis miring dihapus, dan ekstensi file ditambahkan jika nama tidak memilikinya:--name covermengunggahIMG_4021.jpgsebagaicover.jpg. Dengan--folder, itu adalah nama di dalam folder.--expiresmenerima 1, 7, 14, atau 30 (hari), atau 0 untuk menyimpan file. Tanpa opsi ini, file disimpan, apa pun pengaturan Hapus setelah di Aktar. Opsi ini memerlukan aturan hapus otomatis Aktar di tujuan tersebut, dan tidak bisa digabung dengan--folder.--qrtidak bisa digabung dengan--json, dan--pnghanya bekerja denganaktar qr.- Di terminal, progres ditampilkan di stderr selama file diunggah. File dialirkan ke Aktar, jadi ukurannya tidak masalah, dan tidak ada batas waktu.
- Jika tujuan punya pemendek tautan yang diatur di Aktar, tautan pendeknya yang dicetak, dan
--formatserta--qrmemakainya.--shortmembuatnya meski aturan tujuan akan melewati unggahan ini,--no-shorttidak membuatnya. Jika Aktar tidak bisa membuatnya, tautan asli yang dicetak dan stderr menjelaskan alasannya.
Contoh
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
Mengunggah file atau gambar yang ada di papan klip, seperti pintasan papan klip milik Aktar sendiri.
Penggunaan
aktar upload --clipboard [options]Opsi
| Flag | Nilai | Deskripsi |
|---|---|---|
--clipboard | Unggah isi papan klip, bukan file. | |
-d, --destination | <name|id> | Tujuan unggahan, berdasarkan nama atau ID. Default: tujuan yang dipilih di Aktar. |
-f, --format | <format> | Apa yang dicetak: url (default), markdown, html, atau custom (template Anda di Aktar). |
--expires | <days> | Biarkan bucket menghapus file setelah 1, 7, 14, atau 30 hari. 0 menyimpannya. |
--short | Buat tautan pendek dengan pemendek tautan milik tujuan, meski aturannya akan melewati unggahan ini. | |
--no-short | Kali ini jangan buat tautan pendek. | |
--qr | Cetak juga kode QR untuk setiap tautan. | |
--json | Cetak array JSON berisi detail lengkap setiap unggahan, bukan tautan. | |
--port | <port> | Port API lokal Aktar, hanya untuk perintah ini. Diutamakan di atas AKTAR_PORT dan port yang tersimpan. |
Perlu diketahui
- Berikan file atau
--clipboard, bukan keduanya. --namedan--folderhanya bekerja dengan file.-d,-f,--expires,--qr, dan--jsonbekerja seperti pada file.- Dengan
--json, hasilnya tetap berupa array, dengan satu entri.
Contoh
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
Menulis file baru menimpa sebuah unggahan, sehingga kunci dan tautannya tetap sama. Semua orang yang punya tautannya melihat file baru.
Penggunaan
aktar replace <upload-id|link|key> <file> [options]Opsi
| Flag | Nilai | Deskripsi |
|---|---|---|
-d, --destination | <name|id> | Untuk kunci: tujuan yang bucket-nya berisi kunci itu, berdasarkan nama atau ID. Default: tujuan yang dipilih di Aktar. |
-f, --format | <format> | Apa yang dicetak: url (default), markdown, html, atau custom (template Anda di Aktar). |
--qr | Cetak juga kode QR untuk setiap tautan. | |
--json | Cetak array JSON berisi detail lengkap setiap unggahan, bukan tautan. | |
--port | <port> | Port API lokal Aktar, hanya untuk perintah ini. Diutamakan di atas AKTAR_PORT dan port yang tersimpan. |
Perlu diketahui
- Argumen pertama adalah ID unggahan atau tautan dari
aktar history(entri riwayat Aktar ikut diperbarui), atau selain itu sebuah kunci di bucket-d(tujuan yang dipilih di Aktar jika dikosongkan). Tautan yang tidak ada di riwayat Aktar ditolak: berikan kuncinya dengan-dsebagai gantinya. - Aktar menghapus metadata file dan mengubah ukurannya sesuai pengaturan tujuan, tetapi tidak pernah mengonversinya ke format lain, sehingga ekstensi kunci tetap sama. File di bawah
tmp/{N}d/memulai lagi hitungan N harinya. - Kunci tidak pernah diberi nomor dan tidak ada yang lain yang diunggah.
--folder,--expires,--name, dan--clipboardtidak berlaku dan ditolak. - Salinan lama bisa tetap ada di cache CDN untuk sementara. Waktu cache singkat pada tujuan atau pembersihan cache Cloudflare di Aktar menangani hal itu.
- Memerlukan Aktar untuk Mac 0.14.0 atau Aktar untuk Windows 0.7.0 atau lebih baru.
Contoh
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
Membuat tautan pendek untuk unggahan di riwayat dengan pemendek tautan milik tujuannya, lalu mencetaknya. Jika unggahan sudah punya tautan pendek, yang itu yang dicetak.
Penggunaan
aktar short <upload-id|link> [--json | --qr]Opsi
| Flag | Nilai | Deskripsi |
|---|---|---|
--json | Cetak detail tautan pendek sebagai JSON: penyedia, status, dan klik. | |
--qr | Cetak juga kode QR tautan pendek. | |
--port | <port> | Port API lokal Aktar, hanya untuk perintah ini. Diutamakan di atas AKTAR_PORT dan port yang tersimpan. |
Perlu diketahui
- Berikan ID unggahan atau tautan dari
aktar history; tautan pendeknya juga bisa.aktarmencarinya di 1.000 unggahan terakhir. - Tujuan perlu pemendek tautan di bagian Tautan Pendek di Aktar: Shlink, YOURLS, Kutt, Dub, Short.io, atau permintaan kustom. Tautan pendek dibuat oleh pemendek itu, jadi tautan dan data klik Anda tetap di infrastruktur Anda.
--jsonmencetak detail tautan pendek: penyedia, status, serta klik dan klik terakhir jika pemendek menghitungnya.--qrmenambahkan kode QR-nya. Keduanya tidak bisa digabung.- Butuh Aktar untuk Mac 0.17.0 atau Aktar untuk Windows 0.10.0. Versi lama menjawab bahwa mereka belum bisa membuat tautan pendek.
Contoh
aktar short 0B6C2F8E-3D1A-4C55-9E2B-7A41D0C3E9F1
https://s.example.com/Qm3xZaktar qr
Menampilkan kode QR dari tautan atau teks apa pun di terminal, agar Anda bisa membukanya di ponsel. Jika diberi ID unggahan, perintah ini menampilkan tautan unggahan itu beserta kode QR-nya.
Penggunaan
aktar qr <link|text|upload-id> [--png <file>]Opsi
| Flag | Nilai | Deskripsi |
|---|---|---|
--png | <file> | Simpan kode QR sebagai file PNG alih-alih mencetaknya. |
--port | <port> | Port API lokal Aktar, hanya untuk perintah ini. Diutamakan di atas AKTAR_PORT dan port yang tersimpan. |
Perlu diketahui
- Berikan tepat satu argumen, dan beri tanda kutip pada teks yang berisi spasi.
- ID unggahan adalah
iddariaktar history --jsonatauaktar upload --json.aktarmencarinya di 1.000 unggahan terakhir dalam riwayat Aktar; untuk teks biasa atau tautan, ia sama sekali tidak memerlukan Aktar. - Kode digambar hitam di atas putih di terminal, apa pun temanya. Jika output bukan terminal, atau
NO_COLORdiatur, kode digambar tanpa warna. --pngmenyimpan kode QR sebagai PNG alih-alih mencetaknya.- Untuk unggahan yang punya tautan pendek, yang ditampilkan adalah tautan pendeknya.
Contoh
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
Memeriksa token ke Aktar dan menyimpannya, agar perintah lain bisa terhubung.
Penggunaan
aktar login [--token <token>] [--port <port>]Opsi
| Flag | Nilai | Deskripsi |
|---|---|---|
--token | <token> | Token, sebagai pengganti prompt. |
--port | <port> | Port Aktar, disimpan bersama token. Default 47913. |
Perlu diketahui
- Di terminal, perintah ini meminta token dan menyembunyikan yang Anda ketik. Jika input dialirkan lewat pipe, token dibaca dari sana.
--tokenmelewati prompt, tetapi program lain bisa melihat token selama perintah berjalan, dan token jadi tercatat di riwayat shell Anda, sehinggaaktarmemberi peringatan. Mengalirkannya lewat pipe atau memakaiAKTAR_TOKENmenghindari hal itu.- Token yang ditolak Aktar tidak disimpan, dan kode keluarnya 3.
Contoh
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 memperingatkan bahwa token sempat terlihat.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
Menghapus token dan port yang tersimpan.
Penggunaan
aktar logoutOpsi
Tanpa opsi.
Perlu diketahui
AKTAR_TOKEN, jika diatur, tetap berfungsi setelahaktar logout.- Perintah ini tidak memutus klien lain. Untuk itu, buat ulang token di Aktar.
Contoh
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
Menampilkan Aktar mana yang terhubung dengan Anda, di port berapa, tujuan yang dipilih di Aktar, dan lokasi file konfigurasi.
Penggunaan
aktar status [--json]Opsi
| Flag | Nilai | Deskripsi |
|---|---|---|
--json | Cetak JSON, bukan teks. | |
--port | <port> | Port API lokal Aktar, hanya untuk perintah ini. Diutamakan di atas AKTAR_PORT dan port yang tersimpan. |
Perlu diketahui
- Cara cepat untuk memeriksa koneksi dalam skrip: perintah ini keluar dengan kode 3 jika Aktar tidak bisa dijangkau atau tokennya salah.
Contoh
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
Menampilkan daftar tujuan Anda beserta penyedia, bucket, dan ID-nya. * menandai tujuan yang dipilih di Aktar.
Penggunaan
aktar destinations [--json]Opsi
| Flag | Nilai | Deskripsi |
|---|---|---|
--json | Cetak JSON, bukan teks. | |
--port | <port> | Port API lokal Aktar, hanya untuk perintah ini. Diutamakan di atas AKTAR_PORT dan port yang tersimpan. |
Perlu diketahui
- Gunakan nama atau ID dengan
-d. Nama dicocokkan tanpa memedulikan huruf besar-kecil; ID selalu berfungsi, bahkan setelah diganti nama. --jsonmemberikanid,name,provider,providerName,bucket,publicBaseURL, danisDefaultuntuk masing-masing.
Contoh
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
Menampilkan daftar unggahan terbaru, dari yang paling baru: tanggal, nama file, dan tautan. Kata-kata setelah history mencari di riwayat.
Penggunaan
aktar history [search] [options]Opsi
| Flag | Nilai | Deskripsi |
|---|---|---|
-n, --limit | <n> | Jumlah unggahan yang ditampilkan. Default 20. |
-d, --destination | <name|id> | Hanya unggahan ke tujuan ini, berdasarkan nama atau ID. |
--json | Cetak JSON, bukan teks. | |
--port | <port> | Port API lokal Aktar, hanya untuk perintah ini. Diutamakan di atas AKTAR_PORT dan port yang tersimpan. |
Perlu diketahui
- Menampilkan 20 unggahan kecuali Anda memberikan
-n. --jsonmemberikan field yang sama denganaktar upload --json, termasukidsetiap unggahan untukaktar qr.
Contoh
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
Menjalankan server Model Context Protocol (MCP), sehingga agen AI seperti Claude, Cursor, VS Code, dan Codex bisa mengunggah file lewat Aktar, menemukan unggahan sebelumnya, dan membuat tautan. Tambahkan sekali ke agen Anda; agen akan menjalankannya sendiri saat dibutuhkan.
Penggunaan
aktar mcp [--root <folder>]... [--read-only | --allow-replace | --allow-delete] [--max-link-minutes <n>] [--log <file>]Opsi
| Flag | Nilai | Deskripsi |
|---|---|---|
--root | <folder> | Hanya unggah file dari folder ini. Ulangi untuk folder lain. Default: folder tempat server berjalan, atau tidak ada jika itu folder home Anda atau root disk. |
--read-only | Hanya tawarkan tool yang tidak mengubah apa pun di bucket: pencarian, daftar, tautan sementara, dan thumbnail. | |
--allow-replace | Tawarkan juga replace_file, yang menimpa file di bucket. | |
--allow-delete | Tawarkan juga delete_upload, yang menghapus file dari bucket-nya, dan replace_file. | |
--max-link-minutes | <n> | Batas waktu terlama sebuah tautan sementara berfungsi, dalam menit. Default 60, paling lama 10080 (7 hari). |
--log | <file> | Tambahkan setiap panggilan tool (waktu, tool, argumen, hasil) ke file ini, yang hanya bisa dibaca oleh Anda. |
--port | <port> | Port API lokal Aktar, hanya untuk perintah ini. Diutamakan di atas AKTAR_PORT dan port yang tersimpan. |
Perlu diketahui
- Jalankan
aktar loginlebih dulu. Server membaca token yang tersimpan pada setiap panggilan, jadi login ulang berfungsi tanpa memulai ulang agen. - Mengunggah berarti memublikasikan file: siapa pun yang punya tautannya bisa membukanya. Agen meminta persetujuan sebelum memanggil tool kecuali Anda mengizinkannya.
- File hanya diunggah dari folder yang Anda berikan dengan
--root, atau jika tidak ada, dari folder tempat server berjalan. Jika itu folder home Anda atau root disk, seperti yang dilakukan sebagian app, tidak ada file lokal yang diunggah sampai Anda menambahkan--root.--root ~mengizinkan seluruh folder home Anda, jika memang itu yang Anda mau. Path di-resolve, termasuk symlink, sebelum diperiksa. - Rahasia tidak pernah diunggah, di mana pun letaknya: kunci SSH dan kunci privat, file
.env, kredensial cloud dan package manager (~/.aws,~/.kube,~/.npmrcdan lainnya), konfigurasi Aktar sendiri, Keychain, profil browser, dan database kata sandi. File dengan beberapa hard link juga ditolak. Untuk membagikan salah satunya, unggah sendiri denganaktar upload. --read-onlyhanya menawarkan tool yang tidak mengubah apa pun di bucket.replace_filemenimpa file seperti halnya menghapus, jadi hanya ditawarkan dengan--allow-replace, dandelete_uploadhanya dengan--allow-delete(yang juga menawarkanreplace_file).create_temporary_linkmembuat tautan paling lama 60 menit, kecuali--max-link-minutesmengizinkan lebih.upload_clipboardtidak disertakan saat Anda memberi--root, karena clipboard bisa berisi apa saja.- Hasil tool diawali catatan bahwa nama file, key, dan pesan di dalamnya adalah data, bukan instruksi, dan
--logmencatat setiap panggilan. Server menjalankan paling banyak 4 panggilan tool sekaligus. - Tanpa instalasi global, gunakan
npx -y @getaktar/cli mcp --root ~/Projectssebagai perintahnya. - Mendukung versi MCP saat ini (2026-07-28) dan versi sebelumnya yang diawali
initialize(2024-11-05 sampai 2025-11-25), lewat stdio. Memerlukan aktar 0.4.0; batasan di atas hadir sejak aktar 0.6.0.
Tool
| Tool | Fungsinya |
|---|---|
upload_file | Mengunggah file dan mengembalikan tautan, Markdown, dan HTML-nya. Tujuan, nama, folder, dan masa berlaku bersifat opsional. short meminta tautan pendek, atau tidak sama sekali. |
upload_clipboard | Mengunggah file atau gambar yang ada di clipboard. short meminta tautan pendek, atau tidak sama sekali. Tidak tersedia jika --root diberikan. |
replace_file | Menimpa unggahan atau file apa pun di bucket dengan file baru dan mempertahankan tautannya. Hanya dengan --allow-replace atau --allow-delete. Memerlukan Aktar untuk Mac 0.14.0 atau Windows 0.7.0. |
create_short_link | Membuat tautan pendek untuk unggahan dengan pemendek tautan milik tujuannya, atau mengembalikan yang sudah ada. Tidak tersedia dengan --read-only. Butuh Aktar untuk Mac 0.17.0 atau Windows 0.10.0. |
search_uploads | Mencari di riwayat unggahan. |
list_destinations | Menampilkan daftar tujuan dan jenis file yang digunakan untuk masing-masing. |
list_bucket | Menampilkan folder dan file di bucket, termasuk file yang tidak diunggah lewat Aktar. |
create_temporary_link | Membuat tautan yang berhenti berfungsi setelah beberapa waktu (presigned URL). Sampai saat itu, siapa pun yang memilikinya bisa mengunduh file tersebut, bahkan dari bucket privat. Paling lama 60 menit kecuali --max-link-minutes mengizinkan lebih. |
get_thumbnail | Menampilkan pratinjau sebuah unggahan kepada agen. Memerlukan Aktar untuk Mac 0.13.0 atau Windows 0.6.0. |
list_watched_folders | Menampilkan daftar folder yang dipantau beserta statusnya. |
get_status | Memeriksa koneksi ke Aktar. |
delete_upload | Menghapus unggahan dari bucket-nya. Hanya dengan --allow-delete. |
Contoh
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
Mencetak skill agen (SKILL.md) yang mengajarkan agen memakai perintah aktar dengan --json: apa yang dijalankan, cara membaca hasilnya, dan hanya mengunggah apa yang Anda minta untuk dibagikan. Untuk agen yang memakai skill tetapi bukan MCP.
Penggunaan
aktar skillOpsi
Tanpa opsi.
Perlu diketahui
- Simpan di tempat agen Anda mencari skill, misalnya
~/.claude/skills/aktar/untuk Claude Code.
Contoh
mkdir -p ~/.claude/skills/aktar
aktar skill > ~/.claude/skills/aktar/SKILL.mdOpsi untuk setiap perintah
| Flag | Nilai | Deskripsi |
|---|---|---|
-h, --help | Tampilkan daftar perintah dan opsi. | |
-v, --version | Tampilkan versi aktar. | |
--port | <port> | Port API lokal Aktar, hanya untuk perintah ini. Diutamakan di atas AKTAR_PORT dan port yang tersimpan. |
Output
Format
-f memilih apa yang dicetak untuk setiap unggahan. Tanpa opsi ini, aktar mencetak URL biasa, apa pun format yang disalin bar menu Aktar. Markdown dan HTML menyematkan gambar dan menautkan file lainnya, sama seperti yang dilakukan Aktar.
| Format | Dicetak untuk photo.jpg |
|---|---|
-f url | https://files.example.com/2026/10/7f3c2a91.jpgTautannya (default). |
-f markdown | Gambar Markdown, atau tautan Markdown untuk file lain. |
-f html | <img src="https://files.example.com/2026/10/7f3c2a91.jpg" alt="">Tag <img>, atau tautan <a> untuk file lain. |
-f custom | Template Anda dari pengaturan Aktar, dengan {url}, {filename}, dan variabel lainnya sudah terisi. |
stdout dan stderr
Output standar hanya menerima tautan, satu per baris, sesuai urutan file (dan kode QR, dengan --qr). Semua yang lain masuk ke error standar: progres, kesalahan, dan catatan seperti aktar: photo.jpg: already uploaded, reused the existing link. Jadi url=$(aktar upload file) dan aktar upload *.png > links.txt selalu mendapatkan tautan yang bersih.
aktar upload photo.jpg
aktar: photo.jpg: already uploaded, reused the existing link
https://files.example.com/2026/09/4d2a8c61.jpgJSON
--json mencetak array dengan satu entri per file yang diunggah, setelah semuanya selesai. Unggahan yang gagal tidak disertakan (dilaporkan di stderr), jadi periksa juga kode keluarnya.
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
}
]| Field | Arti |
|---|---|
id | ID unggahan di riwayat Aktar. aktar qr menerimanya. |
filename | Nama file yang dikenal Aktar: nama asli file, atau --name. |
objectKey | Lokasi file di bucket. |
url | Tautannya. |
shortUrl | Tautan pendek, atau null jika tidak ada. formats sudah memakainya. |
destinationId | ID tujuan. |
destinationName | Nama tujuan. |
mimeType | Jenis file, setelah konversi apa pun oleh Aktar. |
size | Ukuran dalam byte, seperti yang disimpan. |
createdAt | Waktu diunggah (ISO 8601, UTC). |
expiresAt | Waktu bucket menghapusnya, atau null jika disimpan. |
replacedAt | Waktu file terakhir diganti (ISO 8601, UTC). Tidak disertakan sampai file diganti, dan oleh versi Aktar sebelum Mac 0.14.0 dan Windows 0.7.0. |
formats | Tautan dalam keempat format: url, markdown, html, dan custom. |
reused | true jika tidak ada yang diunggah karena file yang sama sudah ada. Tidak disertakan oleh versi Aktar sebelum Mac 0.10.0 dan Windows 0.3.0. |
shortLinkError | Alasan Aktar tidak bisa membuat tautan pendek; url saat itu adalah tautan asli. Tidak disertakan jika semuanya lancar. |
Kode keluar
| Kode | Arti |
|---|---|
0 | Semuanya berhasil. |
1 | Setidaknya satu unggahan atau permintaan gagal; yang lain tetap berjalan. Kesalahan dari Aktar sendiri, seperti hapus otomatis yang belum diatur, juga berakhir di sini. |
2 | Argumen salah, file yang tidak ada, atau nama tujuan yang tidak dimiliki Aktar. Tidak ada yang diunggah. |
3 | Belum masuk, Aktar tidak berjalan, API lokalnya mati, tokennya salah, atau app di port itu tidak bisa membuktikan bahwa ia Aktar (atau terlalu lama untuk itu). |
Resep
Salin, sesuaikan nama file, selesai. Setiap resep hanya memakai hal yang didokumentasikan di atas.
Simpan tautan dalam variabel
Hanya tautan yang sampai ke output standar, jadi substitusi perintah mendapatkan URL-nya saja. || exit 1 menghentikan skrip jika unggahan gagal.
url=$(aktar upload build/report.pdf) || exit 1
echo "Report: $url"
Report: https://files.example.com/2026/10/0e7d51b3.pdfUnggah build dan kirim tautannya
Zip sebuah build, unggah ke tujuan bernama Builds dengan hash pendek commit sebagai namanya, lalu kirim tautannya ke webhook apa pun yang menerima JSON (kanal chat, issue tracker, endpoint Anda sendiri). set -e berhenti sebelum mengirim jika unggahan gagal.
#!/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\"}"Target Makefile
make share mengunggah laporan dengan tanggal hari ini sebagai nama dan menyimpan tautannya di .last-link. Di Makefile, $$ meneruskan $ ke shell, dan baris perintah diawali dengan tab.
Pengunggah gambar Typora
Di Typora, buka Settings > Image, pilih Custom Command sebagai pengunggah gambar, dan masukkan path lengkap ke aktar (yang dicetak oleh which aktar) diikuti upload. Typora meneruskan path gambar dan membaca satu tautan per baris.
/opt/homebrew/bin/aktar uploadLangkah demi langkah, dengan pengaturan When Insert…: Unggah gambar Typora ke S3.
Unggah dari Finder atau Pintasan
Di Mac, tambahkan tindakan Run Shell Script ke sebuah Pintasan, atau ke Tindakan Cepat Automator yang menerima file di Finder, dan atur agar input diteruskan as arguments. Pintasan dan Automator tidak memuat PATH shell Anda, karena itulah ada baris pertama. Pilih file, jalankan, dan tautannya sudah ada di papan klip.
export PATH="/opt/homebrew/bin:/usr/local/bin:$PATH"
aktar upload "$@" | pbcopy
osascript -e 'display notification "Link copied" with title "aktar"'Ini mengunggah file, bukan folder. Beberapa file menghasilkan beberapa tautan, satu per baris.
File sementara
Untuk log, rekaman layar, atau apa pun yang tidak perlu disimpan lama, biarkan bucket menghapusnya. Tujuan perlu aturan hapus otomatis Aktar terlebih dahulu: atur sekali dari Hapus setelah di bar menu Aktar atau dari pengaturan tujuan.
aktar upload crash.log --expires 1
aktar upload screen-recording.mov --expires 7 --qrFile yang kedaluwarsa masuk ke tmp/1d/, tmp/7d/, dan seterusnya di bucket, dan bucket menghapusnya bahkan saat Aktar tidak berjalan.
Buka tautan di ponsel Anda
--qr mencetak kode QR di bawah tautan; arahkan kamera ponsel Anda ke terminal. Untuk menampilkannya lagi nanti, berikan ID unggahan ke aktar qr, di sini unggahan terbaru yang cocok dengan “demo”.
aktar upload demo.mp4 --qr
aktar qr "$(aktar history demo -n 1 --json | jq -r '.[0].id')"Windows PowerShell
Hal yang sama juga berfungsi di PowerShell. $LASTEXITCODE berisi kode keluar, dan ConvertFrom-Json membaca --json.
Aktar di Claude Desktop, Cursor, atau VS Code
Aplikasi yang menerima konfigurasi JSON untuk server MCP (Claude Desktop, Cursor, Windsurf, dan lainnya) memerlukan entri ini. VS Code memakai entri yang sama di bawah servers dalam .vscode/mcp.json. Setelah itu, minta agen Anda mengunggah file, mencari screenshot minggu lalu, atau membuat tautan sementara.
Jika aplikasi tidak menemukan aktar, gunakan path lengkapnya (which aktar), atau npx dengan ["-y", "@getaktar/cli", "mcp", "--root", "/Users/you/Projects"] sebagai argumennya. Tulis folder tempat agen Anda boleh mengunggah setelah --root (di Windows, seperti C:\\Users\\you\\Projects).
Yang dikerjakan Aktar untuk Anda
CLI hanya meneruskan file; sisanya dikerjakan Aktar, dengan pengaturan masing-masing tujuan. Jadi semua yang Anda atur di app juga berlaku untuk aktar upload, tanpa opsi tambahan, dan tautan yang Anda dapatkan adalah tautan untuk file sebagaimana disimpan.
-
Template jalur
Jalur objek tujuan yang menamai file, dengan
{year},{uuid},{filename}, dan lainnya.{md5}dan{sha256}menamai file berdasarkan isinya. -
Pemrosesan gambar
Jika tujuan mengonversi gambar ke WebP atau AVIF, mengompres, atau mengubah ukurannya, unggahan dari CLI mendapat perlakuan yang sama, dan tautannya mengarah ke file hasil konversi.
-
Metadata foto
Metadata gambar di pengaturan unggahan default tujuan menghapus lokasi dari foto, atau semua metadata, sebelum foto meninggalkan komputer Anda.
-
File sama, tautan sama
Dengan Gunakan kembali tautan untuk file duplikat menyala, isi yang sama di tujuan yang sama mendapatkan tautan yang sudah ada alih-alih diunggah dua kali.
aktarmencatatnya di stderr. -
File besar
File besar diunggah per bagian, tanpa batas 5 GB, dicoba lagi setelah koneksi terputus, dan dilanjutkan dari titik terakhir.
aktarmengalirkan file ke Aktar, jadi file tidak pernah dimuat ke memori. -
Tautan publik atau sementara
Apakah tautannya publik atau sementara (presigned) yang juga berfungsi untuk bucket pribadi ditentukan oleh tujuan, sama seperti di app.
Tautan untuk duplikat, pemrosesan gambar, {md5} dan {sha256}, serta unggahan per bagian hadir di Aktar untuk Mac 0.10.0 dan Windows 0.3.0: yang baru di 0.10.0.
Pemecahan masalah
Pesan kesalahan dari aktar diawali dengan aktar: dan masuk ke stderr. Kode keluar memberi tahu jenis masalahnya.
Aktar isn't running, or its local API is turned off
Buka Aktar dan pastikan Izinkan koneksi lokal menyala di Pengaturan > Integrasi. Jika Anda mengubah port di sana, berikan dengan --port atau AKTAR_PORT, atau jalankan lagi aktar login --port. Kode keluar 3.
Not connected to Aktar yet
Tidak ada token tersimpan dan tidak ada AKTAR_TOKEN. Jalankan aktar login dengan token dari Pengaturan > Integrasi di Aktar. Kode keluar 3.
The token doesn't match Aktar's anymore
Token sudah dibuat ulang di Aktar, atau salah ketik. Jalankan lagi aktar login dengan token yang berlaku. Jika AKTAR_TOKEN diatur, variabel itu diutamakan di atas token tersimpan, jadi perbarui atau hapus juga. Kode keluar 3.
The app on port … couldn't prove it's Aktar
Ada yang menjawab di port Aktar tetapi tidak bisa menunjukkan bahwa ia memiliki token Anda, jadi token tidak dikirim. Jika Aktar berjalan, tokennya mungkin sudah berubah: jalankan lagi aktar login. Jika Aktar tidak berjalan, buka aplikasinya. Kode keluar 3.
This version of Aktar can't prove it's Aktar
aktar 0.6.0 dan yang lebih baru memeriksa app sebelum mengirim token, dan ini memerlukan Aktar untuk Mac 0.18.0 atau Aktar untuk Windows 0.11.0 atau lebih baru. Perbarui Aktar (ia menawarkan pembaruan sendiri), dan perintahnya akan berfungsi lagi. Kode keluar 3.
MCP: This server doesn't upload local files
Agen menjalankan aktar mcp di folder home Anda atau di root disk, dan tidak ada --root. Tambahkan --root dengan folder asal file ke perintah atau konfigurasi server, misalnya aktar mcp --root ~/Projects, lalu mulai ulang agen.
Auto-delete isn't set up for this destination
--expires memerlukan aturan hapus otomatis pada bucket. Atur sekali dari Hapus setelah di bar menu Aktar atau dari pengaturan tujuan, atau unggah tanpa --expires. Kode keluar 1.
No destination named "…"
Pesannya mencantumkan nama-nama yang dimiliki Aktar. Periksa ejaannya, beri tanda kutip pada nama yang berisi spasi (-d "Client work"), atau gunakan ID dari aktar destinations. Kode keluar 2.
Unggahan besar butuh waktu lama
Itu kecepatan penyedia penyimpanan: aktar tidak punya batas waktu untuk unggahan dan menampilkan progres di stderr di terminal. Biarkan Aktar berjalan sampai selesai. Jika koneksi terputus atau Aktar tertutup (Aktar closed the connection before the request finished), unggah lagi file yang sama: Aktar untuk Mac 0.10.0 dan Windows 0.3.0 melanjutkan dari bagian terakhir.
aktar tidak mau berjalan: SyntaxError atau parseArgs
Node.js Anda lebih lama dari versi 18. Periksa dengan node --version lalu perbarui, atau instal aktar dengan Homebrew, yang membawa Node.js sendiri.
PowerShell menyatakan bahwa menjalankan skrip dinonaktifkan
Kebijakan eksekusi PowerShell memblokir skrip yang diinstal npm untuk aktar. Jalankan aktar.cmd sebagai gantinya, atau izinkan skrip lokal sekali saja dengan Set-ExecutionPolicy -Scope CurrentUser RemoteSigned.
