TL;DR

  • Hydra는 터미널 세션과 코딩 에이전트를 로컬에서 다루는 데스크톱으로, PTY 데몬, 세션 보존, 프로젝트·창·패널 관리 기능을 제공하며 로컬 데스크톱만 Apache License 2.0으로 공개함.
  • 프로젝트, 창, 패널, 터미널 기록과 보존된 PTY 세션이 사용자 머신에 저장되며 로컬 우선 구조를 채택함.
  • Claude Code, Codex CLI, GitHub Copilot CLI 등 여러 제공자의 로컬 세션 정보를 읽어 세션 목록 표시와 재개를 지원하지만 대화 기록 내용은 HydraTerms로 전송하지 않음.
  • Hydra Remote의 원격 에이전트, 브라우저 클라이언트, 조정 서비스, 릴레이, 인증·권한·결제 시스템은 별도 비공개 제품으로 저장소에 포함되지 않음.
  • macOS와 Linux용 로컬 빌드는 제공되며, 패키지 설치에는 비공개 원격 구성 요소가 포함될 수 있어 소스 빌드와 공식 패키지의 범위가 다름.

시작하기

  • 자주 묻는 질문에서 tmux, Electron, 보존 정책, 원격 기능, 보안과 Herdr를 다룸.
  • 아키텍처 문서에서 PTY 소유권, 네이티브 렌더링, 대시보드 구성, macOS와 Linux 호스트 분할을 설명함.
  • 문제 해결 문서에서 로컬 데이터 이전, 에이전트 검색, Linux 디스플레이 백엔드를 다룸.
  • 개발 및 기여 문서에서 빌드, 테스트와 기여 계약을 설명함.

설치

  • 공식 macOS 패키지는 brew install --cask hydraterm/hydra/hydraterms 명령으로 설치함.
  • 공식 Linux 패키지는 curl -fsSL https://hydraterms.com/install.sh | sh 명령으로 설치함.
  • 공식 패키지에는 별도의 독점 구성 요소인 Hydra Remote가 포함됨.
  • 이 저장소에서 소스로 빌드한 결과물은 완전한 로컬 데스크톱이며, 비공개 원격 에이전트나 호스팅 서비스 접근 권한은 포함하지 않음.

이 저장소의 구성

  • PTY 데몬과 보존 세션 모델
  • 네이티브 터미널 렌더러
  • 로컬 프로젝트, 창, 패널과 레이아웃
  • 로컬 제공자와 이전 세션 검색
  • 데스크톱 대시보드
  • macOS와 Linux의 로컬 플랫폼 지원
  • 선택적 데스크톱 확장을 요청하는 제한된 API

제공자 상호 운용성

  • Hydra는 제공자가 소유한 로컬 세션 메타데이터를 읽어 다음 도구로 생성한 세션을 목록에 표시하고 재개함.
  • Claude Code
  • Codex CLI
  • GitHub Copilot CLI
  • Antigravity
  • Kimi CLI
  • Kiro CLI
  • OpenCode
  • Cursor Agent
  • Devin CLI
  • 기존 Gemini CLI
  • 이 디스크 형식은 각 제공자에 속하며 변경될 수 있음.
  • 검색은 로컬에서 실행되며 HydraTerms는 대화 기록 내용을 수신하지 않음.
  • Amp와 Factory/Droid는 각 명령줄 인터페이스를 통해 실행하고 재개할 수 있지만, Hydra는 이들의 기록 저장소를 읽지 않음.

오픈 소스와 Hydra Remote

  • 이 저장소에는 Hydra의 로컬 데스크톱이 포함되며, Apache License 2.0에 따라 코드를 확인하고 빌드하고 포크하고 변경 사항을 제안할 수 있음.
  • Hydra Remote는 별도의 호스팅 제품임.
  • Hydra Remote의 데스크톱 에이전트, 브라우저 클라이언트, 조정 서비스, 릴레이, 신원 확인·권한 부여·결제 시스템은 이 저장소에 포함되지 않으며 오픈 소스가 아님.
  • 원격 상대방의 인증과 권한 부여 여부는 이 애플리케이션이 아니라 비공개 에이전트가 결정함.
  • 터미널 세션을 소유하고 사용자 머신에서 실행되는 코드의 검토를 가능하게 하기 위해 로컬 데스크톱을 공개함.
  • 공개 영역과 비공개 영역의 정확한 범위와 위협 모델은 공개·비공개 경계 문서에서 확인함.

