TOD - TheOneDev CLI 도구

TOD(TheOneDev)는 OneDev 13 이상을 위한 강력한 명령줄 도구로, 로컬 변경 사항에 대해 CI/CD 작업을 실행하고, 풀 리퀘스트를 로컬 작업 디렉토리로 체크아웃하며, 이슈/PR/빌드를 조회 및 편집하고, 제공된 스킬 파일을 통해 AI 에이전트가 이 모든 작업을 수행하도록 지원하여 개발 워크플로우를 간소화합니다.

기능

• OneDev 엔티티 조회 및 편집 — 이슈, 풀 리퀘스트, 빌드를 셸에서 직접 수행합니다.

• 로컬 변경 사항, 브랜치 또는 태그에 대해 CI/CD 작업 실행 — 실시간 로그 스트리밍 지원 (tod build run --local, --branch 또는 --tag).

• 풀 리퀘스트 로컬 체크아웃 (tod pr checkout).

• .onedev-buildspec.yml 확인 및 최신 버전으로 마이그레이션 (tod build check-spec).

• 에이전트 스킬 — skills/ 하위의 스킬 파일들을 통해 Claude Code, Cursor 및 기타 SKILL.md 인식 에이전트가 tod를 통해 OneDev 워크플로우를 수행하도록 학습시킵니다.

• 크로스 플랫폼 지원 (Windows, macOS, Linux).

Related MCP server: AlibabaCloud DevOps MCP Server

설치

tod를 설치하려면 바이너리를 PATH에 추가하세요.

사전 빌드된 바이너리 다운로드

https://code.onedev.io/onedev/tod/~builds?query=%22Job%22+is+%22Release%22

소스에서 빌드

요구 사항: Go 1.22.1 이상.

git clone https://code.onedev.io/onedev/tod.git
cd tod
go build

구성

tod config set을 실행하여 대화형으로 구성 파일을 생성하거나 업데이트하세요:

tod config set
# OneDev server URL (e.g. https://onedev.example.com): ...
# OneDev personal access token (input is visible): ...

또는 비대화형 설정을 위해 모든 항목을 플래그로 전달하세요:

tod config set \
  --server-url https://onedev.example.com \
  --access-token your-personal-access-token \
  --non-interactive

tod config get은 활성 구성을 출력하며(토큰은 가려짐), tod config get <속성 이름>은 단일 속성을 출력하고, tod config set <속성 이름> <속성 값>은 속성 하나를 업데이트합니다. 속성 이름은 server-url 및 access-token입니다. tod config path는 사용 중인 경로를 출력합니다.

구성 파일은 다음 위치에서 검색됩니다(먼저 일치하는 항목 사용):

1. $XDG_CONFIG_HOME/tod/config

2. ~/.config/tod/config

3. ~/.todconfig (레거시 대체)

INI 형식을 사용하며 0600 모드로 작성됩니다:

server-url=https://onedev.example.com
access-token=your-personal-access-token

빠른 시작

# Run CI against your uncommitted changes
cd /path/to/onedev-git-repository
tod build run --local ci

# Run ci job against the main branch
tod build run --branch main ci

# Check out pull request PROJ-123 into the current working directory
tod pr checkout PROJ-123

# Query open issues assigned to you
tod issue list --query 'assignee is me and state is "Open"'

# Inspect the most recent failing build for a project
tod build list --query 'successful is false' --count 1
tod build get <ref>
tod build get-log <ref>

전체 명령 참조는 cli.md를 확인하세요.

에이전트 스킬

TOD는 skills/ 하위에 4개의 도구 독립적인 SKILL.md 파일을 제공하며, AI 에이전트가 CLI를 통해 일반적인 OneDev 워크플로우를 수행하는 방법을 학습시킵니다:

• using-tod — tod를 통한 모든 OneDev 상호작용을 위한 통합 가이드

• edit-build-spec — .onedev-buildspec.yml 생성 또는 편집

• investigate-build-problems — 실패한 빌드 디버깅

• review-pull-request — 구조화된 풀 리퀘스트 검토 수행

Claude Code, Cursor 또는 SKILL.md 파일을 읽는 다른 에이전트에 이를 설치하는 방법은 skills.md를 참조하세요.

로컬 CI 실행 시 참고 사항

Nginx 구성

OneDev가 Nginx 뒤에서 실행 중인 경우, 로그 스트리밍을 위해 HTTP 버퍼링을 비활성화하세요:

location /~api/streaming {
    proxy_pass http://localhost:6610/~api/streaming;
    proxy_buffering off;
}

자세한 내용은 OneDev Nginx 설정 문서를 참조하세요.

보안 고려 사항

작업이 작업 비밀(job secrets)에 액세스하는 경우, 모든 작업이 허용되도록 권한 부여 필드가 비어 있는지 확인하세요. 모든 브랜치를 허용하도록 권한을 설정하는 것만으로는 충분하지 않습니다. 로컬 변경 사항은 어떤 브랜치에도 속하지 않는 임시 참조(temporal ref)로 푸시되기 때문입니다.

성능 팁

1. 대규모 저장소 — 전체 기록 대신 체크아웃 단계에서 적절한 클론 깊이(clone depth)를 사용하세요.

2. 외부 종속성 — 다운로드 및 중간 파일을 위해 캐싱을 사용하세요.

3. 빌드 최적화 — 생성 속도가 느린 중간 파일을 캐시하세요.

기여

TOD는 OneDev 생태계의 일부입니다. 기여, 이슈 및 기능 요청은 OneDev 프로젝트를 방문하세요.

라이선스

license.txt를 참조하세요.