Speedy0000007/claude-tandem

claude-tandem은(는) 무엇을 하나요?

🔧 jq 의존성을 가진 경량 bash 플러그인을 사용하여 구조화된 메모리, 세션 인계, 입력 명확성으로 Claude Code를 향상시킵니다.

개요

claude-tandem은 Claude Code 개발 에이전트를 위한 경량 bash 플러그인으로, 구조화된 메모리, 세션 인계, 향상된 입력 처리를 추가합니다. 모든 현대 AI 코딩 도구와 원활하게 통합되도록 설계되었습니다.

요구 사항

• jq 명령줄 JSON 프로세서
• Bash 4.0+
• Claude Code (또는 호환되는 AI 코딩 에이전트)

설치

# 저장소 복제
git clone https://github.com/Speedy0000007/claude-tandem.git
cd claude-tandem

# 환경 설정
cp .env.example .env
# .env 파일을 편집하여 설정을 구성하세요

# 스크립트를 PATH에 추가
export PATH="$PWD/bin:$PATH"

사용법

세션 시작

# 새 세션 초기화
claude-tandem init --session my_project

# 세션에 컨텍스트 추가
claude-tandem add --context "현재 작업: 사용자 인증 모듈 리팩토링"

# 작업 상태 저장
claude-tandem status --task "auth-refactor" --state "진행 중" --note "OAuth2 구현 중"

세션 인계

# 현재 세션 내보내기
claude-tandem export --file handoff.json

# 세션 가져오기 (다른 에이전트가)
claude-tandem import --file handoff.json

입력 명확성

# 모호한 입력 확인
claude-tandem clarify "이전 작업 수정"
# 출력: "'이전 작업 수정'이 무슨 뜻인지 명확히 해주세요. 작업 ID나 설명을 제공해 주시겠습니까?"

명령어

명령어	설명
init	새 세션 초기화
add	세션에 컨텍스트 추가
status	작업 상태 설정
export	세션 데이터를 JSON으로 내보내기
import	JSON에서 세션 데이터 가져오기
clarify	모호한 입력을 명확하게 하기 위해 확인

구성

claude-tandem은 .env 파일 또는 환경 변수를 통해 구성됩니다:

• TANDEM_SESSION_DIR: 세션 파일이 저장되는 디렉토리 (기본값: ~/.tandem/sessions)
• TANDEM_MAX_HISTORY: 세션당 최대 기억 항목 수 (기본값: 100)
• TANDEM_LOG_LEVEL: 로깅 상세도 (debug, info, warn, error)

작동 방식

이 플러그인은 Claude Code(및 유사 에이전트)와 함께 작동하는 bash 함수 래퍼 세트를 제공합니다. 주요 메커니즘은 다음과 같습니다:

1. 구조화된 메모리: 세션 데이터는 jq로 처리된 JSON 파일에 저장되어 빠른 조회와 수정이 가능합니다.
2. 세션 인계: 전체 세션 상태를 JSON으로 내보내고 가져와서 다른 AI 에이전트가 중단된 지점부터 작업을 계속할 수 있습니다.
3. 입력 명확성: 플러그인은 명시적인 컨텍스트 없이 자연어 명령을 분석하고 명확하게 하기 위해 확인을 요청합니다.

기여하기

기여를 환영합니다! Pull 요청을 제출하기 전에 문제를 열어 변경 사항을 논의해 주세요.

라이선스

MIT