devsync init

형식

devsync init [repository]

설명

devsync init은 Devsync 환경을 처음 구성할 때 실행하는 명령이에요. 새로운 로컬 동기화 저장소를 만들거나, 이미 존재하는 원격 저장소를 ~/.config/devsync/sync/에 클론해요.

저장소 URL 없이 실행하면 새 git 저장소를 초기화하고 age 암호화 키를 생성해요. URL을 지정하면 해당 저장소를 클론하고, 저장된 시크릿을 복호화하는 데 필요한 age 개인 키를 입력하도록 안내해요.

초기화가 완료되면 다음 파일과 디렉터리가 생성돼요:

• ~/.config/devsync/sync/ — 동기화 저장소 디렉터리
• ~/.config/devsync/settings.json — 런타임 설정(활성 프로파일, identity 경로 등)
• ~/.config/devsync/age/keys.txt — age 키 저장 파일

인수

인수	설명
repository	선택 사항. 클론할 git 저장소 URL (HTTPS 또는 SSH).

옵션

플래그	설명
--identity PATH	age identity 파일 경로를 settings.json에 저장해요. 패스워드 매니저나 별도의 안전한 위치에 키를 보관하는 경우 유용해요.
--key KEY	age 개인 키(AGE-SECRET-KEY-…)를 직접 전달해요. 스크립트나 비대화형 설정 시 유용해요.
--recipient AGE1...	age recipient 공개 키를 추가해요. 반복 사용 가능하며, 여러 명이 시크릿을 복호화할 수 있도록 공유할 때 사용해요.
--verbose	초기화 과정의 상세 출력을 표시해요.

예시

새 저장소

# 새 로컬 동기화 저장소 생성 및 age 키 자동 생성
devsync init

기존 저장소 클론

# GitHub에서 기존 동기화 저장소 클론
devsync init https://github.com/yourname/dotfiles.git

키 직접 전달

# 클론과 함께 age 키를 비대화형으로 전달
devsync init https://github.com/yourname/dotfiles.git \
  --key AGE-SECRET-KEY-1QQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQQ

외부 identity 파일

# 별도 위치에 보관 중인 age identity 파일 지정
devsync init --identity ~/.secrets/age-identity.txt

팀 recipient 추가

# 여러 팀원이 시크릿을 복호화할 수 있도록 recipient 추가
devsync init \
  --recipient age1alice... \
  --recipient age1bob...

참고

참고

이미 설정이 된 환경에서 devsync init을 다시 실행해도 기존 동기화 데이터는 사라지지 않아요. age identity 경로를 변경하거나 recipient를 추가할 때 안전하게 재실행할 수 있어요.

주의

--key를 사용하면 age 개인 키가 셸 히스토리에 기록될 수 있어요. 보안을 위해 --identity로 키 파일 경로를 지정하거나, 히스토리에 남지 않도록 명령 앞에 공백을 붙이는 방식을 권장해요.

초기화 후에는 devsync track으로 파일을 등록하고, devsync push로 동기화를 시작해 보세요.