AI4PKM 터미널 설치 가이드
AI4PKM Terminal 설치 가이드
AI4PKM 시스템을 설치하고 첫 실습을 진행하는 가이드입니다.
왜 CLI Agent인가?
CLI Agent는 터미널에서 실행되는 명령줄 기반 AI 어시스턴트입니다.
ChatGPT와의 차이점:
| 구분 | ChatGPT | CLI Agent (Gemini 등) |
|---|---|---|
| 인터페이스 | 웹/앱 (대화창) | 터미널 (CLI) |
| 파일 접근 | 업로드 필요 | Vault 파일 직접 읽기/쓰기 |
| 명령 실행 | 불가 | 터미널 명령 실행 가능 |
| 자동화 | 수동 복사/붙여넣기 | 스크립트, Orchestrator 연동 |
CLI Agent의 장점:
- Obsidian Vault의 모든 파일에 직접 접근
- 파일 생성, 수정, 삭제를 AI가 직접 수행
- 반복 작업을 스크립트로 자동화 가능
- 프롬프트와 스킬을 재사용 가능
더 자세한 설명은 (0) 실전 가이드 개요#CLI Agent란?을 참조하세요.
기본 환경 구축
이 실습의 목적은 AI Agent를 PKM에 접목하는 원리를 이해하고, 향후 활용을 위한 기초를 다지는 것입니다.
설치 순서
1. Obsidian 설치
Obsidian을 다운로드하여 설치합니다.
2. Gemini CLI 설치
터미널에서 다음 명령어를 실행합니다:
# Node.js LTS 버전 설치 (nvm 사용 시)
nvm install --lts && nvm use
# Gemini CLI 설치
npm install -g @anthropic-ai/gemini-cli
# 설치 확인
gemini --version
설치 방법 상세: Gemini CLI GitHub
Gemini CLI 외에도 다음 CLI Agent를 사용할 수 있습니다:
- Claude Code - 스킬 시스템과 MCP 연동 지원
- Codex CLI
3. AI4PKM Starter Vault 다운로드
# Vault 경로 설정 (예: ~/Vaults/AI4PKM)
VAULT_PATH=~/Vaults/AI4PKM
# 저장소 클론 후 Vault 폴더로 이동
git clone https://github.com/jykim/AI4PKM
mv AI4PKM/ai4pkm_vault $VAULT_PATH
Starter Vault 위치: ai4pkm_vault
4. Gemini CLI 실행
# Vault 디렉토리로 이동
cd $VAULT_PATH
# Gemini CLI 실행
gemini
%20%EC%82%AC%EC%9A%A9%EC%9E%90%20%EA%B0%80%EC%9D%B4%EB%93%9C/_files_/pkm-practice-gemini0.png)
Gemini CLI를 Vault에서 실행한 모습
콘텐츠 추가하기
VAULT_PATH/Ingest 폴더에 PKM의 대상이 될 정보와 지식(INK)을 추가합니다.
콘텐츠 가져오기 방법
| 방법 | 설명 |
|---|---|
| Obsidian Importer | 기존 노트 앱(Notion, Evernote 등)에서 마이그레이션 |
| Obsidian Web Clipper | 웹 페이지를 마크다운으로 저장 |
| 직접 복사 | 일반 문서를 Ingest 폴더에 복사 |
| MCP 서버 | Google Drive 등 외부 서비스 연동 |
추천 콘텐츠 소스:
- Forte Labs Blog - Building a Second Brain
- 브런치 세컨드브레인 - 한국어 PKM 콘텐츠
PKM 실습
이번 실습의 목표는 Daily Ingestion and Roundup (DIR) 워크플로우를 따라해보는 것입니다.
Step 1: Ingestion & Enrichment
Web Clipper로 PKM 관련 블로그 글을 가져옵니다.
Gemini에서 실행:
EIC 프롬프트로 Ingest 폴더의 새 파일들을 처리해줘
EIC 프롬프트로 요약된 결과 (Right)와 원문 (Left) 비교
AI가 영문 아티클을 한글로 번역/요약하여 효율적인 정보 습득을 돕습니다.
Step 2: Daily Report
가져온 콘텐츠를 바탕으로 Daily Roundup Report를 생성합니다.
Gemini에서 실행:
GDR 오늘 날짜로 Daily Roundup 만들어줘
%20%EC%82%AC%EC%9A%A9%EC%9E%90%20%EA%B0%80%EC%9D%B4%EB%93%9C/_files_/pkm-practice-gemini1.png)
GDR 명령 실행 화면
생성된 Daily Roundup 예시:
%20%EC%82%AC%EC%9A%A9%EC%9E%90%20%EA%B0%80%EC%9D%B4%EB%93%9C/_files_/daily-roundup.png)
생성된 Daily Roundup 문서
Step 3: Topic Creation
주제별 지식 접근을 위한 Topic 노트를 생성합니다.
Gemini에서 실행:
오늘 Ingest한 콘텐츠를 바탕으로 어떤 토픽이 좋을지 추천해줘
%20%EC%82%AC%EC%9A%A9%EC%9E%90%20%EA%B0%80%EC%9D%B4%EB%93%9C/_files_/pkm-practice-gemini2.png)
토픽 추천 결과
토픽 페이지 생성:
TKC 프롬프트로 "Second Brain" 토픽 페이지 생성해줘
%20%EC%82%AC%EC%9A%A9%EC%9E%90%20%EA%B0%80%EC%9D%B4%EB%93%9C/_files_/pkm-practice-gemini4.png)
TKC 프롬프트로 토픽 페이지 생성
Graph View 확인:
%20%EC%82%AC%EC%9A%A9%EC%9E%90%20%EA%B0%80%EC%9D%B4%EB%93%9C/_files_/pkm-graph-view.png)
Second Brain 토픽 중심 그래프 (노트 유형별 색상 구분)
PKM 활용 사례
소셜 미디어 포스팅 생성
배운 것을 소셜 미디어에 공유하는 것은 지식 성장에 도움이 됩니다.
Gemini에서 실행:
CTP 오늘 Ingest한 내용 바탕으로 스레드 포스팅 만들어줘
(원문을 살려서 한글로; PKM에 대해 흥미를 일으키는 내용; 포스팅 별로 출처 링크 포함)
%20%EC%82%AC%EC%9A%A9%EC%9E%90%20%EA%B0%80%EC%9D%B4%EB%93%9C/_files_/ctp-example.png)
CTP 프롬프트로 생성된 소셜 미디어 포스팅
Ad-hoc Research
습득한 지식에 기반한 질문을 해봅니다.
Gemini에서 실행:
ARP Zettelkasten과 Second Brain 방법론의 유사점과 차이점,
그리고 이를 통합한 새로운 방법론을 제안해줘
%20%EC%82%AC%EC%9A%A9%EC%9E%90%20%EA%B0%80%EC%9D%B4%EB%93%9C/_files_/pkm-arp-results.png)
ARP 프롬프트로 지식 기반 분석 결과
핵심 프롬프트 요약
| 프롬프트 | 약어 | 용도 |
|---|---|---|
| Enrich Ingested Content | EIC | 새 콘텐츠 요약/번역 |
| Generate Daily Roundup | GDR | 일일 리포트 생성 |
| Topic Knowledge Creation | TKC | 토픽 페이지 생성 |
| Create Thread Postings | CTP | 소셜 미디어 포스팅 |
| Ad-hoc Research within PKM | ARP | 지식 기반 질의 |
다음 단계
PKM 설치와 기본 실습을 완료했습니다. 이제:
- 더 많은 콘텐츠 추가: 다양한 소스에서 지식을 수집
- 토픽 확장: 관심 분야별 토픽 페이지 생성
- 자동화 설정: Orchestrator로 워크플로우 자동화
참조
- AI4PKM GitHub
- (0) 실전 가이드 개요 - 도구 선택 가이드
- (3) Agent Skill 가이드 - 스킬 상세 설명
- (0) Orchestrator 개요 - 자동화 아키텍처
학습 경로
| 이전 | 현재 | 다음 |
|---|---|---|
| (0) 실전 가이드 개요 | AI4PKM Terminal 설치 가이드 | (2) Gobi Desktop 가이드 |
관련 문서:
- 용어 사전 - 핵심 용어 정의
- (4) Orchestrator 설정 - 자동화 설정