목록으로 돌아가기

블로그

Tactic Remote 1.14 설계 상세: 기능 게이트, 비대화형 Git 실행, 부분 실패 복구

1.13 호스트에서 읽기 전용을 유지하는 이유, 기존 SSH 키 설정을 덮어쓰지 않고 프롬프트 멈춤을 막는 법, Commit & Push의 두 단계 복구 모델을 살펴봅니다.

게시일 태그: 출시 소식 / 1.14 / Git / architecture / Portal
Tactic Remote 1.14 안전 장치 다이어그램: git_write_v1 기능 게이트, 저장소 단위 뮤텍스 큐, 부분 실패 시 커밋·푸시 분리 복구.

터미널에서 직접 git을 다룰 때는 암호 프롬프트나 SSH 지문 확인이 떠도 키보드로 바로 답할 수 있습니다. 하지만 모바일과 웹 환경에서는 호스트의 백그라운드 Git 프로세스가 표준 입력을 기다리며 멈추면 전체 세션이 응답 불가 상태에 빠집니다.

이 글은 Tactic Remote 1.14 출시 안내의 엔지니어링 해설입니다. 실제 사용법은 모바일 Git 워크플로 가이드를 참고하세요.

1. protocolVersion 변경 없는 git_write_v1 기능 협상

모바일 앱과 각 OS의 컴퓨터 동반 앱은 업데이트 시점이 다를 수 있습니다. 1.14는 프로토콜 버전 2를 유지한 채 실행 가능한 git이 확인된 호스트만 git_write_v1 기능을 알립니다. 1.13.x 호스트에 연결하면 1.14 클라이언트는 쓰기 제어 UI를 숨기고 기존 읽기 전용 리뷰를 그대로 제공합니다.

1.13.1 구형 호스트와 연결 시 읽기 전용 리뷰를 유지하는 iOS 1.14 화면.

2026년 11월 16일 시뮬레이터 검증 캡처: 1.13.1 호스트에서는 쓰기 버튼을 숨겨 오작동을 방지합니다.

2. 비대화형 가드, 사용자 SSH 설정 보존 및 저장소 잠금

호스트 Git 서비스는 모든 하위 git 프로세스에 GIT_TERMINAL_PROMPT=0, 비대화형 GCM_INTERACTIVE, GIT_EDITOR=true, LC_MESSAGES=C를 설정합니다. 네트워크 작업은 기존 GIT_SSH_COMMAND, GIT_SSH, core.sshCommand를 우선 보존하고, 모두 비어 있을 때만 ssh -o BatchMode=yes -o StrictHostKeyChecking=accept-new를 적용합니다.

쓰기 RPC는 저장소 루트별 뮤텍스로 순차 실행되며 작업 공간 기본 경로와 민감 경로 인증을 거칩니다. 외부 작업으로 .git/index.lock이 걸려 있으면 Diff 상세 화면 상단에도 즉시 닫을 수 있는 오류 배너가 뜹니다.

.git/index.lock 충돌로 스테이징이 실패했을 때 Diff 상세 상단에 뜬 오류 배너.

시뮬레이터 검증 캡처: 상세 뷰 안에서도 잠금 오류를 바로 확인할 수 있습니다.

3. 5,000건 제한 리뷰 목록과 쓰기 전 전체 인덱스 검증

미리 제외하지 않은 node_modules 등이 있을 때 화면이 멈추지 않도록 git_review는 5,000개를 넘으면 큰 미추적 디렉터리를 한 줄로 접고 필요 시 too_many_changes 플래그와 함께 5,000개까지만 반환합니다. 반면 실제 쓰기 검증에서는 잘리지 않은 전체 상태(최대 16 MiB)를 확인해 안전성을 지킵니다.

4. "Commit & Push"를 두 상태로 분리한 이유

로컬 커밋(6f227e5)이 완료된 뒤 네트워크나 권한 문제로 푸시만 실패했을 때 메시지 초안이 남아 있으면 사용자가 재시도하면서 빈/중복 커밋을 만들 수 있습니다. 1.14는 생성된 커밋 해시와 푸시 오류를 안내하고 ↑1 배지를 띄운 채 입력창 초안을 지워 단독 Push 재시도만 유도합니다.

로컬 커밋 6f227e5 성공 후 푸시 실패 시 해시 안내와 초안 초기화 화면.

시뮬레이터 검증 캡처: 생성된 해시 표기와 초안 정리로 중복 커밋을 방지합니다.

5. 브랜치 및 영구 삭제 안전 가드

upstream 미설정 Pull 안내, 충돌하는 로컬 변경이 있을 때의 브랜치 전환 차단, detached HEAD에서 Push 비활성화, 그리고 추적되지 않은 파일 삭제 시 디스크 영구 삭제 경고 창을 적용했습니다.

충돌하는 로컬 수정으로 인해 브랜치 전환이 차단되고 커밋 또는 stash를 안내하는 배너.
시뮬레이터 검증 캡처: 미커밋 변경 보호 가드 동작.
추적되지 않은 파일 notes/todo.md 삭제 시 영구 삭제를 알리는 확인 모달.
시뮬레이터 검증 캡처: 디스크에서 완전히 지워짐을 명확히 안내합니다.

6. 기본 Portal 활성화와 적용 범위

Tactic Relay 호스트는 1.14.0부터 비공개 Portal 탐색을 기본으로 켜지만, 외부 공유 링크는 여전히 지원 지역과 콘텐츠 검토 동의 절차를 별도로 밟아야 합니다. 대화형 rebase나 복잡한 3방향 병합 충돌 편집은 Review 툴바 대신 에이전트 대화나 네이티브 터미널에서 처리하도록 설계했습니다.

Tactic Remote 사용해 보기

휴대전화로 코딩 에이전트를 원격 제어하세요

Mac, Windows, Linux 컴퓨터의 Claude Code, Codex 등에 연결하세요. iPhone이나 iPad에서 진행 상황을 확인하고 다음 요청을 보낼 수 있습니다.