@own-it/cli

Own-it CLI for AI Journey tracking - Git 커밋과 Claude Code 세션을 자동으로 동기화하는 CLI 도구

📦 설치

npx 사용 (권장)

npx own-it init

글로벌 설치

npm install -g @own-it/cli
own-it init

🚀 사용법

1. 프로젝트 초기화

프로젝트 루트 디렉토리에서 실행하세요:

npx own-it init

초기화 과정:

1. Git 저장소 확인 - Git repository와 remote origin 확인
2. API 키 입력 - Own-it Dashboard에서 발급받은 API 키 입력
3. API 키 검증 - 사용자 인증 확인
4. 프로젝트 등록 확인 - Web Dashboard에 등록된 프로젝트인지 확인
5. Git Hook 설치 - post-commit hook 자동 설치

2. API 키 발급

1. https://own-it.dev/settings/api-keys 접속
2. "Create API Key" 버튼 클릭
3. API 키 복사

3. 프로젝트 등록

CLI 초기화 전에 먼저 Web Dashboard에서 프로젝트를 등록해야 합니다:

1. https://own-it.dev/projects 접속
2. "Link Project" 버튼 클릭
3. GitHub 저장소 선택
4. npx own-it init 실행

📋 요구사항

• Node.js: 20+ (권장)
• Git: Git 저장소 필수
• Remote Origin: GitHub repository URL 설정 필요
• Claude Code: ~/.claude/projects/ 디렉토리 (선택사항)

🔧 동작 방식

Git Hook (post-commit)

커밋 시 자동으로 실행되는 Hook:

# 커밋 정보 수집
COMMIT_HASH=$(git rev-parse HEAD)
COMMIT_MESSAGE=$(git log -1 --pretty=%B)
BRANCH=$(git rev-parse --abbrev-ref HEAD)

# Claude 세션 파일 감지 (30분 이내 수정)
SESSION_FILE=$(find "$CLAUDE_PATH" -name "*.jsonl" -mmin -30 -print -quit)

# API로 세션 전송
curl -X POST "$API_URL/sync" \
  -H "Authorization: Bearer $API_KEY" \
  -F "projectId=$PROJECT_ID" \
  -F "commit=$COMMIT_HASH" \
  -F "session=@$SESSION_FILE"

설정 파일 (.own-it)

프로젝트 루트에 생성되는 설정 파일:

{
  "projectId": "proj_abc123",
  "claudePath": "~/.claude/projects/...",
  "createdAt": "2025-12-26T10:00:00Z"
}

🚨 문제 해결

"Git 저장소가 아닙니다"

git init
git remote add origin <repository-url>

"프로젝트가 등록되지 않았습니다"

1. https://own-it.dev/projects 접속
2. "Link Project" 버튼 클릭
3. 저장소 선택
4. 다시 npx own-it init 실행

"API 키가 유효하지 않습니다"

1. https://own-it.dev/settings/api-keys 에서 새 API 키 발급
2. 다시 npx own-it init 실행

"Claude Code 경로를 찾을 수 없습니다"

• Claude Code를 사용하지 않는 경우 무시해도 됩니다
• Claude Code 사용 시 ~/.claude/projects/ 디렉토리가 있는지 확인

🔒 보안

• API 키 보호: Git Hook 스크립트에 평문으로 저장됨 (.git/hooks/ 디렉토리는 .gitignore 대상)
• .own-it 파일: .gitignore에 추가하는 것을 권장

.own-it

📖 참고 문서

• Own-it AI Journey 기술 스펙
• CLI 플로우 다이어그램
• 로드맵

🛠 개발

로컬 빌드

cd packages/cli
pnpm install
pnpm build

로컬 링크

cd packages/cli
pnpm link --global

# 테스트 프로젝트에서
cd ~/my-test-project
npx own-it init

타입 체크

pnpm type-check

📝 라이센스

MIT

👥 기여자

• 황인준 - Backend/CLI 개발
• 윤누리 - Frontend 개발