이제 모바일에서도 안티그래비티 CLI로 옵시디언 글을 쓸 수 있습니다

들어가는 말: 모바일 옵시디언과 로컬 AI의 만남

스마트폰에서 Obsidian 앱으로 문서를 쓰다 보면 PC 작업 환경이 그리워질 때가 많습니다. PC에서는 한쪽에 AI 챗봇이나 터미널을 띄워두고 내 볼트 안의 메모들을 엮거나 초안을 다듬는 작업이 자연스러운데, 모바일에서는 브라우저와 옵시디언을 오가며 복사하고 붙여넣는 과정만으로도 작업 흐름이 끊기기 때문입니다.

하지만 안드로이드 터미널(Termux) 환경에 구글 딥마인드의 에이전틱 AI 도구인 안티그래비티(Antigravity) CLI를 올려두면 작업 방식이 완전히 달라집니다. AI가 내 기기 내부의 마크다운 파일 시스템을 직접 탐색하고 수정하며 실시간으로 글을 완성해 주기 때문입니다.

이번 글에서는 작은 스마트폰 화면의 한계를 벗어나 삼성 덱스(DeX)나 안드로이드 태블릿을 활용해 PC처럼 쾌적하게 작업하는 실전 워크플로우를 다룹니다. 아울러 안드로이드 특유의 배터리 절전 정책 때문에 백그라운드 터미널이 멋대로 꺼지는 문제를 해결하는 필수 설정까지 함께 정리했습니다.

[!NOTE]
💡 사전 안내 (기초 환경이 아직 준비되지 않으셨나요?)
이 글은 안드로이드 Termux에 리눅스 및 안티그래비티 CLI, 그리고 옵시디언 볼트가 이미 세팅되어 있는 환경을 전제로 실전 활용법을 다룹니다. 기초 구축 과정이 필요하신 분들은 이전 가이드를 먼저 참고해 주세요.

스마트폰 Termux에 안티그래비티 CLI 완벽 구축 가이드: 바로가기

안드로이드 Termux로 옵시디언 Git 완벽 동기화 가이드: 바로가기

1. 코딩 에이전트를 왜 문서 작업에 쓸까?

안티그래비티(Antigravity) CLI라는 도구를 처음 접하면 개발자용 코딩 AI를 굳이 마크다운 글쓰기에 써야 하는지 의문이 들 수 있습니다. 하지만 우리가 작성하는 옵시디언 노트 역시 본질적으로는 구조화된 텍스트 파일(코드)입니다. 그리고 코딩 에이전트가 가장 잘하는 영역을 살펴보면 문서 작업과 완벽히 맞아떨어집니다.

첫째는 로컬 파일의 고속 탐색 능력입니다. 수백, 수천 개의 메모 폴더 사이에서 필요한 문맥과 연결고리를 순식간에 찾아냅니다. 둘째는 자율적인 파일 수정과 생성입니다. AI가 직접 파일을 열어 오타를 고치고, 위키 링크 서식을 정돈하며, 새 문서를 생성해 파일로 저장합니다. 셋째는 버전 관리와 자동 백업입니다. 작업이 끝난 문서를 깃(Git)으로 추적하고 클라우드에 자동으로 올려줍니다.

수십 기가바이트짜리 대규모 소프트웨어 프로젝트를 빌드하고 컴파일하는 것은 모바일 기기에 다소 버거울 수 있지만, 마크다운 문서를 읽고 다듬는 작업은 스마트폰이나 태블릿의 모바일 프로세서에서도 발열이나 배터리 부담 없이 아주 가볍게 구동됩니다. 개발 도구라는 선입견만 살짝 내려놓으면 모바일 기기가 훌륭한 AI 작업실로 바뀝니다.

2. 하드웨어 환경: 스마트폰 화면의 한계와 DeX·태블릿 추천

