로컬 환경을 다루는 한국어 우선 자율 AI 에이전트 — Rust로 작성.
제공자(provider) 무관 LLM, 로컬 도구, 에이전트 루프, 그리고 한국 사용자를 위한 한국어 우선 UX를 갖춘 자율 에이전트입니다.
단일 바이너리로 빠르게 실행되며, 별도 런타임 없이 여러분의 컴퓨터에서 파일과 셸을 직접 다뤄 작업을 수행합니다.
매일 쌓은 습관 잔디·집중·지출·디데이·일기를, 카톡 코드블록에서도 안 깨지는
한 장 카드로 만듭니다. wonjang 자랑 한 번이면 끝(주간은 --주, 클립보드 복사는 --복사).
╭──── 원장 카드 · 2026년 6월 ────╮
│ 🔥 가장 긴 연속 운동 15일 │
│ ▓░▓▓░▓▓ ░▓▓▓░░▓ ▓▓▓▓▓▓▓ ▓▓▓▓▓▓▓│
│ 🍅 이번 달 집중 32시간 │
│ 💰 이번 달 지출 240,000원 │
│ 📅 다가오는 날 발표 D-17 │
│ ✍️ 이번 달 일기 1번 │
├────────────────────────────────┤
│ 💬 운동 15일 연속, 잘 쌓고 있어│
╰─ 나도 만들기 → wonjang-agent ──╯
PNG가 아니라 텍스트라 어디든 붙여넣기만 하면 됩니다. 한글·이모지의 전각폭을 정확히 계산해 박스가 절대 어긋나지 않습니다(폭은
--폭 34로 카톡에 맞춤).
같은 박스 시스템으로 만드는 공유 카드 4종:
- 🌟 자랑 카드 —
wonjang 자랑(한 달의 습관·집중·지출·디데이) - 🌱 성장 카드 —
wonjang 성장(원장이 기억한 사실·익힌 스킬·함께한 대화 — "쓸수록 성장"이 눈에 보이게) - 🎯 D-day 카드 —
wonjang 디데이 카드("수능 D-100"을 캡처해 자랑) - 💕 기념일 카드 —
wonjang 기념일 2024-01-01 우리("우리 1000일째")
모두 풋터 나도 만들기 → wonjang-agent로 받은 사람도 바로 설치할 수 있어요.
| 갈래 | 할 수 있는 일 |
|---|---|
| 🤖 AI 에이전트 | 자연어로 셸·파일·이메일·문서 작업. 시작 시 Claude Code/Codex에 자동 연결(키 불필요) — 연결 시 원장 비서 도구(기억·알림·가계부·날씨 등)도 MCP로 함께 물려줌 |
| 🌟 공유 카드 | 카톡에 안 깨지는 한 장 카드 4종 — 자랑 카드(자랑, 주간 --주) · 성장 카드(성장, 원장이 배운 것) · D-day 카드(디데이 카드, 수능 D-100) · 기념일 카드(기념일, 우리 1000일). 복사 --복사·카톡폭 --폭 34 |
| 🎭 내 비서의 성격 | wonjang 성격 친구로 말투를 고릅니다(다정·친구·집사·선배·발랄). SOUL.md로 직접 편집 가능 |
| 📧 이메일 | 받은편지함 목록·검색·본문 읽기 · 첨부 저장 · 보내기(파일 첨부). IMAP/SMTP(순수 rustls), 앱 비밀번호만 있으면 OK |
| 📄 PDF·이미지 | 사진→PDF 묶기 · PDF 합치기/페이지 추출/회전 · 이미지 축소·압축·형식변환(png↔jpg)·이어붙이기(긴 캡처), EXIF 방향 자동 보정 |
| 📂 내 파일 다루기 | 엑셀·CSV 분석 · 용량/중복/자동분류 · 이름 일괄변경 · 압축(내용 보기 포함) · 한글 깨짐(CP949) 복구 · 내용검색 · JSON · 체크섬 |
| 🇰🇷 실시간 한국 정보 | 지하철 · 혼잡도 · 따릉이 · 날씨 · 미세먼지 · 환율 · 코인 · 뉴스 · 긱뉴스 · 공휴일(다음 연휴·연차 하나로 황금연휴 + 연휴 공유 카드 --카드) |
| 🗓️ 개인 비서 | 약속·알림 · 할일 · 디데이(캘린더 .ics 내보내기) · 가계부(CSV 내보내기→분석) · 습관 · 집중타이머 · 즐겨찾기 · 일기 · 아침 브리핑 · 푸시알림 |
| 🧮 생활·금융 계산기 | 실수령액 · 대출 · 예적금 · 전월세 전환 · 퇴직금·연차·야근수당(근로기준법) · 자동차세 · 평수 · 만나이(살아온 날·기념일) · 한글이름 → 여권 로마자 · 할인 · 부가세 · 시급 · 자소서 글자수(--제한) · 단위변환(돈·근·자 등 한국 전통단위) · 그 외 다수 |
| 🛠️ 편의 | QR 생성 · 또간집 맛집 · 메뉴추천 · 제비뽑기 · 옵시디언/노션 연동 |
대부분 키 없이 바로 동작합니다. 일부 실시간 정보는 무료 키로 더 풍부해집니다(
wonjang config참고).
- 🦀 단일 러스트 바이너리 — 의존 런타임 없이 빠르게 시작.
- 🇰🇷 한국어 우선 — 모든 메시지·프롬프트·도움말이 한국어.
- 🔑 API 키 없이도 OK — 이미 로그인된 Claude Code나 Codex를 시작 시 자동으로 엔진으로 연결합니다(별도 키 불필요). 물론 API 키도 그대로 지원.
- 🔌 제공자 무관 — OpenAI 호환 엔드포인트면 무엇이든(OpenRouter, OpenAI, DeepSeek, 로컬 vLLM 등). 모델은 설정 한 줄로 교체.
- 🛠 로컬 도구 — 셸 실행, 파일 읽기/쓰기, 디렉터리 목록.
- 🌐 웹 검색/가져오기 — 별도 API 키 없이 웹을 검색하고 페이지 본문을 읽어옵니다.
- 👥 서브에이전트 — 큰 작업을 격리된 하위 에이전트에 위임하고, 여러 개를 병렬로 동시에 처리합니다.
- 🔗 MCP 연동 — 외부 MCP 서버(파일시스템·깃허브 등)를 연결해 그 도구들을 원장 도구로 바로 사용합니다.
- 📱 텔레그램 게이트웨이 — 휴대폰 등 어디서든 메시지로 원장에게 작업을 시키고 결과를 받습니다(허용 chat_id 화이트리스트로 보호).
- 🇰🇷 작업 프리셋 — "다운로드정리", "오늘커밋" 등 자주 쓰는 작업을 한국어 이름 하나로 실행. 나만의 프리셋도 추가할 수 있습니다.
- 📓 옵시디언 연동 — 볼트의 노트를 검색·읽기·기록. 일지, 메모, 할 일을
한국어 명령 하나로 관리합니다(
일지,메모,노트검색프리셋). - 🗒 노션 연동 — 워크스페이스를 검색하고 페이지에 기록합니다(
노션검색,노션저장프리셋,wonjang notion). - ⏰ 약속·알림 — "내일 3시 치과 알려줘"처럼 등록하면, 24시간 스케줄러가
때맞춰 데스크탑 알림을 띄웁니다. "매일 아침 약 먹기"같은 반복 알림도 OK
(
wonjang remind). - ✅ 할 일 관리 —
wonjang 할일 추가 "장보기"로 체크리스트 관리. 약속(시각)과 할 일(목록)을 따로 관리합니다. - ☀️ 아침 브리핑 —
브리핑프리셋으로 오늘 날짜·날씨·약속·할 일을 한 번에. - 📲 푸시 알림 — 디스코드/슬랙/텔레그램/**카카오톡(나에게 보내기)**으로 알림을
휴대폰에 보냅니다. 약속이 울리면 외출 중에도 받아요(
wonjang notify). - 📋 클립보드 연동 — 복사한 글/링크를 바로
번역·클립요약·클립저장(옵시디언) 프리셋으로 처리합니다. - 📅 디데이(D-day) — 수능·기념일·마감 등 중요한 날까지 남은 일수를 챙기고
아침 브리핑에 보여줍니다(
wonjang dday). - 🗂 현황 대시보드 —
wonjang 현황한 줄로 약속·할일·디데이·습관·집중·지출을 시간대 인사와 함께 한눈에(LLM 없이 즉시). 하루 마무리는회고프리셋으로. - 💾 데이터 백업·복원 —
wonjang 백업으로 모든 데이터를 한 번에 백업하고,wonjang 복원 <폴더>로 다른 기기에 그대로 옮깁니다(복원 전 자동 백업). - 💰 가계부 —
wonjang 지출 추가 8000 식비 점심으로 지출을 기록하고 오늘·이번달 합계, 분류별 지출을 봅니다. - 🔥 습관 트래커 —
wonjang 습관 추가 "운동"/완료로 매일 체크하고 연속 일수(streak)를 챙깁니다(갓생!). - 🍅 집중 타이머(뽀모도로) —
wonjang 집중 25 코딩으로 타이머+알림을 걸고 오늘 집중 시간을 누적합니다. - 🔖 즐겨찾기 + 빠른 열기 —
wonjang 열기 노션처럼 자주 가는 사이트·폴더·앱을 한국어 단축어로 엽니다. - 📊 엑셀·CSV 분석 —
wonjang 엑셀 매출.csv로 내 컴퓨터의 파일을 직접 읽어 요약·미리보기를,--열 금액으로 합계·평균·최대·최소를, **--그룹 지점 --열 매출으로 분류별 집계(피벗·막대그래프)**를,--정렬 매출로 상위 행을,--필터 지역=서울로 조건 행만(정렬·집계와 조합)을,--json으로 JSON 변환을 합니다. 여러 시트가 있는 .xlsx는--시트 재고로 탭을 골라 분석하고,--저장 결과.csv로 거른·정렬한·집계한 결과를 새 CSV로 내보냅니다(읽기→분석→저장 한 줄). - 🧩 여러 표 합치기 —
wonjang 표합치기 1월.csv 2월.csv 3월.csv --저장 합본.csv로 월별·지점별 파일을 머리글 기준으로 한 장에(열 순서가 달라도 이름으로 맞춤,--출처로 출처 열 추가). 합친 뒤 바로엑셀로 분석. - 🍜 또간집 맛집 찾기 —
wonjang 또간집 종로로 풍자 〈또간집〉 선정 맛집을 지역으로 검색합니다. 공식 API가 없어 직접 키우는 로컬 목록(--추가로 확인한 곳 등록). - 💾 디스크 용량 분석 —
wonjang 용량 ~/Downloads로 큰 파일·폴더를 찾아 "어디가 꽉 찼는지"를 알려줍니다(읽기 전용, 안전). - 🔁 중복 파일 찾기 —
wonjang 중복 ~/Downloads로 내용이 같은 파일과 낭비 용량을 찾아줍니다(크기+내용 해시 비교, 읽기 전용). - 🗂️ 폴더 자동 분류 —
wonjang 정리 ~/Downloads로 뒤섞인 파일을 이미지·문서·동영상 등으로 분류합니다. 기본은 미리보기,--실행을 줘야 실제로 옮깁니다(안전). - ✏️ 파일 이름 일괄 변경 —
wonjang 이름변경 ~/사진 IMG_ 여행_으로 파일명 속 문자를 한 번에 치환합니다(기본 미리보기,--실행으로 적용). - 🗜️ 압축/해제·미리보기 —
wonjang 압축 ~/문서로 zip을 만들고wonjang 압축풀기 자료.zip으로 풉니다(한글 파일명·폴더 구조 보존, zip-slip 방어).wonjang 압축보기 자료.zip은 풀지 않고 목록만 보여주며, 윈도우 zip의 CP949로 깨진 한글 파일명을 자동 복구합니다. - 📧 이메일(IMAP·SMTP) — 앱 비밀번호만 환경변수(
WONJANG_EMAIL·WONJANG_EMAIL_PASSWORD)에 넣으면,wonjang 메일(받은편지함)·메일검색 영수증·메일읽기 1(본문)·메일첨부 1(첨부 저장)·메일보내기 --받는사람 … --첨부 파일(보내기)까지. 순수 rustls라 openssl 없이 동작하고, 한글 제목·CP949까지 제대로 디코드합니다. (gmail·naver·daum·kakao 등 호스트 자동 추정) - 📄 PDF 다루기 —
wonjang 사진묶기 *.jpg로 여러 사진을 한 PDF로(서류 제출),pdf합치기 a.pdf b.pdf(합본) ·pdf페이지 보고서.pdf 1-3,5(원하는 페이지만) ·pdf회전 스캔.pdf 90(옆으로 스캔된 서류 바로 세우기). 모두 로컬에서, 키 없이. - 🖼️ 이미지 다루기 —
wonjang 이미지 *.jpg --폭 1280으로 여러 장을 한 번에 줄여 첨부 용량을 낮추고(폰 사진의 EXIF 방향 자동 보정),--형식 jpg/--형식 png로 png↔jpg를 변환합니다.wonjang 이미지이어붙이기 1.png 2.png --세로로 여러 캡처·영수증을 한 장으로(가로는--가로). 원본은 항상 보존(_작게/_변환). - 🔎 파일 내용 검색 —
wonjang 찾기 ~/메모 계약으로 폴더 안 텍스트 파일에서 단어가 든 줄을 파일·줄번호와 함께 찾습니다(바이너리 제외, 읽기 전용). - 🧩 JSON 도구 —
wonjang json data.json으로 검증·정렬을,--키 meta.port로 값을 추출합니다(오류 위치 표시). - 🔐 파일 체크섬 —
wonjang 해시 setup.dmg로 SHA-256을 계산하고--확인 <값>으로 다운로드 파일 무결성을 검증합니다(shasum과 동일). - 📑 파일 비교(diff) —
wonjang 비교 old.txt new.txt로 두 파일의 줄 단위 차이(추가/삭제)를 봅니다(설정·버전 비교). - 📱 QR 코드 생성 —
wonjang qr https://...또는wonjang qr --wifi <SSID> --비번 <비번>으로 터미널에 스캔 가능한 QR을 그립니다(와이파이·링크 공유). - 🌏 세계 시간 —
wonjang 세계시간 뉴욕으로 주요 도시의 현재 시각을 봅니다(서머타임 정확 반영). - 🕑 시간대 변환 —
wonjang 시차 09:00 서울 뉴욕으로 특정 시각을 도시 간 환산합니다(해외 회의 일정). - 🤓 긱뉴스(GeekNews) —
wonjang 긱뉴스로 개발·기술·스타트업 최신글을 봅니다(키 불필요). - 🐙 GitHub 저장소 정보 —
wonjang 깃헙 rust-lang/rust로 별·이슈·최신 릴리스를 봅니다(키 불필요). - 🌐 내 공인 IP —
wonjang 내아이피로 현재 공인 IP·통신사·위치를 확인합니다(VPN·네트워크 점검). - 🩺 사이트 상태 확인 —
wonjang 사이트 example.com으로 사이트/서버가 살아있는지·응답 속도를 점검합니다. - 🗓️ 한국 공휴일 —
wonjang 공휴일로 설날·추석(음력)까지 정확한 공휴일과 "다음 빨간날 D-day"를 봅니다(무료 API, 키 불필요). 연차 계획에 유용. - 🚇 서울 지하철 실시간 —
wonjang 지하철 강남으로 역 이름만 입력하면 실시간 도착정보를 보여줍니다(샘플 키로 바로 동작). - 🚦 서울 실시간 혼잡도 —
wonjang 혼잡도 강남역으로 명소·상권의 붐빔 정도와 실시간 인구를 봅니다(서울 열린데이터 키 발급 시 원하는 지역 조회). - 🚲 서울 따릉이 실시간 —
wonjang 따릉이 강남역으로 대여소의 남은 자전거·거치대를 조회합니다(혼잡도·지하철과 같은 서울 키 슬롯). - ☀️ 실시간 날씨 —
wonjang 날씨 [지역]으로 기온·체감·강수·최저최고를 정확히 (open-meteo, 키 불필요). 아침 브리핑에도 연동. - 🌫 미세먼지 —
wonjang 미세먼지 [지역]으로 PM10·PM2.5와 환경부 등급 (좋음/보통/나쁨)을 봅니다(키 불필요). - 💱 환율 —
wonjang 환율로 주요 통화를,wonjang 환율 100 USD로 원화 환산을 실시간으로(키 불필요). - 🪙 코인 시세 —
wonjang 코인으로 업비트 인기 코인을,wonjang 코인 BTC로 특정 코인을 실시간 시세·변동률과 함께(키 불필요). - 📰 뉴스 —
wonjang 뉴스 [검색어]로 최신 헤드라인을(구글뉴스, 키 불필요). 아침 브리핑에도 연동. - 🎱 로또 자동번호 —
wonjang 로또로 재미로 자동 번호를 뽑습니다. - 📐 평수 변환 —
wonjang 평 30으로 평 ↔ 제곱미터를 양방향으로(부동산 필수). - 📏 단위 변환 —
wonjang 변환 100 c로 온도·무게·길이·속도·부피·넓이를 변환합니다(c/f, kg/lb, cm/inch, km/mile, kmh/mph, l/gal, sqm/sqft). - ⚖️ BMI 계산 —
wonjang bmi 175 68로 체질량지수와 판정·표준체중을(대한비만학회 아시아 기준). - 🍚 칼로리 계산 —
wonjang 칼로리 남 30 175 70으로 기초대사량(BMR)·활동별 하루 권장 칼로리를(다이어트·운동). - 😴 수면 시간 계산 —
wonjang 수면 07:00으로 90분 수면 주기에 맞춘 개운한 취침/기상 시각을. - 🏷️ 할인가 계산 —
wonjang 할인 30000 20 10으로 (중복) 할인가·절약액·실질 할인율을. - 🧾 부가세 계산 —
wonjang 부가세 100000으로 공급가액·세액을 양방향으로 분리합니다(VAT 10%). - 📅 날짜 계산 —
wonjang 날짜 2026-01-01 2026-12-31로 두 날짜 사이 일수를,--plus N으로 N일 후 날짜를. - ✍️ 글자수 세기 —
wonjang 글자수 "자기소개서 내용"으로 공백 포함/제외 글자수·단어·줄·바이트를(자소서·SNS). - 🔡 한글 초성 추출 —
wonjang 초성 "안녕하세요"로 초성(ㅇㄴㅎㅅㅇ)을 뽑습니다(초성 퀴즈·검색). - ⌨️ 한글→영문 타자 —
wonjang 영타 "안녕"으로 두벌식 키 순서(dkssud)를 알려줍니다. - 🔁 영문→한글 복원 —
wonjang 한타 dkssud로 한/영 전환을 깜빡하고 잘못 친 글자를 "안녕"으로 되살립니다. - 💴 한글 금액 표기 —
wonjang 금액 1234567로 "일금 일백이십삼만사천오백육십칠원정"을(계약서·수표). - 🧮 계산기 —
wonjang 계산 "15000 * 1.1 + 3000"으로 괄호·소수·음수 사칙연산을 바로. - ⏱️ 시간 계산 —
wonjang 시간 09:00 + 8:30으로 시·분을 더하고 빼서 근무시간을 합산합니다. - 🔢 진법 변환 —
wonjang 진법 255(또는0xFF)로 2·8·10·16진수를 한 번에 변환합니다. - ⏰ 유닉스 타임스탬프 —
wonjang 타임스탬프로 현재 유닉스 시각을,1700000000으로 로그 타임스탬프를 사람이 읽는 시각으로 변환합니다. - 🏛️ 로마 숫자 —
wonjang 로마 2024(→MMXXIV) 또는wonjang 로마 MMXXIV(→2024)로 양방향 변환합니다. - 🔠 인코딩 —
wonjang 인코딩 base64 "텍스트"(또는url)로 인코딩·디코딩(-d)합니다(JWT·URL 파라미터). - 🔑 안전한 비밀번호 생성 —
wonjang 비번 16 --기호로 OS 난수 기반 강력한 비밀번호를(암호학적으로 안전). - 🆔 UUID 생성 —
wonjang uuid -n 3으로 무작위 UUID v4를 생성합니다(DB 기본키·요청 ID). - 🎨 색상 변환 —
wonjang 색 #ff5733으로 HEX↔RGB↔HSL을 변환합니다(디자인·CSS). - 🎂 만 나이 계산 —
wonjang 나이 1990-03-15로 만 나이·연 나이·띠·별자리·다음 생일을(만 나이 통일법). - 💰 연봉 실수령액 —
wonjang 실수령 3600으로 4대 보험·소득세 공제 후 월/연 실수령을. - 💵 시급·주휴수당 —
wonjang 시급 10030 40으로 주급·월급을(주 15시간↑ 주휴수당·최저임금 경고). - 🏦 대출 상환 계산 —
wonjang 대출 30000 4.5 360으로 원리금/원금 균등 월 상환액·총이자를. - 🐷 예적금 만기 계산 —
wonjang 예금 1000 3.5 12/wonjang 적금 50 4.0 24로 세후 이자·만기 수령액을(이자소득세 15.4%). - 🍽️ 오늘 뭐 먹지? —
wonjang 메뉴또는wonjang 메뉴 중식으로 식사 메뉴를 추천받습니다. - 🧾 더치페이(n빵) —
wonjang 더치 50000 3으로 1인당 금액·거스름돈을 정산합니다. - 🎯 제비뽑기/추첨 —
wonjang 뽑기 철수 영희 민수로 당첨자를(또는--order로 순서를) 정합니다. - 🔔 시세 알림 —
wonjang 감시 add BTC 110000000(코인)·감시 add USD 1400(환율)처럼 등록하면, 스케줄러가 지켜보다 목표가 도달 시 휴대폰으로 푸시합니다(24시간 자동 감시). - 🧠 영속 메모리 — 사용자/환경에 대해 배운 사실을 디스크에 저장하고 다음
세션에 자동으로 불러와 "함께 성장"합니다.
wonjang 기억 "<사실>"로 직접 기억시키고, 틀린 기억은wonjang 잊어 <키워드>(또는 대화로 "그거 잊어줘")로 지웁니다. - 📚 스킬(절차 기억) — 까다로운 작업을 해결하면 그 방법을 스킬로 저장하고,
비슷한 일을 만나면 스스로 꺼내 재사용합니다. 잘못 저장된 스킬은
wonjang 스킬 삭제 <이름>으로 지웁니다. - 🌱 성장 카드 —
wonjang 성장한 번이면 기억한 사실·익힌 스킬·함께한 대화 수와 "함께 N일째"를 한 장 카드로 — 성장이 눈에 보입니다. - 💾 세션 저장/이어가기 — 대화가 자동 저장되어
--continue로 언제든 이어집니다. - ⏰ 예약 작업(크론) — "매일", "30분마다" 같은 일정으로 작업을 무인 실행합니다.
- ☀️ 자동 아침 브리핑 — 스케줄러가 매일 정해진 시각에 브리핑을 만들어
휴대폰(카카오/디스코드/슬랙/텔레그램)으로 자동 푸시합니다(
WONJANG_BRIEFING_TIME). - 🛡 안전 우선 — 셸 명령은 실행 전 승인을 요청하고, 위험 명령(
rm -rf,sudo,git reset --hard등)은 무인 모드(크론·텔레그램)에서 기본 차단합니다. - 💬 대화형 REPL + 단발 실행 모두 지원.
npm install -g wonjang-agent설치 시 플랫폼에 맞는 네이티브 바이너리를 자동으로 내려받아 wonjang 명령으로
바로 쓸 수 있습니다. 지원: macOS(arm64/x64) · Linux(x64) · Windows(x64).
Rust 툴체인이 필요합니다(rustup.rs).
# 저장소에서 바로 설치
cargo install --git https://github.com/wonjangcloud9/wonjangAgent
# 또는 클론 후 빌드
git clone https://github.com/wonjangcloud9/wonjangAgent.git
cd wonjangAgent && cargo build --release # 결과물: ./target/release/wonjang원장은 시작할 때 사용할 엔진을 자동으로 정합니다(backend = "auto"):
- API 키가 있으면 → OpenAI 호환 API로 자체 도구 루프 실행
- 없으면 → 이미 로그인된 Claude Code(
claude) 또는 Codex(codex)에 연결해 그걸 엔진으로 사용 — 별도 API 키가 필요 없습니다.
즉, Claude Code나 Codex를 이미 쓰고 있다면 아무 키 설정 없이 바로:
wonjang "이 폴더 정리해줘" # → Claude Code/Codex가 실제 작업 수행, 원장이 한국어로 진행CLI 백엔드에서는 사용자의 Claude Code/Codex가 자신의 도구·권한으로 작업합니다.
원장이 -y(자동 승인)이면 쓰기 도구(Bash/Edit 등)까지 허용하고, 아니면 읽기 전용으로
제한합니다. 백엔드를 직접 고르려면:
export WONJANG_BACKEND=claude # auto | api | claude | codexAPI 키는 보안을 위해 환경 변수로만 받습니다(설정 파일에 저장하지 않음).
# OpenRouter 예시
export OPENROUTER_API_KEY=sk-or-...
export WONJANG_MODEL=anthropic/claude-opus-4.8
# 또는 OpenAI 직접
export WONJANG_BASE_URL=https://api.openai.com/v1
export OPENAI_API_KEY=sk-...
export WONJANG_MODEL=gpt-4o| 환경 변수 | 설명 | 기본값 |
|---|---|---|
WONJANG_BACKEND |
엔진 선택(auto/api/claude/codex) | auto |
WONJANG_BASE_URL |
OpenAI 호환 베이스 URL | https://openrouter.ai/api/v1 |
WONJANG_MODEL |
모델 이름 | anthropic/claude-opus-4.8 |
WONJANG_API_KEY |
API 키(없으면 OPENROUTER_API_KEY → OPENAI_API_KEY 폴백) |
— |
WONJANG_OBSIDIAN_VAULT |
옵시디언 볼트 경로(노트/일지/메모 기능) | — |
현재 설정/백엔드 확인:
wonjang config💡 무엇을 할 수 있는지 한눈에:
wonjang 도움
대화형 모드
wonjang 원장 에이전트 v1.67.1
🔑 키 없이 Claude Code에 연결됐어요 — 바로 쓸 수 있어요
안녕하세요, 원장입니다 🌙 오늘은 6월 11일 (목).
🔥 운동 5일째 ▓▓░▓▓▓▓
🧠 기억 4 · 스킬 1 — 점점 당신에게 맞춰지는 중 (wonjang 성장)
💡 오늘의 팁: 이번 달 자랑 카드 → wonjang 자랑 (카톡엔 --폭 34)
무엇이든 한국어로 시켜보세요. /help · /성격 · /자랑 · /exit
당신 ▸ 이 폴더에 뭐가 있는지 알려줘
단발 실행
wonjang "git 상태 알려줘"
wonjang -y "현재 폴더 파일을 종류별로 정리하는 스크립트 짜줘" # -y: 자동 승인
wonjang --continue "아까 하던 거 계속하자" # -c: 직전 대화 이어가기세션 관리
wonjang sessions # 저장된 대화 목록(최신순)
wonjang --continue # 가장 최근 대화 이어가기예약 작업(크론)
일정에 맞춰 작업을 무인 실행합니다. 스케줄은 간격 기반입니다 —
@minutely · @hourly · @daily · @weekly, 또는 @every 30m, 2h, 1d 처럼 지정.
wonjang cron add "@daily" "오늘 한 git 커밋들 요약해줘"
wonjang cron add "@every 30m" "다운로드 폴더를 종류별로 정리해줘"
wonjang cron list # 등록된 작업 목록
wonjang cron remove 1 # 작업 삭제
wonjang cron run # 스케줄러 실행(포그라운드, Ctrl-C로 종료)
⚠️ cron run은 무인 실행이라 도구(셸 명령 포함)를 자동 승인합니다. 신뢰할 수 있는 작업만 등록하세요.
MCP 서버 연동
외부 MCP 서버를 연결하면 그 도구들이
mcp_<서버>_<도구> 이름으로 에이전트에 자동 등록됩니다. 설정 파일에 추가하세요:
[[mcp_servers]]
name = "fs"
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "/Users/me/work"]wonjang mcp # 연결 확인 + 제공 도구 목록텔레그램 게이트웨이
휴대폰 등 어디서든 메시지로 원장에게 작업을 시킵니다. @BotFather로 봇을 만들고 토큰을 환경 변수에 넣으세요.
export TELEGRAM_BOT_TOKEN=123456:ABC...
wonjang telegram처음엔 허용 목록이 비어 있어, 봇에게 메시지를 보내면 본인 chat_id를 알려줍니다. 그 값을 설정에 추가한 뒤 다시 실행하세요:
telegram_allowed_ids = [123456789]
⚠️ 게이트웨이는 원격 무인 실행이라 도구(셸 포함)를 자동 승인합니다. 반드시 본인 chat_id만telegram_allowed_ids에 등록하세요. 등록되지 않은 사용자의 요청은 절대 실행되지 않습니다.
작업 프리셋 🇰🇷
자주 쓰는 로컬 작업을 한국어 이름 하나로 실행합니다.
wonjang preset list # 사용 가능한 프리셋 목록
wonjang preset run 다운로드정리 # 다운로드 폴더를 종류별로 정리
wonjang preset run 큰파일 "100MB 넘는것만" # 추가 지시도 가능
wonjang -y preset run 오늘커밋 # -y로 자동 승인빌트인: 다운로드정리 · 바탕화면정리 · 큰파일 · 오늘커밋 · 포트 · 와이파이 ·
정돈 · 디스크 · 중복파일 · 배터리 · 압축 · 날씨 · 환율 ·
일지 · 메모 · 노트검색(옵시디언)
나만의 프리셋은 ~/.config/wonjang/presets.toml에 추가하세요:
[[preset]]
name = "백업"
description = "프로젝트를 외장 디스크에 복사"
aliases = ["backup"]
prompt = "현재 프로젝트 폴더를 /Volumes/외장/backup 으로 복사해줘. rsync를 쓰고 진행 전 계획을 보여줘."REPL 슬래시 명령
| 명령 | 설명 |
|---|---|
/help |
도움말 |
/reset |
대화 기록 초기화 |
/exit |
종료 |
💡 팁: 구체적으로 요청할수록 잘 동작합니다. "코드 고쳐줘"보다 "api/handlers.py 47번째 줄 TypeError 고쳐줘"처럼 명확히 말해 주세요.
원장은 로컬 환경을 직접 다루므로 안전을 우선합니다.
- 대화형 모드 — 모든 셸 명령은 실행 전 확인을 받습니다. 위험 명령은 빨간 경고와 함께 더 강하게 확인합니다.
- 무인 모드(크론·텔레그램) —
rm -rf,sudo,dd,mkfs,git reset --hard, 포크 폭탄, 파이프-투-셸(| sh) 등 되돌리기 어려운 명령을 기본 차단합니다. - 꼭 필요하면
--allow-dangerous로 명시적으로 허용할 수 있습니다(권장하지 않음).
| 도구 | 설명 |
|---|---|
run_shell |
셸 명령 실행(기본: 실행 전 승인) |
read_file |
파일 내용 읽기 |
write_file |
파일 쓰기(상위 폴더 자동 생성) |
list_dir |
디렉터리 목록 |
remember |
기억할 사실을 영속 메모리에 저장 |
recall |
저장된 메모리 회상 |
save_skill |
재사용 가능한 절차를 스킬로 저장 |
list_skills |
보유 스킬 목록 조회 |
read_skill |
특정 스킬의 전체 절차 읽기 |
web_search |
웹 검색(제목·URL·요약) |
web_fetch |
URL 페이지 본문을 텍스트로 가져오기 |
spawn_subagent |
하위 작업을 별도 에이전트에 위임 |
spawn_subagents |
여러 하위 작업을 병렬로 위임 |
저장된 메모리와 스킬은 언제든 확인할 수 있습니다:
wonjang memory # 기억하고 있는 사실
wonjang skills # 익힌 스킬 목록src/
├── main.rs # CLI 진입점 + 대화형 REPL
├── engine.rs # 백엔드 추상화(API / Claude Code / Codex)
├── cli_backend.rs # Claude Code·Codex CLI 위임
├── agent.rs # 에이전트 루프(LLM ↔ 도구 왕복, API 백엔드)
├── llm.rs # OpenAI 호환 LLM 클라이언트
├── config.rs # 설정 로딩(환경 변수 > 파일 > 기본값)
├── memory.rs # 영속 메모리(세션 간 사실 유지)
├── notes.rs # 옵시디언 볼트 연동(검색/읽기/기록)
├── reminders.rs # 약속·알림(데스크탑 알림)
├── preset.rs # 작업 프리셋(한국 편의 기능)
├── safety.rs # 위험 명령 분류기(안전장치)
├── session.rs # 세션 저장/이어가기
├── skill.rs # 스킬(절차 기억) 저장소
├── cron.rs # 예약 작업 스케줄러
├── mcp.rs # MCP 클라이언트(stdio JSON-RPC)
├── gateway.rs # 텔레그램 메시징 게이트웨이
├── web.rs # 웹 검색/가져오기 코어
├── util.rs # 공용 유틸(동기↔비동기 브리지)
├── ui.rs # 한국어 우선 터미널 UI
└── tools/ # 로컬 환경 도구
├── shell.rs
├── fs.rs
├── memory.rs
├── skill.rs
├── web.rs
├── subagent.rs
└── mcp.rs
초기 로드맵(에이전트 코어 → 한국 생활 유틸 100여 종)을 모두 달성하고, 지금은 매 릴리스마다 매력·완성도를 다듬고 있습니다. 버전별 변경 이력은 CHANGELOG.md에서 한눈에 볼 수 있습니다.
cargo test # 단위 테스트
cargo test -- --ignored # 네트워크가 필요한 라이브 테스트(web/mcp)
cargo fmt --check # 포맷 검사
cargo clippy --all-targets -- -D warnings푸시·PR마다 CI(포맷·클리피·테스트)가 돌고, v* 태그를 푸시하면 멀티플랫폼
바이너리를 빌드해 GitHub Release에 올리고 npm에 배포합니다. 자세한 릴리스 절차는
CONTRIBUTING.md를 참고하세요.
빌드 정책: 의존성은 순수 Rust / rustls만 씁니다(OpenSSL 등 C 의존성 금지).
x86_64-unknown-linux-musl정적 빌드를 깨지 않기 위함입니다 — 예를 들어 TLS가 필요하면native-tls가 아니라rustls(reqwest의rustls-tls, lettre의tokio1-rustls-tls등)를 선택하세요. (현재 의존성 트리에 openssl 0개)
버그를 만나거나 "이런 기능 있으면 좋겠다" 싶은 게 있으면 GitHub 이슈 를 남겨주세요. 한국어로 편하게 적어주시면 됩니다 — 어떤 명령에서, 무엇을 기대했고, 무엇이 나왔는지 적어주시면 큰 도움이 됩니다. 🙏
MIT