- 명령줄
- v0.6.0
aktar로 터미널에서 업로드하기
명령어 하나에 링크 하나. aktar upload report.pdf를 실행하면 Aktar 앱을 통해 파일이 내 버킷으로 전송되고 URL, Markdown 또는 전체 JSON이 출력됩니다. 스크립트, CI 작업, Typora 같은 편집기에 맞춰 만들었습니다.
설치하지 않고 바로 써 볼 수도 있습니다: npx @getaktar/cli upload file.png
터미널에서 aktar upload를 실행해 링크, Markdown 이미지, JSON을 출력하는 모습
aktar upload <file>…
하나 이상의 파일을 업로드하고, 각 파일이 끝나는 대로 파일당 링크 하나를 출력합니다.
--format markdown
일반 URL 대신 Aktar에 설정한 Markdown, HTML 또는 사용자 지정 템플릿으로 출력합니다.
--json
URL, 모든 형식, 객체 키, 크기, 파일 만료 시점까지 모든 정보를 JSON으로 출력합니다.
-d · --folder · --expires
이름으로 대상을 고르거나, 폴더 안으로 업로드하거나, 1일, 7일, 14일 또는 30일 후에 버킷이 파일을 삭제하도록 합니다.
--clipboard
클립보드에 있는 파일이나 이미지를 업로드합니다.
--name cover
파일 하나를 다른 이름으로 업로드합니다. 이 이름은 대상의 경로 템플릿과 Aktar 기록에 사용됩니다.
--qr · aktar qr
각 링크 아래에 QR 코드를 출력해 휴대폰에서 바로 열 수 있습니다.
aktar qr은 어떤 링크든, 또는 기록에 있는 업로드의 QR 코드를 보여 줍니다."reused": true
같은 파일이 이미 버킷에 있으면 Aktar는 다시 업로드하지 않고 기존 링크를 돌려주며,
aktar는 이를 stderr에 알립니다.aktar replace
업로드 ID, 링크 또는 키로 지정한 업로드를 새 파일로 덮어쓰고 링크는 그대로 유지합니다. Mac용 Aktar 0.14.0 또는 Windows용 0.7.0이 필요합니다.
--short · aktar short
대상의 링크 단축기로 만든 짧은 링크를 출력합니다.
aktar short는 기록에 있는 업로드의 짧은 링크를 만듭니다. Mac용 Aktar 0.17.0 또는 Windows용 0.10.0이 필요합니다.aktar mcp · aktar skill
Claude, Cursor, VS Code, Codex 같은 AI 에이전트가 MCP 서버 또는 에이전트 스킬로 업로드하고, 업로드를 검색하고, 링크를 만들 수 있게 합니다.
aktar login
Aktar 설정에 있는 토큰이 작동하는지 확인한 뒤 저장합니다.
status · destinations · history
연결 상태, 대상 목록, 검색 가능한 업로드 기록을 보여 줍니다.
1분이면 설정 완료
- Mac 또는 Windows용 Aktar에서 설정 > 연동을 열고 로컬 연결 허용을 켭니다.
토큰 복사
그곳에 표시된 토큰을 복사합니다.aktar login 실행
aktar login을 실행하고 토큰을 붙여 넣습니다. 이제 끝입니다.aktar upload는 Aktar에서 선택한 대상을 사용합니다.
스크립트에 딱 맞게
링크는 한 줄에 하나씩 표준 출력으로, 나머지는 모두 표준 오류로 나가므로 URL=$(aktar upload build.zip)이 그대로 작동합니다. --json으로 전체 정보를 받을 수 있고, 종료 코드로 결과를 알 수 있습니다. CI에서는 로그인하는 대신 AKTAR_TOKEN을 설정하세요.
| 종료 코드 | 종료 코드 |
|---|---|
| 0 | 모두 업로드됨 |
| 1 | 하나 이상의 업로드가 실패했고, 나머지는 완료됨 |
| 2 | 잘못된 인수 또는 파일 없음, 아무것도 업로드되지 않음 |
| 3 | Aktar에 연결할 수 없거나, 토큰이 올바르지 않거나, 포트의 앱이 Aktar임을 증명하지 못함 |
Typora 이미지를 내 버킷에
aktar를 Typora의 사용자 지정 이미지 업로더로 설정하면, 문서에 붙여 넣는 모든 이미지가 내 버킷에 업로드되고 링크가 Markdown에 기록됩니다.
Typora 설정하기키는 Aktar 안에만
CLI는 스토리지 자격 증명을 전혀 보지 않습니다. 파일을 127.0.0.1의 Aktar 앱으로 보내면, 앱이 키체인이나 자격 증명 관리자에 있는 키로 업로드합니다.
Aktar의 로컬 API는 직접 켜기 전까지 꺼져 있고, 다른 컴퓨터의 연결은 절대 받지 않으며, 모든 요청에 토큰이 필요합니다. CLI는 토큰을 나만 읽을 수 있는 파일에 보관하고, 보내기 전에 포트의 앱이 정말 Aktar인지 확인합니다.
요구 사항
- Mac용 Aktar 0.18.0 또는 Windows용 Aktar 0.11.0 이상(대상이 하나 이상 있어야 함. aktar 0.5.0 이하는 Mac용 Aktar 0.4.0 이상에서 작동)
- Node.js 18 이상(Homebrew가 자동으로 설치)
- 이미 업로드한 파일의 링크 재사용: Mac용 Aktar 0.10.0 또는 Windows용 Aktar 0.3.0
-
aktar replace: aktar 0.3.0 및 Mac용 Aktar 0.14.0 또는 Windows용 0.7.0 -
aktar mcp및aktar skill: aktar 0.4.0 - 짧은 링크: aktar 0.5.0과 Mac용 Aktar 0.17.0 또는 Windows용 0.10.0
- GitHub에 공개된 오픈 소스(MIT)
자주 묻는 질문
Aktar 앱 없이도 CLI를 쓸 수 있나요?
CI나 서버에서도 쓸 수 있나요?
어떤 스토리지를 지원하나요?
Claude, Cursor 같은 AI 에이전트도 쓸 수 있나요?
aktar mcp는 MCP 서버입니다. claude mcp add aktar -- aktar mcp --root ~/Projects로 추가하면(또는 문서의 JSON 설정 사용) 에이전트가 파일을 업로드하고, 업로드를 검색하고, 임시 링크를 만들 수 있습니다. --root는 업로드할 수 있는 폴더이고, SSH 키나 .env 파일 같은 비밀 정보는 절대 업로드되지 않으며, --allow-replace로 링크를 유지한 채 파일을 교체하게 할 수 있고, --read-only는 쓰기 작업을 모두 제외합니다. MCP를 쓰지 않는 에이전트에는 aktar skill이 CLI 사용법을 알려 주는 스킬을 출력합니다.토큰은 어디에 저장되나요?
~/.config/aktar/cli.json(Windows에서는 %APPDATA%\aktar\cli.json)에 저장되며, 내 사용자 계정만 읽을 수 있습니다. aktar logout으로 삭제할 수 있고, Aktar에서 토큰을 다시 생성하면 모든 클라이언트의 연결이 끊어집니다.연동