스마트폰에 터미널을 올리고 AI를 구축했다고 해서 6인치 안팎의 작은 화면을 위아래로 쪼개어 장시간 글을 쓰는 것은 솔직히 권장하지 않습니다. 가상 키보드가 화면 절반을 가려버리는 데다, 좁은 화면에서 마크다운 글과 터미널 로그를 번갈아 보다 보면 눈의 피로도가 너무 높기 때문입니다. 스마트폰의 화면 분할은 이동 중 급한 오타를 고치거나 터미널 상태를 확인하는 비상용에 가깝습니다.

긴 호흡의 문서를 여유롭게 작업하려면 다음 두 가지 하드웨어 환경을 추천합니다.

(1) 스마트폰 유저를 위한 선택: 모니터 연결과 삼성 덱스(Samsung DeX)

가지고 계신 기기가 스마트폰뿐이라면 작은 화면에서 씨름하지 마시고 USB-C 허브나 케이블로 외부 모니터에 연결해 삼성 덱스(DeX) 모드를 켜는 것이 좋습니다. 모니터와 외장 키보드, 마우스가 연결되는 순간 스마트폰은 독립된 데스크톱 PC 환경이 됩니다. 모니터 한쪽에 옵시디언 창을 큼직하게 띄우고 다른 한쪽에 Termux 창을 띄워두면 실제 PC에서 작업하는 것과 다름없는 쾌적함을 얻을 수 있습니다.

(2) 가장 추천하는 최적의 환경: 안드로이드 태블릿 PC

이동성과 작업 편의성을 모두 고려했을 때 가장 이상적인 환경은 단연 11~14인치 안드로이드 태블릿 PC(갤럭시 탭 등)입니다. 시원한 대화면 덕분에 옵시디언과 터미널을 좌우로 넓게 분할해 두어도 답답함이 전혀 없습니다. 키보드 북커버만 챙기면 카페, 도서관, 출장지 등 어디서든 노트북 없이도 온전한 문서 작업대를 펼칠 수 있습니다. 같은 안드로이드 생태계이므로 스마트폰에서 설정했던 Termux 환경과 단축키가 그대로 작동한다는 점도 큰 장점입니다.

[!TIP]
Q. 아이패드(iPad)나 a-Shell 환경에서는 안 되나요?
많은 분들이 고성능 아이패드에서도 가능한지 궁금해하십니다. 하지만 결론부터 말씀드리면 애플의 폐쇄적인 iPadOS 정책 때문에 로컬 구동은 사실상 불가능합니다. a-Shell 같은 터미널 앱은 외부에서 내려받은 바이너리(안티그래비티 CLI 등) 실행을 차단하고 있으며, 앱 간 파일 샌드박스가 철저히 격리되어 터미널과 옵시디언이 같은 폴더를 실시간으로 공유할 수 없습니다. 화면을 전환하거나 끄면 백그라운드 프로세스를 바로 종료해 버리는 점도 큰 걸림돌입니다.

3. 대화면 실전 멀티태스킹 세팅

태블릿이나 DeX 환경을 마련했다면 화면 위에 옵시디언과 Termux를 효과적으로 배치해야 합니다.

가장 정석적인 방법은 좌우 분할 화면입니다. 왼쪽에는 옵시디언을 두고 마크다운으로 렌더링되는 글의 전체 구조를 보며 키보드로 문장을 다듬습니다. 오른쪽에는 Termux를 배치해 안티그래비티 CLI에 명령을 내리고 AI의 문서 작업 과정을 실시간 로그로 확인합니다.

옵시디언의 넓은 화면을 온전히 쓰면서 작업에 몰입하고 싶다면 팝업 화면(Pop-up View)을 활용해도 좋습니다. 옵시디언을 전체 화면으로 띄워둔 상태에서 Termux를 작은 플로팅 창으로 띄우고 투명도를 살짝 조절해 두면, 필요할 때만 가볍게 탭해 AI에게 지시를 내리고 곧바로 접어둘 수 있습니다.

