TL;DR
github.com의 「Show HN: Yorishiro – a macOS terminal where AI agents live」는 AI 에이전트를 터미널 안에 들여놓는 macOS용 실험입니다.
원문은 React 19, TypeScript 5.8, Claude Code, Codex, Homebrew cask, Apple Developer ID, 서명 검증 업데이트를 확인합니다.
실무에서는 로컬 신뢰 코드, API 키 경로, 배포 서명, 되돌리기 절차를 따로 봐야 합니다.
github.com의 「Show HN: Yorishiro – a macOS terminal where AI agents live」는 터미널을 작업창이 아니라 거주 공간으로 바꿉니다. 원문은 에이전트가 화면 안에서 존재감을 갖는 방식을 전면에 둡니다.
Yorishiro는 터미널을 어떻게 동거 공간으로 바꿨나
원문은 에이전트가 생각에 잠기면 시선이 흔들리고, 오류가 나면 얼굴이 바로 반응한다고 설명합니다. 승인이 필요하면 방의 조명이 그 사실을 알려 줍니다. 오래 걸리는 작업에서는 스피너 대신 누군가 서 있는 장면을 보여 줍니다.
이 설계의 핵심은 화면을 고정된 도구가 아니라, 실시간으로 바뀌는 환경으로 본다는 점입니다. 거주자는 조명, 장면, UI를 바꿀 수 있습니다. 사용자도 같은 환경을 직접 조작합니다.
원문은 사용자와 거주자가 하나의 환경을 공유한다고 적습니다.
팩이 맡는 여섯 영역
Yorishiro는 핵심 바깥의 대부분을 팩이라는 단위로 확장합니다. 원문이 밝힌 팩의 역할은 여섯 가지입니다.
- 인격: 거주자의 성격과 반응 패턴을 정의합니다.
- 장면: 배경, 공간, 조명, 주변 소리를 구성합니다.
- 효과: 화면 흔들림이나 불꽃 같은 임시 시각 효과를 맡습니다.
- UI: 설정 화면 같은 화면 요소를 담당합니다.
- 상시 오버레이 UI: 시선 시각화처럼 항상 보이는 덮개를 담당합니다.
- 런타임 설비: 타이머처럼 MCP 도구를 가진 기능 설비를 맡습니다.
이 구조는 기능 추가보다 존재 방식의 조정에 가깝습니다. 즉, Yorishiro는 에이전트를 더 똑똑하게 보이게 하기보다, 곁에 있는 느낌을 설계합니다.
원문이 확인한 설치·런타임·보안 조건
원문은 설치, 실행, 업데이트, 보안 경로를 꽤 명확하게 적어 둡니다. 아래 표는 원문에서 확인된 값만 정리한 것입니다.
| 항목 | 원문 인용 | 무엇을 의미하는가 |
|---|---|---|
| 런타임 | Runtime : React 19 + TypeScript 5.8 (TypeScript is the canonical runtime) |
화면과 실행의 기준이 TypeScript 쪽에 있습니다. |
| 실행 대상 | Yorishiro currently targets macOS. |
현재 대상 운영 체제는 macOS입니다. |
| 사전 조건 | You need Claude Code or Codex already set up on your system |
Claude Code 또는 Codex를 먼저 준비해야 합니다. |
| 자동 실행 | Yorishiro automatically launches Claude Code or Codex installed on your local machine inside its terminal. |
로컬에 설치된 에이전트를 터미널 안에서 자동으로 띄웁니다. |
| API 키 | Yorishiro never asks for, stores, or directly uses API keys. |
API 키를 직접 묻거나 저장하거나 쓰지 않습니다. |
| 설치 | Install with Homebrew: brew install --cask sktkkoo/yorishiro/yorishiro |
Homebrew cask로 설치할 수 있습니다. |
| 서명 | The builds are signed and notarized with an Apple Developer ID |
배포본이 Apple Developer ID로 서명·공증됩니다. |
| 업데이트 | opening Settings checks for a new version, and a single click on "Update and restart" applies a signature-verified update. |
앱 안에서 서명 검증된 업데이트를 적용합니다. |
원문은 직접 내려받는 경로도 함께 제공합니다.
.dmg를 열고 yorishiro.app를 /Applications로 옮기면 됩니다.
brew install --cask sktkkoo/yorishiro/yorishiro
Yorishiro가 기존 에이전트 터미널과 갈리는 지점
대부분의 에이전트 도구는 명령 실행과 응답 생성에 집중합니다. Yorishiro는 그 위에 환경의 감각을 얹습니다. 거주자는 조명과 장면을 바꾸고, 사용자도 같은 환경을 만집니다.
결과적으로 대화 상대가 아니라 같은 방에 있는 존재처럼 보이게 합니다.
또 하나의 차이는 변경의 지속성입니다. 원문은 핵심 바깥의 거의 모든 요소를 팩으로 바꿀 수 있다고 말합니다. 대화만으로 팩을 다시 쓰고 저장할 수도 있습니다.
이 변화는 장면과 UI에만 그치지 않습니다. 인격과 반응까지 바로 바뀝니다. 마음에 들지 않으면 한 번 클릭으로 되돌릴 수 있습니다.
이 점은 일반적인 확장 기능과도 결이 다릅니다. Yorishiro의 팩은 기능을 덧붙이는 장치이면서, 동시에 존재 양식을 바꾸는 장치입니다. 원문이 프로젝트 자체도 거주자와 협업해 만들고 있다고 적은 이유가 여기에 있습니다.
내일 점검할 운영 항목은 무엇인가
이 프로젝트를 읽은 뒤 실무에서 바로 점검할 항목은 분명합니다.
- Claude Code 또는 Codex가 먼저 설정돼 있는지 확인합니다.
- 로컬 에이전트가 인증된 뒤 어떤 외부 API를 쓰는지 경로를 문서화합니다.
- 도구가 API 키를 직접 다루지 않더라도 인증 상태의 책임 주체를 정합니다.
- 사용자 팩은 로컬 신뢰 코드로 취급합니다.
- 사용자 팩을 샌드박스 없이 실행할 때의 위험을 별도로 검토합니다.
- macOS 배포라면 서명, 공증, 앱 안 업데이트 검증을 묶어서 운영합니다.
- 변경 즉시 반영과 되돌리기 경로를 같이 설계합니다.
- 공개 팩 저장소나 앱 내 커뮤니티 설치가 없다는 점을 배포 정책에 반영합니다.
원문은 사용자 팩을 공용 마켓의 앱처럼 다루지 않습니다. 오히려 쉘 스크립트나 편집기 확장처럼 다룹니다. 즉, 믿을 수 있는 출처만 넣어야 합니다.
이 점을 놓치면 멋진 UI보다 더 큰 운영 사고가 납니다.
자주 묻는 질문
Yorishiro는 API 키를 직접 받나요?
아닙니다. 원문은 Yorishiro가 API 키를 묻지 않고, 저장하지 않고, 직접 쓰지도 않는다고 밝힙니다. 대신 이미 인증된 로컬 에이전트를 터미널 안에서 띄웁니다.
Claude Code나 Codex를 먼저 준비해야 하나요?
그렇습니다. 원문은 시스템에 이미 설정돼 있어야 한다고 적습니다. 설치 뒤에 바로 실행되는 구조가 아니라, 준비된 로컬 에이전트를 붙이는 구조입니다.
사용자 팩은 안전한 확장 기능인가요?
아닙니다. 원문은 사용자 팩을 로컬 신뢰 코드라고 부릅니다. 또한 샌드박스 처리도 하지 않는다고 밝힙니다.
요약하면 Yorishiro는 무엇을 보여 주나요?
Yorishiro는 에이전트를 더 강하게 만드는 대신, 함께 머무는 감각을 만들려는 시도입니다. 원문이 보여 주는 핵심은 터미널, 조명, 장면, 팩, 서명 검증이 한 흐름으로 묶인다는 점입니다.
원문: 「Show HN: Yorishiro – a macOS terminal where AI agents live」