dotz

내 맥에서 항상 켜져 있는 개인 비서.

게이트웨이가 백그라운드에서 OmO 오케스트레이터를 돌립니다. 터미널을 열어 둘 필요 없이 Discord나 tailnet 웹 앱에서 말을 걸면, 프로젝트 세션이 일하고 결과를 가져옵니다.

설치 명령

curl -fsSL https://raw.githubusercontent.com/ddotz/dotz/main/install.sh | sh

데모는 실제 웹 앱을 만들어 낸 데이터로 띄운 것이고, 설치하지 않아도 되며 실제 서버에 연결하지 않습니다.

무엇을 해 주나

게이트웨이는 내 기기에서 계속 돌고, 대화와 작업은 그 위에서 이뤄집니다.

항상 켜져 있음

dev.dotz.gateway가 게이트웨이를 백그라운드에서 띄웁니다. macOS는 launchd, Linux는 systemd 사용자 서비스를 쓰고, 데스크톱 앱이나 열어 둔 터미널이 필요 없습니다.
프로젝트마다 한 세션

프로젝트 폴더마다 세션과 Discord 채널이 하나씩 생깁니다. 진행 상황은 그 채널로 올라오고, 끝난 결과는 다시 넘겨받습니다.
나가기 전에 묻습니다

메시지, 메일, 댓글, 배포처럼 기기 밖으로 나가는 일은 승인 카드에서 멈춥니다. 소유자가 승인해야 실행됩니다.
지켜보는 일

메일과 캘린더(zele), YouTube·Instagram·웹사이트 댓글, 로그인 유지, 예약 알림을 게이트웨이가 확인합니다. 바뀐 것이 없으면 모델을 부르지 않습니다.
내 계정과 파일에서

소유자의 계정, 파일, 로그인 위에서 동작합니다. 비밀은 ~/.dotz/secrets에 0600으로 두고, 설정과 기억, 규칙은 ~/.dotz에 남깁니다.
명령 하나로 설치

install.sh가 bun, OmO, dotz를 설치하고 마법사를 엽니다. 이후 업데이트는 이 저장소에서 직접 받아 갑니다.

Discord나 웹 앱의 대화가 게이트웨이를 거쳐 프로젝트 세션으로 가고, 진행과 승인이 다시 대화로 돌아옵니다.

입력

Discord 봇 tailnet 웹 앱

대화

게이트웨이

dev.dotz.gateway headless OmO 오케스트레이터 · 모니터링

작업 배분

세션

site/세션 · 채널 api/세션 · 채널 notes/세션 · 채널

진행 · 결과

보고 · 승인

채널에 진행 보고 승인 카드

프로젝트 폴더 하나에 세션과 채널이 하나씩 붙습니다. 기기 밖으로 나가는 일은 마지막 단계에서 승인을 기다립니다.

설치 스크립트가 bun과 OmO를 준비하고, 마법사가 봇과 접속을 설정합니다. 두 명령 중 하나로 시작합니다.

01
설치

첫 번째 명령은 설치와 마법사까지, 두 번째는 게이트웨이 서비스를 함께 시작합니다.
설치와 마법사
```
curl -fsSL https://raw.githubusercontent.com/ddotz/dotz/main/install.sh | sh
```
게이트웨이 서비스까지 시작
```
curl -fsSL https://raw.githubusercontent.com/ddotz/dotz/main/install.sh | sh -s -- --service
```
마법사

봇 이름과 말투, Discord 봇 토큰(MESSAGE CONTENT intent를 켜야 합니다), Tailscale 사용 여부를 묻습니다. macOS에서는 필요한 권한도 이때 정리합니다.
열기

Tailscale을 켰다면 마법사가 인쇄한 웹 앱 주소를 폰에서 엽니다. Discord에서는 안내된 초대 링크로 봇을 서버에 들이고 말을 걸면 됩니다.

설정, 비밀, 기억, 규칙은 ~/.dotz에 두고, 코드 폴더에는 개인 설정을 남기지 않습니다.

업데이트는 이 저장소에서 직접 오고, 코드 폴더는 교체되지만 ~/.dotz의 답과 기록은 그대로 남습니다.

그래서 포크 없이 설치하는 것이 기본 경로입니다.

dotz 자체의 코드를 고치려는 경우에만 포크해 설치하면 됩니다.