여기서 모바일 실전 팁이 하나 있습니다. 안티그래비티 CLI가 터미널 안에서 새로운 마크다운 문서를 만들거나 기존 글을 크게 수정했을 때, 안드로이드 파일 시스템(FUSE) 특성상 옵시디언 앱의 파일 탐색기에 실시간으로 즉시 나타나지 않을 때가 있습니다. 이때는 당황하지 마시고 최근 앱 보기 화면에서 옵시디언 앱을 위로 쓸어 올려 완전히 종료한 뒤 다시 실행하시면 됩니다. 재실행되는 1초 사이에 옵시디언이 기기 내부의 파일 목록을 새로 읽어 들이며 새 글이 정상적으로 목록에 나타납니다.

4. 안티그래비티 CLI 실행과 실전 작업 흐름

폰이나 Termux가 완전히 꺼진 뒤 다시 작업을 시작할 때는 우분투로 들어가 볼트 경로로 이동해 실행하면 됩니다.

(1) Termux에서 실행하는 기본 루틴

Termux를 열고 나오는 기본 화면($)에서 아래 명령어를 순서대로 실행합니다.

1. 우분투 환경 로그인

proot-distro login ubuntu

2. 옵시디언 볼트 폴더로 이동 후 agy 실행

스마트폰의 Documents 폴더 안에 있는 실제 볼트 경로로 이동하여 agy를 실행합니다.

cd /storage/emulated/0/Documents/내볼트폴더이름 && agy

(기기에 따라 cd /sdcard/Documents/내볼트폴더이름 && agy로 입력하셔도 동일합니다.)

(2) 실전 활용 시나리오

안티그래비티 프롬프트가 열리면 내 볼트의 마크다운 파일들을 직접 다루는 에이전트의 기능을 다음과 같은 흐름으로 활용해 볼 수 있습니다.

시나리오 1: 볼트 내 기존 지식을 탐색해 초안 엮기

일반 웹 챗봇은 내 기기 안에 어떤 메모가 저장되어 있는지 알지 못합니다. 하지만 안티그래비티는 내 볼트 폴더를 직접 탐색할 수 있는 권한을 가지고 있습니다.

내 볼트에 저장된 인공지능 관련 메모들을 먼저 살펴보고, 이를 바탕으로 블로그에 올릴 알기 쉬운 설명 글 초안을 마크다운 파일로 작성해 줘.

명령을 내리면 AI가 볼트 내부의 마크다운 문서를 읽어 연결고리를 파악한 뒤, 내 볼트의 문체와 서식에 맞춘 새 글을 파일 형태로 직접 생성해 줍니다.

시나리오 2: 서식 교정과 위키 링크 자동 연결

생각나는 대로 거칠게 적어둔 메모가 있다면 문서 검수를 맡겨 정돈할 수 있습니다.

방금 작성한 초안에서 H1 태그를 H2 태그로 일괄 변경하고, 문맥에 맞는 핵심 단어들은 우리 볼트의 위키 규칙(별칭)에 맞추어 링크로 변환해 줘.

사람이 일일이 눈으로 찾기 번거로운 서식 오류나 누락된 위키 링크를 빠르고 깔끔하게 정리해 줍니다.

시나리오 3: 말 한마디로 끝내는 깃(Git) 커밋과 푸시

문서 작업이 끝났을 때 깃 명령어를 입력하기 위해 안티그래비티를 종료할 필요가 없습니다. 안티그래비티 CLI는 터미널 명령어를 스스로 실행할 수 있는 에이전트이므로 대화창에 말 한마디만 건네면 백업까지 알아서 마무리합니다.

오늘 작업한 마크다운 문서들 깃(Git)에 커밋하고 깃허브로 푸시해 줘. 커밋 메시지는 변경 내용에 맞게 알아서 깔끔하게 작성해 줘.

AI가 git status와 git diff로 오늘 추가되거나 수정된 파일들을 스스로 확인하고, 변경 내용에 어울리는 커밋 메시지를 생성한 뒤 git add, git commit, git push를 순차적으로 호출해 원격 저장소 백업을 완료합니다. 터미널 명령어를 일일이 입력하지 않고도 대화창 안에서 원스톱으로 동기화가 끝납니다.

5. 백그라운드 세션 꺼짐 방지: 안드로이드 절전 정책 방어

