Aside CLI 맥 설치, 앱 버전만 보면 놓치는 것
Aside를 맥에 설치했다면 확인할 것이 두 가지다. 하나는 /Applications에 들어가는 앱이고, 다른 하나는 터미널에서 부르는 aside 명령이다. 2026년 9월 8일 Apple Silicon(darwin arm64) Mac에 설치할 때 이 둘은 위치도, 버전도, 설치 방법도 달랐다. 앱이 열린다고 해서 셸에서 명령이 잡힌다는 보장은 없다.
이 글은 맥에서 Aside를 터미널 도구로도 쓰려는 개발자를 위한 확인 순서다. 목표는 앱과 CLI가 각각 어디에 있는지 확인하고, 새 로그인 셸에서 aside --version과 aside --help가 실행되는 상태까지 가는 것이다.
범위를 먼저 밝힌다. 아래 버전과 경로는 9월 8일 설치 당시 값이다. 버전은 이후 바뀔 수 있다. 계정 로그인과 MCP 연결은 당시 설치 검증에 포함하지 않았기 때문에 이 글에서도 다루지 않는다.
설치 대상은 두 개였다
| 구분 | 설치 위치 | 설치 방법 | 설치 당시 버전 |
|---|---|---|---|
| 앱 | /Applications/Aside.app | Homebrew cask aside (공식 배포 DMG를 Homebrew가 내려받음) | 1.0.825.1 |
| CLI | ~/.local/bin/aside (심볼릭 링크) | 공식 개발자 문서의 설치 스크립트 | 1.26.906.1630 |
두 버전 번호는 형식부터 다르다. 앱 버전을 확인했다고 CLI 버전까지 확인한 것이 아니라는 점을 여기서 알 수 있다.
1단계: 앱 설치를 확인한다
앱은 Homebrew cask aside로 설치했다. 기록에는 cask 이름만 있고 실행한 명령 원문은 없다. cask 이름으로 쓰면 설치 명령은 다음과 같다.
brew install --cask aside이 cask는 Aside 공식 배포 서버의 DMG를 내려받아 /Applications/Aside.app에 설치했다. 당시 기록에는 앱 설치 명령, 코드서명 검증 명령, 실행 확인 명령이 모두 종료 코드 0으로 끝났다고 남아 있다.
코드서명 확인에 쓴 정확한 명령은 기록에 없다. 같은 항목을 직접 확인하려면 다음과 같은 macOS 기본 명령을 쓸 수 있다.
codesign --verify --verbose /Applications/Aside.app
echo $? # 0이면 서명 검증 통과2단계: CLI를 따로 설치한다
CLI는 cask가 아니라 공식 개발자 문서에 안내된 설치 스크립트로 설치했다. 스크립트를 파이프로 바로 실행하지 않았다. 먼저 스크립트 내용을 읽고, 내려받은 파일이 읽은 내용과 같은지 확인한 다음 실행했다.
설치가 끝난 뒤 CLI는 두 단계 경로로 놓였다.
~/.local/bin/aside
→ ~/.aside/cli/Aside CLI.app/Contents/MacOS/aside실제 실행 파일은 ~/.aside/cli 아래 별도 .app 번들 안에 있고, 셸이 찾는 위치인 ~/.local/bin에는 그 파일을 가리키는 심볼릭 링크가 있다. 즉 앱 번들(/Applications/Aside.app)과 CLI 번들(~/.aside/cli/Aside CLI.app)은 서로 다른 위치다.
3단계: 심볼릭 링크가 실제 파일을 가리키는지 본다
경로 이름에 공백(Aside CLI.app)이 들어 있으므로, 링크 대상이 제대로 잡혔는지 눈으로 확인해 두는 편이 낫다. 아래는 독자용 확인 예시이며, 당시 실행한 명령 원문은 기록에 없다.
ls -l ~/.local/bin/aside출력의 화살표 뒤가 /Users/<사용자 이름>/.aside/cli/Aside CLI.app/Contents/MacOS/aside처럼 홈 아래 .aside/cli의 실제 파일이면 된다. 링크만 있고 대상이 없다면 셸은 명령을 찾더라도 실행에 실패한다.
4단계: 새 로그인 셸의 PATH를 확인한다
command not found가 나는 흔한 이유는 링크가 놓인 디렉터리가 PATH에 없는 것이다. 이미 열어 둔 터미널 창은 설치 전 환경을 그대로 들고 있을 수 있으니, 새 로그인 셸 기준으로 본다. 아래 두 줄도 확인 예시다. .zshrc에서 PATH를 잡는 환경도 반영되도록 -i를 함께 줌다.
zsh -i -l -c 'echo $PATH | tr ":" "\n" | grep "\.local/bin"'
zsh -i -l -c 'command -v aside'당시 Mac에서는 새 zsh 로그인 셸의 PATH에 ~/.local/bin이 이미 들어 있었다. 그래서 .zshrc나 .zprofile을 고치지 않았다. 이것은 그 Mac의 기존 셸 설정 덕분이다. ~/.local/bin이 PATH에 없는 환경이라면 이 단계에서 셸 설정에 경로를 추가해야 한다.
5단계: 버전과 도움말이 실행되는지 본다
마지막으로 명령 자체가 실행되는지 확인한다.
aside --version
aside --help당시 두 명령 모두 실행됐고, CLI 버전은 1.26.906.1630이었다. 출력 원문은 기록에 남기지 않았다.
설치 완료 기준표
| 확인 항목 | 완료 기준 | 9/8 당시 결과 |
|---|---|---|
| 앱 위치 | /Applications/Aside.app 존재 | 확인 |
| 앱 코드서명 | 검증 명령 종료 코드 0 | 확인 |
| CLI 링크 | ~/.local/bin/aside가 ~/.aside/cli/.../aside를 가리킴 | 확인 |
| PATH | 새 로그인 셸 PATH에 ~/.local/bin 포함 | 이미 포함, 셸 설정 수정 없음 |
| CLI 실행 | aside --version, aside --help 실행 | 확인 |
| 계정 로그인·MCP 설정 | 이 단계의 완료 기준 아님 | 수행하지 않음 |
이 설치 기록으로 답하지 않는 것
당시 설치 작업에서는 계정 로그인, 기본 브라우저 변경, 기존 브라우저 데이터 가져오기, MCP 설정을 하지 않았다. 그러니 아래 질문에는 이 기록으로 답하지 않는다.
- Aside 계정 로그인 절차.
- Aside를 MCP 서버로 에이전트에 연결하는 설정.
- 현재 최신 버전의 설치 경로가 위와 같은지 여부.
CLI와 MCP 중 무엇으로 에이전트에 도구를 붙일지 고민 중이라면 MCP vs CLI — AI 코딩 에이전트 도구 연결, 둘 다 써보고 정리한 선택 기준에서 두 방식의 차이를 먼저 보면 된다. 에이전트로 블로그 발행까지 자동화하는 흐름은 Claude Code + Blogger 자동화 — 마크다운에서 발행까지 1분에 정리했다.
결론: 앱과 명령을 따로 확인한다
9월 8일 설치에서 Aside 앱과 Aside CLI는 설치 방법, 위치, 버전이 모두 달랐다. 앱은 /Applications에, CLI는 ~/.local/bin의 심볼릭 링크와 ~/.aside/cli 아래 실제 파일로 나뉘어 있었다. 그래서 설치 완료는 앱 실행이 아니라 링크 대상, 새 로그인 셸의 PATH, aside --version 실행까지 확인한 시점으로 잡는다. 당시 환경에서는 PATH 수정이 필요 없었지만, 내 셸에 ~/.local/bin이 없다면 그 한 줄이 남은 작업이다.
댓글
댓글 쓰기