원장 (wonjang) — 한국인을 위한 개인 비서 🇰🇷

가계부·디데이·습관·실수령·날씨까지, 한국 사람이 매일 쓰는 걸 다 해주는 똑똑한 명령어 비서. 단일 바이너리(Rust)라 빠르고, API 키도 로그인도 없이 설치하면 바로 쓸 수 있어요.

npm install -g wonjang-agent

설치하면 wonjang 명령이 생깁니다(플랫폼에 맞는 네이티브 바이너리를 자동으로 받아요). 키 설정 없이 지금 바로:

wonjang                       # 대화형 모드 — '자랑', '지출 추가 5만 식비'처럼 입력
wonjang 자랑                   # 한 달의 나를 카톡에 자랑하는 카드
wonjang 기억 "나는 아침형"      # 🌱 원장이 기억해요 — 쓸수록 성장
wonjang 지출 추가 5만 식비       # 가계부
wonjang 연봉 3600              # 실수령액

✨ 한 달의 나를, 카톡 한 장으로 — wonjang 자랑

습관·집중·지출·디데이를 카톡에서도 안 깨지는 카드 한 장으로. 친구한테 자랑하고 싶어져요.

╭──── 원장 카드 · 2026년 6월 ────╮
│ 🔥 가장 긴 연속 운동 15일      │
│ ▓░▓▓░▓▓ ░▓▓▓░░▓ ▓▓▓▓▓▓▓ ▓▓▓▓▓▓▓│
│ 🍅 이번 달 집중 32시간         │
│ 💰 이번 달 지출 240,000원      │
│ 📅 다가오는 날  수능 D-166     │
├────────────────────────────────┤
│ 💬 운동 15일 연속, 잘 쌓고 있어요│
╰─ 나도 만들기 → wonjang-agent ──╯

wonjang 자랑 --복사 하면 클립보드에 복사돼요(카톡·메모에 바로 붙여넣기). 주간 결산은 --주. 다음 연휴 D-day는 wonjang 공휴일 --카드로 — 연차 하나로 길어지면 꿀팁까지 붙어요.

🧠 쓸수록 성장해요 — 기억하는 비서

말만 해도 기억하고("나는 아침형이야"), 다음에 만나도 이어집니다. 틀리면 잊어 달라고 하면 돼요.

wonjang 기억 "나는 아침형 인간"   # 🌱 기억했어요(4개째)
wonjang 잊어 아침형               # 🗑 틀린 기억 지우기
wonjang 성장                      # 함께 N일째·기억·스킬을 카드 한 장으로

AI를 연결하면(이미 로그인된 claude/codex CLI에 자동 연결 — 키 불필요) 자연어 대화에서도 약속·날씨·가계부·기억을 원장 도구로 직접 처리합니다.

🎭 내 원장, 내 성격으로

처음 실행하면 원장의 성격부터 골라요 — 각 원장이 자기 목소리로 인사해요(나중에 wonjang 성격으로 언제든 바꿔요):

   1) 🌙 다정한 비서 — "안녕하세요, 원장입니다 🌙 무엇을 도와드릴까요?"
   2) 😎 편한 친구   — "야, 나 원장이야. 뭐 도와줄까? 😎"
   3) 🎩 정중한 집사 — "주인님, 원장 대령했습니다."
   4) 😏 시크한 선배 — "왔냐. 뭐 필요한데."
   5) ✨ 밝은 에너지 — "안녕하세요!! 원장이에요!! 오늘도 화이팅이에요 ✨"

고른 성격은 대화에 묻어나요 — 대화형에서 명령마다 원장이 자기 얼굴·말투로 응답해요:

당신 ▸ 연봉 3600
  😎 원장 ▸ 오케이, 바로 해줄게 👌
  💰 연봉 실수령액 (3,600만원) …

나만의 원장도 만들 수 있어요 — wonjang 성격 만들기로 한 줄 묘사 + 말투를 고르면 끝(또는 ~/.local/share/wonjang/SOUL.md를 직접 편집):

wonjang 성격 만들기
  묘사 ▸ 나를 '대장'이라 부르고 츤데레처럼 챙기는 비서
  말투 (1 존댓말 / 2 반말) ▸ 2
  ✅ 나만의 원장이 완성됐어요! 🌟

🧰 이런 걸 다 해줘요

💰 돈 — 한국 직장인이 매일 묻는 것

