ax-tools

Personal AX (AI Experience) tools — Claude Code / Obsidian vault 워크플로우를 일상에 녹이는 UI·integration 도구들.

작성자	Go-MinSeong
관련 repos	obsidian-vault (데이터) · ms-claude-plugin (CC plugin)
라이선스	UNLICENSED (private)

🎯 이 repo의 위치

Go-MinSeong/
├── obsidian-vault/         ← 데이터 (개인 작업 로그)
├── ms-claude-plugin/       ← CC plugin marketplace
└── ax-tools/               ← UI·integration·companion 도구  ← THIS REPO

책임 분리:

• obsidian-vault: 내가 매일 쌓는 데이터 (daily, projects, reports, ...)
• ms-claude-plugin: CC 안에서 동작하는 코드 (hooks, slash commands)
• ax-tools: CC 밖에서 데이터·CC를 잇는 UI 도구들 (SwiftBar, Shortcuts, Raycast, ...)

📦 도구 카탈로그

도구	디렉토리	설명	환경
SwiftBar plugin	swiftbar/	macOS 메뉴바에서 vault 상태·액션을 한 클릭	macOS + SwiftBar
macOS Shortcuts	macos-shortcuts/	Morning Brief / Evening Wrap 키보드 단축키용	macOS Shortcuts.app
velog-obsidian	velog-obsidian/	Obsidian vault ↔ Velog 동기화 (CLI + 메뉴바). Notion/PDF에서 paper review import 후 발행까지	macOS + Python 3.11+

추가 예정 (계획)

도구	상태
Raycast extension	계획
Alfred workflow	계획
Hammerspoon config	검토
iOS Shortcuts (모바일 trigger)	검토
브라우저 확장 (selection → vault)	검토

🔧 공통 환경 변수

모든 도구가 사용하는 환경 변수:

변수	기본값	설명
VAULT_PATH	~/obsidian-vault	Obsidian vault clone 위치
OBSIDIAN_VAULT_NAME	obsidian-vault	Obsidian이 인식하는 vault 이름
CLAUDE_BIN	~/.local/bin/claude	Claude Code CLI 경로

설정: ~/.zshrc 또는 도구별 wrapper에서 export.

🚀 처음 설치 (모든 도구)

# 1. clone
git clone git@github.com:Go-MinSeong/ax-tools.git ~/ax-tools
# 또는 HTTPS
git clone https://github.com/Go-MinSeong/ax-tools.git ~/ax-tools

# 2. 각 sub-tool README 참고
cat ~/ax-tools/swiftbar/README.md
cat ~/ax-tools/macos-shortcuts/README.md

🧩 설계 원칙

1. VAULT_PATH로 일반화 — 어느 vault 위치든 동작
2. 각 sub-tool 독립적 — SwiftBar 안 써도 Shortcuts만 쓸 수 있음
3. 명확한 분리 — UI 코드는 vault에 안 섞임
4. 간결한 README — 각 sub-tool 5분 안에 설치 가능

📚 관련 문서

obsidian-vault/docs/ 에:

• SETUP.md — 시스템 전체 세팅
• USER-MANUAL.md — 기능 reference
• SCENARIOS.md — 사용 시나리오
• AX-STUDY.md — AX 스터디 발표 정리