deepseek-ai/deepseek-harness

소개

DeepSeek Harness(dsh)는 DeepSeek AI가 공개한 오픈소스 에이전트 하네스다. 문서 정리·표 분석·코드 작성·자료 조사처럼 일상 업무와 개발 작업을 에이전트에게 맡길 수 있게 해 준다.

'모든 것이 플러그인(everything-is-a-plugin)'이라는 구조를 따르며, Cordis라는 프레임워크 위에서 동작한다. 도구·스킬·화면까지 플러그인으로 붙이고 뗄 수 있고, 공식 페이지에 따르면 '창조 모드'에서 대화만으로 새 플러그인을 만들어 설치할 수 있다. 데스크톱 앱으로 쓰거나 명령 한 줄로 로컬 웹 UI를 띄워 쓸 수 있다.

에이전트를 자기 업무 방식에 맞게 바꿔 쓰고 싶은 개발자나, 하네스 구조 자체를 연구·확장하려는 팀이 살펴볼 만하다. 플러그인을 만들어 dsh-plugin 주제로 공유하는 생태계도 열어 두었다.

왜 눈여겨볼까

에이전트 루프·서브에이전트·터미널 같은 핵심 기능까지 플러그인 단위로 나눈 설계라서, 기능을 덧붙이는 데서 그치지 않고 하네스 자체를 다시 짜 맞출 수 있다. 모델 개발사가 자기 하네스를 오픈소스로 공개했고, 바탕 프레임워크인 Cordis의 설계도 논문으로 나와 있어 하네스 설계를 비교·연구하는 사람에게 참고가 된다.

주요 기능

• 도구·스킬·인터페이스를 플러그인으로 설치하거나 직접 만들어 에이전트 기능을 넓힐 수 있다.
• 공식 페이지에 따르면 대화로 플러그인을 만들고 설치까지 하는 '창조 모드'를 제공한다.
• 매주 정해진 시각에 주간 보고서를 만드는 식으로 자동화 작업을 예약할 수 있다.
• 개발자 도구에서 실행 Trajectory와 도구 호출 내역을 보며 문제를 추적할 수 있다.
• 데스크톱 앱과 로컬 웹 UI 두 가지 방식으로 실행할 수 있다.

이런 데 씁니다

• 문서 정리, 표 분석, 보고 자료 작성 같은 반복 업무를 에이전트에게 맡길 때 쓴다.
• 프로젝트 코드를 이해하고 버그를 고치고 테스트를 돌리는 개발 작업에 쓴다.
• 팀에 맞는 도구와 화면을 플러그인으로 만들어 자체 에이전트 환경을 꾸릴 때 쓴다.
• 스크립트 실행이나 대량 파일 처리처럼 오래 걸리는 작업을 백그라운드로 돌릴 때 쓴다.

시작하기

1. Node.js를 설치한다.
2. npx @deepseek-ai/dsh web 을 실행하면 기본값으로 http://127.0.0.1:3080 에서 웹 UI가 열린다(브라우저 자동 열기를 끄려면 --no-open).
3. 소스로 실행하려면 git clone https://github.com/deepseek-ai/deepseek-harness.git 후 저장소 폴더에서 pnpm install, pnpm run build, pnpm dsh web 을 차례로 실행한다.
4. 실행 전에 저장소의 SAFETY.md 안전 안내를 읽는다.

고를 때 따질 점

• 개발자 프리뷰 단계이고 README가 호환성을 깨는 변경이 있을 것이라고 밝히고 있어 API와 설정이 바뀔 수 있다.
• 2026년 8월에 만들어진 프로젝트라 플러그인 생태계와 문서가 아직 자리 잡는 중이다.
• 에이전트가 셸 명령 실행과 파일 수정을 할 수 있으므로 SAFETY.md를 확인하고 작업 공간 권한을 따져 봐야 한다.
• MIT 라이선스지만 서드파티 의존성 라이선스는 THIRD_PARTY_NOTICES.md에서 따로 확인해야 한다.

관련 용어·기업

하네스 Harness² AI 에이전트 서브에이전트 스킬 코딩 에이전트 DeepSeek

출처

• deepseek-ai/deepseek-harness README
• DeepSeek Harness｜共探智能上限

저장소 README와 GitHub 정보를 근거로 AI를 활용해 정리했습니다. 별 수 등 숫자는 기준일의 GitHub 값이며, 기능·라이선스는 바뀔 수 있으니 저장소에서 확인하세요.