aos — AI-powered Git Helper

git을 몰라도, AI가 충돌을 해결해주는 Git 도우미입니다.

🚀 5분 만에 시작하기 (팀원)

pip install aos-git           # 설치
cd 내프로젝트 && aos init      # 프로젝트 초기화 (hooks + 알림 수신자)
# aos setup                    # 선택사항 — 메일 알림이 필요할 때만: aos setup
aos doctor                    # 모든 항목 ✔ 확인

자세한 가이드:

👥 팀원 → docs/03-team-member-quickstart.md
👑 관리자 → docs/03-admin-guide.md

🔥 이 5개만 알면 됩니다

명령어	언제 쓰나요
`aos init`	프로젝트에 aos 처음 설정할 때 (hooks + 알림)
`aos setup`	Databricks Token 설정 (SMTP/AI는 사내 기본값); `--notify`로 수신자/관리자 변경
`aos checkout -b feature/내작업`	새 브랜치를 만들어 작업 시작할 때
`aos commit -m "작업 내용"`	변경사항을 커밋할 때
`aos push`	커밋한 내용을 원격에 올릴 때 (팀원에게 이메일 자동 발송)

📋 일상 작업 흐름

# 1. 새 브랜치에서 시작
aos checkout -b feature/데이터정제

# 2. 코드 수정 후
aos add                           # 변경사항 스테이징
aos commit -m "데이터 정제 로직 추가"  # 커밋
aos push                          # push → 팀원에게 이메일 자동 발송

# 3. 메일 수신 후 (상대방 작업 반영)
aos sync      # 충돌 시 AI가 자동 해결 후 커밋
aos push

🩺 문제 해결

aos doctor                  # 한 방에 진단

자주 보는 ✗ 와 해결

화면 메시지	원인	해결
전역 설정 파일이 없습니다	`~/.aos/config.toml` 없음	`aos setup`
수신자(recipients) 비어있음	팀원 이메일 미등록	`aos setup --notify`
pre-push hook 미설치	hooksPath 미설정	`aos init --hooks-only`

💡 가장 빠른 진단: aos doctor. ✗ 항목마다 정확한 해결 명령어가 표시됩니다.

📖 전체 명령어 레퍼런스

명령어	설명	예시
`aos init`	프로젝트에 aos 처음 설정 (hooks + 알림 수신자)	`aos init`
`aos setup`	Databricks Token 설정 (SMTP/AI는 사내 기본값); `--notify`로 수신자/관리자 변경	`aos setup --notify`
`aos checkout`	브랜치 전환 / 생성 (화살표 선택 가능)	`aos checkout -b feature/x`
`aos branch`	브랜치 목록 / 삭제	`aos branch -a`
`aos add`	변경사항 스테이징 (파일 미지정 시 전체)	`aos add src/`
`aos commit`	커밋 (AI 충돌 해결이 필요하면 자동으로 처리)	`aos commit -m "fix: .."`
`aos push`	원격에 올리기 + 팀원 이메일 발송	`aos push`
`aos sync`	최신 main을 내 브랜치에 반영 (충돌 시 AI 자동 해결)	`aos sync`
`aos merge`	다른 브랜치를 병합 (충돌 시 AI 자동 해결)	`aos merge feature/x`
`aos resolve`	남아 있는 충돌 수동 해결 후 스테이징	`aos resolve`
`aos release`	PyPI 자동 배포 (patch / minor / major)	`aos release patch`
`aos status`	현재 상태 확인	`aos status`
`aos doctor`	전체 환경 진단	`aos doctor`
`aos install`	전역 skill 설치	`aos install`

처음 사용자

Q: aos init과 aos setup은 뭐가 다릅니까? aos init은 프로젝트별로 실행 (hooks + 알림 수신자), aos setup은 내 PC에서 1회만 실행 (Databricks Token).

Q: --hooks-only는 언제 쓰나요? aos init을 실행했더라도 hook만 다시 설치하고 싶을 때.

Claude Code 연동

Q: Claude Code와 aos를 함께 쓸 수 있나요? 네. Claude Code 안에서 !aos push처럼 shell을 통해 aos 명령어를 그대로 사용 가능합니다.

Claude Code / AI coding 도구 연동

aos의 모든 명령어는 CLI로 제공되므로, Claude Code, GitHub Copilot Chat, Cursor 등 AI 코딩 어시스턴트 안에서도 그대로 사용할 수 있습니다.

# Claude Code 안에서 실행
!aos push

# Copilot Chat에서
/aos sync

설치

pip install aos-git

자세한 설치 방법은 docs/03-admin-guide.md를 참고하세요.

Release files for aos-git 0.12.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aos-git 0.12.1
File	Size	Uploaded
aos_git-0.12.1.tar.gz	66.5 kB	Sep 15, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for aos-git 0.12.1
File	Interpreter	ABI	Platform	Reset
aos_git-0.12.1-py3-none-any.whl 70.3 kB Sep 15, 2026	Python 3	none	any	Details

Total release size: 136.8 kB

Release files / aos_git-0.12.1.tar.gz

Download URL	aos_git-0.12.1.tar.gz
Size	66.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`f4fb6710ab570fbcd26789f3b026953a01d9d4cefb9f430376b108996895233a`
BLAKE2b-256 checksum How to use checksums	`7de006ae59ab06636d9f0b00722df275a9616d9f26e7e73032f77e295de3e6f3`
Upload date	Sep 15, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.10`

Release files / aos_git-0.12.1-py3-none-any.whl

Download URL	aos_git-0.12.1-py3-none-any.whl
Size	70.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`6d255dd279a7edf53f0392786a64dd388197bfce8aa8ed755b90406995657e75`
BLAKE2b-256 checksum How to use checksums	`52532062ad5f2344981498aa24cd8101c808746e65b01396546683f58aba40ed`
Upload date	Sep 15, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.10`