Repolode
제출하기
huiliyi37

huiliyi37/Tianshu-harness

목표, 근거, 검증 정보를 채팅 기록과 분리해 관리하는 터미널·데스크톱 코딩 에이전트 런타임으로, CVM이라는 인지 실행 계층을 중심으로 구성됩니다.

대체할 수 있는 제품:Claude Code

GitHub에서 보기웹사이트
스타
1,145
포크
86
열린 이슈
19
마지막 커밋
13시간 전

어떤 프로젝트인가요?

Tianshu Harness는 터미널 TUI, 데스크톱 앱, VS Code 확장 프로그램이 하나의 코어를 공유하는 TypeScript 코딩 에이전트 런타임입니다. 모델과 프로젝트 사이에 CVM(Cognitive Virtual Machine)이라는 계층을 두어 작업 목표, 상태, 근거, 권한, 중단 조건을 대화 기록에만 의존하지 않고 런타임에서 추적합니다.

주요 워크플로는 작업별 계약과 deliver_task라는 전달 게이트를 중심으로 구성됩니다. 테스트 결과, diff 또는 검증 명령이 근거로 제시되어야 작업이 완료된 것으로 처리되며, 그렇지 않으면 전달이 차단됩니다. 런타임 훅은 각 턴의 다섯 단계에서 실행되어 루프, 유휴 상태의 도구 호출, 편집 실패를 감지하며, 상태 대시보드(/cockpit)에서 검증, 비용, 캐시 지표를 확인할 수 있습니다.

이 프로젝트는 기본 모델 제공자 프리셋 25개와 OpenAI 호환 엔드포인트를 지원하며, 하위 에이전트 명령, prefix 캐싱 엔진, plan mode, MCP 및 skills 지원, 샌드박스 쓰기와 경로 순회 방지 기능을 갖춘 권한 시스템도 포함합니다.

핵심 기능

  • 01작업별 계약에 목표, 범위, 성공 기준을 채팅 기록과 분리해 기록합니다.
  • 02테스트, diff, 검증 근거를 바탕으로 작업 상태를 GREEN, YELLOW 또는 RED로 표시하는 전달 게이트를 제공합니다.
  • 03각 턴에서 런타임 훅을 실행해 수렴 문제, 유휴 루프, 편집 실패를 감지합니다.
  • 04모델 제공자 프리셋 25개와 OpenAI 호환 엔드포인트를 기본 지원합니다.
  • 05터미널 TUI, 데스크톱 앱, VS Code 확장 프로그램이 하나의 에이전트 코어를 공유합니다.
  • 06권한 모드, 샌드박스 쓰기, 민감한 파일 및 파괴적인 명령에 대한 보호 기능을 제공합니다.

활용 사례

  • 저장소에서 여러 단계로 이루어진 코딩 작업을 실행하고, 결과를 승인하기 전에 테스트 근거를 요구하는 경우.
  • 터미널 기반 코딩 워크플로에서 DeepSeek 또는 다른 OpenAI 호환 모델을 사용하는 경우.
  • NDJSON 이벤트 출력을 사용해 스크립트나 CI에서 에이전트를 헤드리스로 실행하는 경우.
  • 장시간 코딩 세션에서 토큰 비용과 prefix 캐시 적중률을 추적하는 경우.

빠른 시작

  1. 1

    npm을 사용해 터미널 CLI를 전역 설치합니다(Node.js 24 이상).

    npm install -g tianshu-harness
  2. 2

    tianshu CLI를 시작하고 프롬프트가 나타날 때까지 기다립니다. 처음 실행하면 /connect 설정 마법사가 열립니다.

    tianshu

사용 전 알아둘 점

  • macOS 데스크톱 앱은 공증되지 않았으므로 처음 실행할 때 xattr 우회 방법이 필요할 수 있습니다.
  • Linux 데스크톱 빌드에는 glibc 2.35 이상과 WebKit2GTK가 필요하며, Wayland에서의 동작은 검증되지 않았습니다.
  • 캐시 절감 수치는 5개 작업으로 진행한 소규모 파일럿의 DeepSeek 세션에서만 산출되었습니다.

포함된 컬렉션

오픈소스 AI 에이전트 프레임워크와 앱AI 코딩 어시스턴트와 에이전트CLI·터미널 도구데스크톱 GUI 앱 & 툴킷

토픽

#coding-agent#agent-harness#ai-agent#cli#typescript#context-management#deepseek#gui#harness#harness-engineering

자주 묻는 질문

Tianshu-harness은(는) 무엇인가요?
목표, 근거, 검증 정보를 채팅 기록과 분리해 관리하는 터미널·데스크톱 코딩 에이전트 런타임으로, CVM이라는 인지 실행 계층을 중심으로 구성됩니다. Tianshu Harness는 터미널 TUI, 데스크톱 앱, VS Code 확장 프로그램이 하나의 코어를 공유하는 TypeScript 코딩 에이전트 런타임입니다. 모델과 프로젝트 사이에 CVM(Cognitive Virtual Machine)이라는 계층을 두어 작업 목표, 상태, 근거, 권한, 중단 조건을 대화 기록에만 의존하지 않고 런타임에서 추적합니다.
Tianshu-harness은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
Tianshu-harness은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
Tianshu-harness은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. Tianshu-harness의 마지막 커밋은 2026년 10월 22일입니다.
Tianshu-harness은(는) 어디에 사용할 수 있나요?
저장소에서 여러 단계로 이루어진 코딩 작업을 실행하고, 결과를 승인하기 전에 테스트 근거를 요구하는 경우. 터미널 기반 코딩 워크플로에서 DeepSeek 또는 다른 OpenAI 호환 모델을 사용하는 경우. NDJSON 이벤트 출력을 사용해 스크립트나 CI에서 에이전트를 헤드리스로 실행하는 경우. 장시간 코딩 세션에서 토큰 비용과 prefix 캐시 적중률을 추적하는 경우.
Tianshu-harness는 어떻게 설치하나요?
npm을 사용해 터미널 CLI를 전역 설치합니다(Node.js 24 이상).: npm install -g tianshu-harness tianshu CLI를 시작하고 프롬프트가 나타날 때까지 기다립니다. 처음 실행하면 /connect 설정 마법사가 열립니다.: tianshu
Tianshu-harness은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/huiliyi37/Tianshu-harness

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트