cheo0y / shisa-agent

# 시사 비서 (shisa-agent)
화면 구석에 사는 작은 비서입니다. 캐릭터가 할 일이나 일정, 브리핑을 말풍선으로 알려 주고, 캐릭터를 누르면 할 일과 대화를 모아 둔 패널이 열립니다. 캐릭터는 기본 여덟 중에서 고르거나 직접 만들 수 있습니다.
데이터는 전부 내 컴퓨터(`~/.cy-agent/`)에만 저장됩니다. 따로 서버로 올라가는 건 없습니다.
macOS와 윈도우에서 쓸 수 있습니다. 윈도우 설치는 windows/README.md를 봐 주세요.
v0.3.2: 패널에 캘린더 탭(주·월 보기, 캘린더마다 색·켜고 끄기)이 생기고, AI가 다음 주 같은 먼 일정도 직접 찾아 답합니다. 날씨 알리미(출근 후·퇴근 20분 전), 「오늘 꼭」이 곧 오늘 할 일, 말로 집중 시작하기, 프로젝트 안 할 일 이름·순서 바꾸기가 들어갔습니다.
v0.3.2 파일은 2026년 10월 19일 21시 34분(한국 시간)에 다시 올렸습니다. 이번에는 네이버 캘린더를 연결할 수 있게 했습니다. 「더 연결할까요?」에서 네이버 아이디와 애플리케이션 비밀번호를 넣으면 네이버 일정을 읽어 오고, 가져올 캘린더는 체크로 고릅니다(읽기만 합니다). 타임트리는 바깥으로 일정을 내보내는 기능이 없어 연결할 수 없다는 안내도 넣었습니다. 할 일 줄 왼쪽의 ⋮⋮ 손잡이를 끌어 순서를 바꿀 수 있고, 다른 우선순위 묶음에 놓으면 우선순위도 바뀝니다. 한글이 들어간 폴더의 레포를 수정 작업 대상으로 못 찾던 것도 고쳤습니다. 13시 05분에 올린 파일부터는 카니가 공부할 때 회색 네모 안에 갇혀 보이던 것을 투명 배경으로 고쳤고, 직접 만든 캐릭터를 고치기 화면에서 한마디·테두리를 바꾸면 쓰던 칸이 날아가던 것을 고쳤습니다. 10월 18일 23시 25분에 올린 파일부터는 언어 설정에 일본어가 들어갔습니다. 설정 창의 「이 앱」에서 日本語를 고르면 캐릭터 대사와 AI 답, 설정·패널·메뉴 글이 모두 일본어로 바뀝니다. 패널 화면도 손봤습니다. 프로젝트 카드는 「＋ 할 일」과 ⋯ 메뉴로 정리하고 같은 줄 카드 높이를 맞췄고, 모델 탭의 채팅 모델 고르기는 설정 창 「세부 모델」로 모았습니다. 우사기의 응원·춤 같은 영상도 서 있는 그림과 같은 크기로 맞췄고, 윈도우에서 앱을 끌 때 깔끔하게 끝나도록 고쳤습니다. 그 전에 v0.3.2 를 받으셨다면 dmg 를 다시 받아 덮어써 주세요.
v0.3.1: 메일을 연결할 수 있습니다. Gmail·네이버·다음 메일을 앱 비밀번호로 연결하면 답장이나 할 일이 필요한 메일을 골라 줍니다. 여러 계정을 넣을 수 있고, 메일은 읽기만 합니다. 채팅에서 모델을 고를 수도 있습니다.
v0.3.1 파일은 2026년 10월 18일 13시 15분(한국 시간)에 다시 올렸습니다. 업데이트 알림을 ✕ 로 닫을 수 있게 했고, 말풍선이 시간이 지나도 안 사라지던 것과 카니가 깜빡일 때 색과 몸 위치가 바뀌던 것을 고쳤습니다. 캐릭터를 다시 두 번 누르면 질문 칩이 닫힙니다. 그 전에 v0.3.1 을 받으셨다면 dmg 를 다시 받아 덮어써 주세요.
v0.3.0에서 바뀐 것:
- 카니·치이카와·쿠리만쥬가 들어와 기본 캐릭터가 여덟이 되었습니다. 캐릭터를 직접 만들 수도 있습니다(캐릭터).
- 한 동작에 영상을 여러 개 두고 그때마다 하나를 랜덤으로 틉니다. 영상마다 하는 말도 다릅니다.
- 근무 시간을 정하면 출근·점심·퇴근 10분 전에 캐릭터가 인사합니다(근무 시간).
- 프로젝트 탭에서 프로젝트를 직접 만들거나 캘린더 일정에서 가져와 할 일을 묶습니다(프로젝트).
써 보시고 불편한 점이 있으면 의견 보내기로 알려 주세요.
## 하는 일
- 캐릭터: 한 번 누르면 패널이 열리고, 두 번 누르면 그 자리에서 말을 걸 수 있습니다. AI를 연결하지 않았다면 두 번 눌렀을 때 「지금 할 일 뭐 있어요?」, 「응원해 줘」 같은 질문 칩이 뜨고, 고르면 바로 답합니다. 오른쪽 클릭으로 메뉴를 열고, 끌어서 아무 데나 옮겨 둘 수 있습니다.
- 할 일 정리: 연결해 둔 Slack·캘린더·메일·이슈와 내 Claude Code·Codex 작업 기록을 읽어서 챙길 일을 「오늘 꼭·이번 주·천천히·언젠가」로 나눠 모읍니다. 줄을 두 번 누르면 제목과 설명을 고칠 수 있고, ▶를 누르면 「(진행중)」이 붙습니다. 지운 할 일은 휴지통에 30일 동안 남습니다. "앞으로 세미나는 언젠가로"처럼 말해 두면 규칙으로 기억합니다.
- 오늘 할 일: 우선순위가 「오늘 꼭」인 할 일이 곧 오늘 할 일입니다. 할 일 탭에서 「오늘 꼭」으로 바꾸거나 줄의 「오늘」을 누르면 오늘 할 일 탭에 바로 보이고, 오늘 할 일 탭에서 「오늘」을 다시 누르면 「이번 주」로 내려갑니다. 오늘 할 일 탭에서 적은 일은 「오늘 꼭」으로 들어갑니다. 아침마다 적어 달라고 알려 주고(설정에서 N시간마다·정한 시각·끄기), 어제 못 끝낸 일이 남아 있으면 「어제 남은 N개, 오늘도 할까요?」라고 물어 그대로 둘지 이번 주로 내릴지 고르게 합니다. 절반이나 전부 끝내면 응원합니다.
- 프로젝트: 할 일을 프로젝트로 묶습니다. 직접 만들거나 캘린더 일정에서 가져올 수 있습니다. 아래 프로젝트에 자세히 적었습니다.
- 캘린더: 캘린더 탭에서 연결한 캘린더 일정을 주·월·일 보기로 봅니다. 캘린더마다 색이 다르고, 위쪽 칩으로 캘린더를 보이거나 숨기고 색을 바꿀 수 있습니다. 일정을 누르면 회의 링크를 열거나 프로젝트·할 일로 만들 수 있고, 개요의 연결 카드에서 캘린더마다 켜고 끌 수 있습니다. AI에게 다음 주나 이번 달, 특정 날짜의 일정을 물어도 연결한 캘린더에서 그 기간을 읽어 답합니다.
- 진행 중 표시: ▶로 진행 중인 일은 캐릭터 머리 위에 「진행 중 · 할 일 제목」으로 떠 있습니다. 여러 개면 「제목 외 n개」로 보이고, 말풍선을 누르면 할 일 탭이 열립니다.
- 집중하기: 할 일 탭이나 오늘 할 일 탭에서 「▶ 집중하기」를 누르면 캐릭터도 공부를 시작하고, 머리 위 말풍선에 집중한 시간이 흘러갑니다. 쉰 시간은 빼고 셉니다. 목록 맨 아래 「오늘 집중」에서 주·월 기록을 GitHub 잔디처럼 봅니다. 캐릭터에게 「25분 집중할게」, 「보고