Termux를 안드로이드 기기에 세팅해 두고 며칠 지나면 세션이 예기치 않게 죽어있거나 백그라운드 작업이 강제 종료되는 일을 겪기 쉽습니다. 이는 사용자의 실수가 아니라 안드로이드 OS가 배터리와 메모리를 절약하기 위해 백그라운드 리눅스 프로세스를 정리하기 때문입니다.

특히 삼성 갤럭시 기기는 밤사이 자동으로 실행되는 디바이스 케어 최적화가 터미널 환경을 종료시키는 주원인이 됩니다. 며칠이 지나도 꺼지지 않는 안정적인 작업 환경을 유지하려면 아래 3가지 설정을 점검해 두어야 합니다.

(1) 삼성 갤럭시 필수: 매일 자동으로 최적화 끄기

갤럭시 기기에는 사용하지 않는 새벽 시간에 시스템이 백그라운드 앱을 닫고 램을 정리하는 자동 최적화 기능이 기본으로 켜져 있습니다. 리눅스 세션을 유지해야 하는 환경에서는 Termux 프로세스를 강제로 닫아버리는 원인이 되므로 이 기능을 꺼주어야 합니다.

스마트폰/태블릿의 설정 > 디바이스 케어(또는 배터리 및 디바이스 케어)로 들어갑니다.
자동 최적화(구버전 One UI는 우측 상단 메뉴 > 자동 케어 > 매일 자동으로 최적화) 메뉴로 이동합니다.
매일 자동으로 최적화 토글을 끔(OFF)으로 변경합니다. 최신 One UI 버전이라 세부 스위치만 있다면 자동 재시작이나 자동 최적화 관련 항목을 모두 꺼주세요.
추가로 배터리 > 백그라운드 사용 제한 > 절전 상태로 전환되지 않는 앱 목록에 Termux를 등록합니다.
메모리 > 제외 앱 목록에도 Termux를 추가해 일상적인 램 정리 시 프로세스가 닫히지 않도록 이중으로 방어합니다.

(2) Termux 앱 배터리 사용량 제한 없음 설정

안드로이드 시스템 전역에서 Termux가 절전 감시 대상에서 제외되도록 지정합니다. 기기의 설정 > 애플리케이션 > Termux로 들어가 배터리 항목을 누르고, 기본값인 최적화됨 대신 제한 없음을 선택합니다.

(3) Termux 알림창에서 Acquire WakeLock 활성화

Termux가 실행 중일 때 스마트폰 상단 알림 바를 아래로 쓸어내리면 Termux 상주 알림이 표시됩니다. 여기서 Acquire WakeLock 버튼을 눌러주면 됩니다. 이 설정을 켜두면 화면이 꺼지거나 다른 앱을 오래 보더라도 기기 CPU가 깊은 잠(Deep Sleep)에 빠지지 않고 터미널 프로세스를 안전하게 유지합니다.

6. 우분투 전체 환경 10초 원클릭 압축 백업

기기를 교체하거나 만약의 상황에 대비해 지금까지 세팅한 우분투와 CLI 환경을 백업해 두는 것은 매우 유용합니다. Termux의 PRoot-Distro는 우분투 환경 전체를 압축 파일 하나로 떠내는 백업 기능을 기본으로 지원합니다.

Termux 기본 화면($)에서 아래 한 줄을 실행합니다.

proot-distro backup ubuntu --output ~/storage/shared/Download/ubuntu_backup.tar.gz

약 10초 만에 기기의 다운로드(Download) 폴더 안에 우분투의 모든 설정과 CLI 도구가 고스란히 담긴 압축 파일이 만들어집니다. 새 기기로 넘어가더라도 Termux를 설치하고 proot-distro restore ~/storage/shared/Download/ubuntu_backup.tar.gz 한 줄만 실행하면 동일한 작업 환경을 즉시 복원할 수 있습니다. 이 백업 파일을 클라우드나 외장 메모리에 보관해 두면 안심하고 기기를 운용할 수 있습니다.