본문으로 건너뛰기

새 워크트리를 프로젝트에 맞추세요

기본값으로 시작하세요. 같은 설정 단계를 반복하거나, 같은 에디터를 고르거나, 같은 로컬 파일을 복사하게 될 때 설정을 추가하세요.

어디에 설정할지 정하기​

위치용도
~/.config/gji/config.json여러 저장소에 적용할 개인 기본값
전역 파일의 repos 항목비공개 로컬 파일 이름 등, 특정 저장소에서만 사용할 개인 설정
저장소의 .gji.json공유 프로젝트 기본값

전역 기본값부터 전역 파일의 저장소별 설정, 로컬 .gji.json 순서로 읽어 적용합니다. 나중에 읽은 값이 앞서 읽은 값을 덮어씁니다. 훅은 이벤트 키별로 병합되며, 같은 이벤트의 설정이 있으면 나중에 읽은 값을 사용합니다.

기본 에디터와 브랜치 접두사 저장하기​

gji open --editor cursor --save
gji config set branchPrefix feature/

설치된 에디터 CLI를 사용하세요. config는 전역 기본값을 편집합니다.

gji config get
gji config get branchPrefix
gji config unset branchPrefix

비공개 로컬 파일 복사​

앞으로 만들 워크트리에 이 파일들이 필요한 저장소에서 실행하세요.

gji sync-files add .env.local .npmrc
gji sync-files list
gji sync-files remove .npmrc

목록은 전역 설정 파일에서 해당 저장소의 설정으로 저장합니다. 새 워크트리는 의존성 설정 전에 메인 워크트리에서 파일을 복사합니다. 원본 파일이 없으면 건너뛰며, 대상에 이미 있는 파일은 덮어쓰지 않습니다. 워크트리를 만들 때 한 번 복사하며, 이후에도 계속 동기화하지는 않습니다.

공유할 프로젝트 파일은 대신 .gji.json의 syncFiles에 넣으세요.

{
"syncFiles": [".env.example", ".nvmrc"]
}

의존성 초기 설정​

새 워크트리는 자체 의존성을 갖습니다. gji new나 gji pr이 지원하는 잠금 파일을 찾으면 프로젝트 안에서 적절한 설정을 실행합니다.

프로젝트설정
pnpm, Yarn, Bun, npmJavaScript 의존성 설치
uv, Poetry, PipenvPython 환경 준비
Bundlervendor/bundle에 설치
Composervendor에 설치
Gogo mod download
Cargocargo check 또는 dependencyBuildCommand

다른 워크트리의 의존성 트리나 빌드 캐시를 복사하지는 않습니다. 준비 과정에는 시간이 걸릴 수 있으며, 필요한 도구와 원격 저장소 접근 권한이 있어야 합니다. 설정된 로컬 파일을 먼저 복사하고, 설정이 성공하면 afterCreate 훅이 실행됩니다.

한 번만 설치를 생략하려면 다음과 같이 실행합니다.

gji new feature/search --no-install
gji pr 1234 --no-install

저장소 전체에서 이 기능을 끄려면 .gji.json에 다음을 넣으세요.

{
"dependencyBootstrap": "off"
}

gji new feature/search --dry-run으로 생성 계획을 살펴보세요. JSON 모드와 비대화형 명령도 비활성화하지 않는 한 같은 의존성 설정을 사용합니다. 의존성을 준비하다 실패하더라도 작업을 다시 만들지 말고, 오류에 표시된 워크트리 경로에서 복구하세요. 문제 해결을 참고하세요.

워크트리 디렉터리 선택​

기본값은 ../worktrees/<repo>/<branch>입니다. 다른 기준 디렉터리가 필요한 저장소에서는 .gji.json 또는 전역 저장소별 설정에 worktreePath를 지정하세요.

{
"worktreePath": "~/worktrees/my-repo"
}

브랜치는 이 기준 경로 아래에 배치됩니다. feature/search는 ~/worktrees/my-repo/feature/search가 됩니다. 절대 경로나 ~/ 경로를 사용하세요. 상대 경로는 경고와 함께 무시됩니다. 이 설정은 이후 생성에 적용되며 기존 워크트리 위치는 바꾸지 않습니다.

다른 동기화 대상 사용​

{
"syncRemote": "upstream",
"syncDefaultBranch": "main"
}

gji sync의 대상과 gji new --branch-only가 사용하는 원격 기본 브랜치를 지정합니다. 동기화와 정리를 참고하세요.

개인 설정을 Git에 올리지 않고 저장소별로 관리하기​

~/.config/gji/config.json에서 설정합니다.

{
"repos": {
"/home/me/code/my-repo": {
"editor": "zed",
"syncFiles": [".env.local"],
"hooks": {
"afterCreate": ["pnpm", "run", "generate"]
}
}
}
}

저장소 항목에는 절대 경로를 사용하세요. 지정한 저장소에만 재정의한 값이 적용됩니다.

설정 키 살펴보기​

키용도
branchPrefixfeature/ 같은 새 브랜치 이름의 접두사
editoropen과 new --open의 기본 에디터 CLI
worktreePath새 워크트리의 기준 디렉터리. 절대 경로 또는 ~/ 경로
syncRemote동기화에 사용할 원격 저장소
syncDefaultBranch동기화 대상으로 사용할 기본 브랜치
syncFiles생성 시 메인 워크트리에서 복사할 파일
dependencyBootstrap자동 의존성 설정을 끄려면 off로 설정
dependencyBuildCommand선택 사항인 Cargo 설정 명령. 기본값은 cargo check
shellIntegration마법사에서 저장한 셸 설정 선택
installSaveTarget설정 마법사의 설정을 로컬 또는 전역 중 어디에 저장할지 지정
hooks생성, 이동, 전환, 제거 시 실행할 훅 명령
repos전역 설정의 저장소별 재정의