Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
Kosho는 `git worktree`를 활용하여 여러 브랜치에서 동시에 독립적으로 작업할 수 있게 돕는 도구입니다. 특히 Claude Code와 같은 AI 코딩 에이전트를 여러 기능이나 브랜치에 걸쳐 격리된 환경에서 실행해야 할 때 유용합니다. 이를 통해 저장소 클론 및 컨텍스트 전환의 오버헤드를 줄이고 효율성을 높일 수 있습니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub Claude Ecosystem의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기Kosho는 .kosho/ 디렉터리 내에서 git worktree를 생성하고 관리하여, 저장소를 클론하거나 컨텍스트를 전환하는 오버헤드 없이 여러 브랜치에서 동시에 작업하기 쉽게 만듭니다.
go install github.com/carlsverre/kosho@latest
Kosho는 Claude Code와 같은 여러 동시 AI 코딩 에이전트를 각각 다른 기능이나 브랜치에서 별도의 작업 공간으로 실행하는 데 적합합니다:
.git 디렉터리를 공유하므로 중복된 저장소가 생기지 않습니다.kosho list를 사용하여 각 에이전트가 무엇을 하고 있는지 확인할 수 있습니다.Claude Code를 사용한 예시 워크플로우:
# 기능 브랜치에서 Claude Code 시작
kosho open feat/widget claude
...
작업 트리에서 명령어 실행:
kosho run my-feature claude
모든 작업 트리를 나열:
kosho list
깨끗한 작업 트리 정리 (Prune):
kosho prune
kosho run BRANCH [command...]지정된 BRANCH에서 체크아웃된 작업 트리 내에서 제공된 명령어를 실행합니다. 만약 해당 작업 트리가 존재하지 않으면 생성됩니다.
인수:
BRANCH: git 브랜치 이름command...: 작업 트리에서 실행하려는 모든 명령어. 예: claude예시:
# bugfix 작업 트리에서 claude 실행
kosho run bugfix claude
...
kosho list모든 kosho 작업 트리를 상태와 현재 git 참조와 함께 나열합니다.
출력:
NAME UPSTREAM REF STATUS
bugfix main bugfix ahead 1
hotfix main bug/1 ahead 2 (dirty)
...
kosho prune깨끗한 작업 트리와 유기(dangling) 작업 트리 참조를 정리합니다. 이 명령어는 git 브랜치를 삭제하지 않습니다! 병합된 git 브랜치까지 정리하고 싶다면, 다음과 유사한 스크립트를 만드는 것을 권장합니다:
git-janitor:
#!/usr/bin/env bash
kosho prune
git fetch --prune
...
그런 다음 이 스크립트(만약 $PATH에 있다면)를 git janitor를 통해 실행할 수 있습니다.
Kosho는 작업 트리 작업 중 특정 시점에 실행되는 훅을 지원합니다. 훅은 .kosho/hooks/에 저장된 실행 가능한 스크립트이며, 해당 작업에 대한 컨텍스트를 담은 환경 변수를 받습니다.
create: 새로운 작업 트리가 생성된 후, 이를 열기 전에 실행됩니다.run: 작업 트리에서 명령을 실행하기 전에 실행됩니다.Kosho는 .kosho/hooks/에 샘플 훅 파일(.sample 확장자)을 자동으로 생성합니다. 훅을 활성화하려면 다음 명령어를 사용하세요:
# create 훅 활성화
mv .kosho/hooks/create.sample .kosho/hooks/create
훅은 다음과 같은 환경 변수를 받습니다:
$KOSHO_HOOK: 훅 유형 (create, run)$KOSHO_WORKTREE: 작업 트리가 수행되는 이름$KOSHO_REPO: 리포지토리 루트 경로$PWD / $KOSHO_WORKTREE_PATH: 작업 트리 디렉터리의 전체 경로 (훅은 작업 트리 디렉터리 내에서도 실행됩니다)$KOSHO_CMD: 작업 트리에서 실행되는 명령어의 이름. run 훅에서만 존재합니다.예시 create 훅 (.kosho/hooks/create):
#!/bin/sh
echo
각 작업 트리(worktree)는 동일한 git 히스토리를 공유하지만, 서로 다른 브랜치가 체크아웃되고 다른 작업 상태를 가질 수 있는 완전한 작업 디렉토리입니다.
## 쉘 자동 완성 (Shell Completion)
Kosho는 bash, zsh, fish, 그리고 PowerShell에 대한 탭 자동 완성을 지원합니다. 쉘에 대한 자동 완성을 설정하려면 다음을 수행하세요:
```bash
kosho completion <shell> --help
이 명령어는 사용자의 쉘에 맞는 자세한 설정 지침을 출력합니다.
.kosho 디렉토리는 자동으로 .gitignore에 추가됩니다.kosho list를 사용하여 모든 작업 트리의 상태를 한눈에 확인하세요.kosho prune을 사용하여 오래된 작업 트리를 정리하는 것이 좋습니다.