빌드

  • DEVELOPMENT.md에 설명된 사전 요구 사항을 설치한 뒤 ./scripts/build-local.sh를 실행해 로컬 빌드를 수행함.
  • cargo run -p maestro-app -- launch 명령은 빠르고 격리된 개발용 실행 도구임.
  • 이 개발용 실행 도구는 개발 전용 상태를 사용하며 설치된 애플리케이션의 구성 방식과는 다름.
  • 패키지와 동일한 실행기, 데몬 보존, 번들형 대시보드 구조로 로컬 데스크톱을 시험하려면 DEVELOPMENT.md의 서명되지 않은 패키징 및 실행 절차를 사용함.
  • 저장소는 일반 기여자용 Rust 도구 모음 버전과 최소 지원 Rust 버전을 별도로 고정함.
  • 도구 모음 버전을 바꾸기 전에 DEVELOPMENT.md를 확인함.

테스트

  • ./scripts/test-local.sh를 실행해 로컬 테스트를 수행함.
  • 저장소에는 macOS와 Linux용 로컬 전용 서명되지 않은 패키징 연기 테스트 스크립트도 포함됨.
  • 해당 스크립트는 비공개 원격 에이전트를 번들에 포함하지 않으며 공식 서명 릴리스를 생성하지 않음.
  • 플랫폼 동작은 macOS에서 실제 장비 테스트가 여전히 필요하며, Linux에서는 네이티브 Wayland와 X11 환경 모두의 테스트가 필요함.
  • 브라우저만 대상으로 한 대시보드 테스트만으로는 네이티브 호스트 동작을 입증할 수 없음.

호환성 이름

  • Hydra는 제품명임.
  • 일부 크레이트, 환경 변수, 스키마와 영속 상태 경로에는 기존 로컬 데이터와 확장 인터페이스의 호환성을 위해 maestro-*, MAESTRO_*, maestro.*, Maestro 이름이 남아 있음.
  • 이 이름은 안정적인 구현 식별자이며 두 번째 제품이나 숨겨진 원격 구성 요소를 의미하지 않음.
  • 해당 이름을 바꾸려면 명시적인 데이터 이전이 필요함.

기여

  • 버그 수정, 문서화, 플랫폼 호환성과 패키징 개선을 환영함.
  • 아키텍처 변경은 구현 전에 승인된 이슈가 필요함.
  • 자세한 내용은 CONTRIBUTING.md와 DEVELOPMENT.md에서 확인함.
  • 모든 기여에는 개발자 원산지 증명서가 적용됨.
  • 각 커밋에 git commit -s로 서명하며, 필수 개발자 원산지 증명서 검사가 모든 풀 리퀘스트를 확인함.
  • HydraTerms는 기여자 라이선스 계약이나 저작권 양도를 요구하지 않음.

보안

  • 취약점을 공개 이슈로 신고하지 않음.
  • SECURITY.md를 따르거나 security@hydraterms.com으로 이메일을 보내 보안 문제를 신고함.

라이선스와 상표

  • Hydra의 로컬 데스크톱은 Apache License 2.0으로 배포됨.
  • 해당 라이선스는 비공개 Hydra Remote 구현이나 호스팅 서비스를 포함하지 않으며, HydraTerms 이름이나 로고에 대한 권리를 부여하지 않음.
  • 자세한 내용은 TRADEMARKS.md에서 확인함.

후원

  • Hydra 개발은 Pairextr Teknoloji ve Yazılım A.Ş.의 자금 지원을 받음.
  • Hydra와 HydraTerms는 HydraTerms Limited의 상표로 유지되며, 후원은 프로젝트나 상표의 소유권을 부여하지 않음.