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를 참고하세요.
Metadata
Release files for aos-git 0.13.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| aos_git-0.13.1.tar.gz | 68.2 kB | Without provenance | Details for aos_git-0.13.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| aos_git-0.13.1-py3-none-any.whl | Python 3 | none | any | Details for aos_git-0.13.1-py3-none-any.whl |
Total release size: 139.6 kB
Release files / aos_git-0.13.1.tar.gz
| Download URL | aos_git-0.13.1.tar.gz |
|---|---|
| Size | 68.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c0ba740947e4ff203d68220d4069fff4b861a0796e03250cb91bfd9beb7d5206
|
|
BLAKE2b-256 checksum How to use checksums |
cb77e812a7762655439726099f81c6e5faa8223662d421f93136619a52769ccf
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.10
|
Release files / aos_git-0.13.1-py3-none-any.whl
| Download URL | aos_git-0.13.1-py3-none-any.whl |
|---|---|
| Size | 71.4 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
131d4410341358a2f609a54ad544bff9af9473d8486520cf632de190349c72da
|
|
BLAKE2b-256 checksum How to use checksums |
e5a1d556bbf80ce29b3f581db136c475bad43d63d667156e3fb26ffe2d76b7d7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.10
|
Security for aos-git 0.13.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.