Happen

Claude Code와 OpenCode를 위한

일은 에이전트가, 결정은 내가.

Happen은 나와 Claude Code Chief of Staff 사이의 Slack입니다. 진행 상황과 질문, 보고가 채널에 올라오면 휴대폰이나 Mac에서 바로 답하세요.

brew install tab0inc/tap/happen
릴리스 노트 →

macOS · Homebrew · 내 Mac에서 실행

휴대폰의 Happen 스레드: Chief of Staff의 진행 상황과 선택지 두 개가 있는 질문

작동 방식

에이전트가 물으면, 휴대폰에서 답하세요.

결정이 필요할 때 알림이 옵니다. 선택지를 누르면 작업이 이어집니다.

  1. 1

    요청하기

    채널에 요청을 올리거나 Chief of Staff의 터미널에서 말하세요. 어느 쪽이든 스레드는 내가 쓴 말 그대로 시작합니다.

  2. 2

    Chief of Staff가 맡기기

    Chief of Staff는 일을 자기 작업자 팀에 맡기고, 스레드에 진행 상황과 실시간 상태 줄을 올립니다.

  3. 3

    필요할 때만 묻기

    내가 정할 일이 생기면 Chief of Staff가 선택지를 붙여 묻습니다. 스레드가 「내 차례」로 올라오고 알림이 옵니다.

  4. 4

    답하면 이어서 진행

    휴대폰이나 Mac에서 선택지를 누르거나 직접 답을 쓰세요. Chief of Staff가 happen wait로 받아 바로 이어 갑니다.

Mac에서 채널과 스레드를 연 화면: Chief of Staff의 진행 상황과 선택지 두 개가 있는 질문 카드

기능

터미널 앞을 지키지 않아도 흐름은 놓치지 않게.

요청마다 스레드와 실시간 상태가 붙고, 내 차례인 일부터 보여 줍니다.

  • 내 차례인 일부터

    홈과 활동은 모든 채널의 스레드를 모아, 답을 기다리는 질문을 맨 위에, 그 아래 검토·실패·진행 중인 일을 보여 줍니다.

  • 카드에서 바로 답하기

    질문에는 선택지와 직접 답하는 칸이 함께 옵니다. 스레드를 열지 않고 카드에서 바로 답할 수 있어요.

  • 실시간 상태 줄

    스레드마다 지금 어디까지 왔는지 보입니다. 답 필요, 검토 필요, 진행 중, 다른 작업 대기, 완료, 실패.

  • 휴대폰과 Mac으로 알림

    알림을 켜고 iPhone 홈 화면에 추가하거나 Chrome 앱으로 설치하면, 다른 앱처럼 열립니다.

  • 내 Mac 안에서만

    서버는 127.0.0.1에서만 열리고 모든 내용을 내 Mac의 SQLite에 둡니다. 휴대폰에서는 Tailscale Serve로 내 tailnet을 거쳐 접속합니다.

  • 1회용 코드, 키보드 우선

    새 기기는 1회용 QR 코드를 찍어 연결합니다. Mac에서는 Slack과 같은 단축키로 움직이고, 한국어와 영어를 지원합니다.

휴대폰의 활동 화면: 답을 기다리는 질문, 그 아래 검토·실패·진행 중인 스레드

설치

Mac에서 명령 네 줄이면 됩니다.

서명·공증된 실행 파일을 Homebrew로 설치합니다. 소스 checkout이나 Bun은 필요 없습니다.

  1. happen 설치brew install tab0inc/tap/happen
  2. 처음 한 번, 이 Mac 준비happen setup
  3. 서버 실행, 로그인할 때마다 다시 실행brew services start happen
  4. 이 Mac의 브라우저 연결happen open

그다음 Chief of Staff 시작하기

Claude Code에 이렇게 말하면 Chief of Staff로 채널을 맡기 시작합니다.

happen skill --channel <채널> 실행하고 그대로 따라 해

필요한 것

  • Apple silicon 또는 Intel Mac과 Homebrew
  • Chief of Staff로 쓸 Claude Code 또는 OpenCode(v2)
  • 휴대폰에서 답하려면 Tailscale(선택)
릴리스 노트와 체크섬 →

자주 묻는 질문

궁금한 점

데이터는 어디에 저장되나요?

내 Mac에 저장됩니다. 채널과 스레드는 ~/Library/Application Support/happen의 SQLite에 있고, 서버는 127.0.0.1에서만 열립니다.

계정이 필요한가요?

아니요. Happen 계정이나 클라우드 서비스는 없습니다. 브라우저는 1회용 코드로 연결합니다. Mac에서 happen open을 실행하거나, 이미 연결된 기기의 QR 코드를 찍으면 됩니다.

휴대폰에서는 어떻게 쓰나요?

Tailscale Serve로 내 tailnet 안에서 Happen을 HTTPS로 열고, 휴대폰에서 그 주소를 연 뒤 QR 코드로 연결해 홈 화면에 추가하세요. Happen은 인터넷에 직접 열리지 않습니다.

Happen이 에이전트를 실행하나요?

아니요. Chief of Staff는 내 Claude Code 또는 OpenCode 세션이고, 일은 그 세션이 자기 작업자들에게 맡깁니다. Happen은 Chief of Staff가 나와 이야기하는 곳입니다.

업데이트와 삭제는 어떻게 하나요?

happen upgrade가 brew upgrade를 실행하고, 서버도 새 버전으로 다시 뜹니다. 지우려면 brew services stop happen && brew uninstall happen을 실행하세요. 설정과 데이터는 남습니다.