aos — AI-powered Git Helper
git을 몰라도, AI가 충돌을 해결해주는 Git 도우미입니다.
🚀 5분 만에 시작하기 (팀원)
pip install aos-git # 설치
cd 내프로젝트 && aos init # 프로젝트 초기화 (hooks + 알림 수신자)
aos setup # Databricks Token 입력만 (SMTP/AI는 사내 기본값 자동 적용)
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 |
AI 제공자 / SMTP / 토큰을 설정할 때 | 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회만 실행 (AI + SMTP).
Q: SMTP 비밀번호는 어디에 저장되나요?
~/.aos/config.toml에 로컬에서만 저장됩니다. 프로젝트에는 host/port/sender만 저장되고 비밀번호는 공유되지 않습니다.
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를参照하세요.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file aos_git-0.11.1.tar.gz.
File metadata
- Download URL: aos_git-0.11.1.tar.gz
- Upload date:
- Size: 65.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.10
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5c31d2b8c6d957a7d5caca84ef66eef66fcef07f244c2925b7949757e9dfd1d7
|
|
| MD5 |
42183e3944cf3d9a8791a16e88e6fa89
|
|
| BLAKE2b-256 |
a1fa2ff96b7344a407806322ee3608f56e27665e61c14541174fc016fbf57c1b
|
File details
Details for the file aos_git-0.11.1-py3-none-any.whl.
File metadata
- Download URL: aos_git-0.11.1-py3-none-any.whl
- Upload date:
- Size: 69.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.10
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
36e421b3000854d07c741b5ca915410d0861a3300c1ca74fa6c6ee4c5f03d1fb
|
|
| MD5 |
1156823c85e24b5f3229d59e12ce83dd
|
|
| BLAKE2b-256 |
fd9c8a10a5d4bb22090589bb92cfd70487f16d8218190ce264675aaf11dd4d43
|