| 명령 | 하는 일 | | --- | --- | | wonjang 가계부 · 지출 추가 5만 식비 | 오늘·이번 달 지출, 분류별 막대, 월말 예상 | | wonjang 연봉 3600 | 4대 보험·소득세 떼고 월 실수령액(2025 기준) | | wonjang 종소세 5000만 | 종합소득세(개인사업자·프리랜서) 누진세율 추정 + 지방소득세 | | wonjang 원천징수 100만 | 프리랜서 3.3%(기타 8.8%) 공제·실수령 + 역산(--역산) | | wonjang 증여세 5억 자녀 | 증여세 추정(증여재산공제+누진세율+신고세액공제 3%) | | wonjang 상속 7억 --배우자 --자녀 2 | 법정 상속분(민법, 배우자 1.5배·순위·균분) | | wonjang 소멸시효 2020-01-01 상사 | 소멸시효 완성일(채권 종류별 3·5·10년 + D-day) | | wonjang 최고금리 100만 5만 1 | 이자 합법? 연이율 환산 + 이자제한법 20% 한도 체크 | | wonjang 대출 30000 4.5 360 | 원리금/원금균등 월 상환액·총이자 | | wonjang 예금 1000 3.5 12 · 적금 | 만기 수령액(이자소득세 15.4% 반영) | | wonjang 부가세 5만 · 할인 5만 30 | 부가세·중복 할인가 | | wonjang 더치페이 50000 4 | N빵 1인당(올림 단위까지) | | wonjang 전월세 30000 5.5 | 전세 ↔ 월세 전환 | | wonjang 퇴직금 300 3 · 연차 5 · 연차수당 300 5 · 야근 12000 --연장 3 | 퇴직금·연차 일수·미사용 연차 수당·야근수당 | | wonjang 자동차세 1600 | 배기량·차령별 자동차세 | | wonjang 사업자번호 124-81-00998 | 사업자등록번호 검증(세금계산서 오타 잡기) |

금액은 한국식 그대로 알아들어요: 5만 · 1억 · 1.5억 · 50,000 다 OK.

📅 시간·날짜

| 명령 | 하는 일 | | --- | --- | | wonjang 디데이 추가 수능 2026-11-19 · 디데이 | 중요한 날까지 D-day(요일까지·--매년으로 생신·결혼기념일 반복) | | wonjang 기념일 2024-02-14 | 사귄 지 며칠 — 공유 카드 | | wonjang 월급날 25 | 월급날까지 며칠?(매달 반복·말일도 OK) | | wonjang 전역 2025-03-04 육군 | 전역까지 D-day·계급·복무 진행률 (--카드로 전역 자랑 카드) | | wonjang 약속 추가 30분 "약 먹기" | 알림(반복 --every @daily) | | wonjang 나이 1990-05-15 | 만 나이·세는나이·띠·별자리·살아온 날 (--카드로 공유 카드) |

날짜도 한국식: 2026.11.19 · 2026/11/19, 시간은 30분 · 1시간 30분 그대로.

🔥 자기관리

| 명령 | 하는 일 | | --- | --- | | wonjang 습관 추가 운동 · 습관 완료 운동 | 습관 잔디 · 연속일(streak) · 통계(요일 패턴) | | wonjang 집중 25 코딩 | 뽀모도로 타이머 + 이번 주·이번 달 누적 | | wonjang 일기 "오늘 좋았다" · 할일 추가 장보기 | 한 줄 일기 · 체크리스트 |

🇰🇷 한국 생활 유틸

| 명령 | 하는 일 | | --- | --- | | wonjang 평수 84 | 평 ↔ ㎡ (84㎡ = 25.4평) | | wonjang 변환 7 자 · 1 근 | 자·치·돈·근·관·되·말 등 전통 단위 | | wonjang 금액 50000 | 계약서용 한글 금액(일금 오만원정) | | wonjang 로마자 홍길동 | 여권식 로마자 표기 | | wonjang 영타 dkssud | 한영 오타 복구(dkssud → 안녕) | | wonjang 글자수 "자기소개서" --제한 1000 | 자소서 글자수·제한 체크 | | wonjang 최저가 에어팟 | 가격비교 네이버쇼핑·다나와·쿠팡·구글 검색 한 번에(--열기) |

🌐 실시간 정보

wonjang 날씨 서울 · 주간날씨 부산(7일·강수확률) · 미세먼지 · 지하철 강남 · 따릉이 · 환율 100 USD · 공휴일(황금연휴까지)

🛠 도구

wonjang 비밀번호 16 · qr "https://..." · 엑셀(CSV 분석) · 백업/복원 · 해시·인코딩 등

이미지: wonjang 움짤 1.png 2.png 3.png --초 0.5(여러 장 → 움짤) · 이미지이어붙이기 · 이미지 사진.jpg --폭 1280(줄이기)

전체 목록은 wonjang 도움.

🤖 AI 비서로 확장 (선택)

위 기능은 전부 키 없이 됩니다. 거기에 자연어 명령까지 쓰고 싶다면, 이미 깔린 Claude Code(claude)나 Codex(codex) CLI에 자동 연결되거나, API 키를 설정하면 돼요:

export OPENROUTER_API_KEY=sk-or-...    # 또는 claude/codex 로그인만 돼 있어도 OK
wonjang "다운로드 폴더 정리해줘"
wonjang "이 CSV 매출 상위 5개 뽑아줘"

연결되면 파일 정리·문서 작성·셸 작업까지 한국어로 시킬 수 있습니다.

💻 지원 플랫폼

| OS | 아키텍처 | | --- | --- | | macOS | arm64 (Apple Silicon) · x64 | | Linux | x64 (musl 정적) | | Windows | x64 |

지원되지 않는 환경은 소스 빌드:

cargo install --git https://github.com/wonjangcloud9/wonjangAgent

🐞 문제가 있으면 알려주세요

버그나 "이런 기능 있으면" 하는 제안이 있으면 GitHub 이슈 를 남겨주세요. 한국어로 편하게 — 어떤 명령에서 뭘 기대했고 뭐가 나왔는지 적어주시면 큰 도움이 됩니다. 🙏

소스·이슈·기여: https://github.com/wonjangcloud9/wonjangAgent · 라이선스: MIT