hiworks
브라우저 없이 하이웍스 로그인 세션을 만들어 메일·휴가·결재·일정·조직도를 JSON으로 다루는 플러그인. 비밀번호는 OS 키체인에만 저장한다. 하이웍스와 무관한 비공식 프로젝트.
#hiworks#groupware#mail#leave#scrapling#keychain#plugin
Install
설치
claude plugin marketplace add hjsh200219/hiworks && claude plugin install hiworks@hiworksRequirements
- Claude Code (CLI)
- uv (Python과 의존성은 uv가 받음)
- 하이웍스 계정
- 비공식 도구 — 하이웍스가 API를 바꾸면 동작하지 않을 수 있음
- `person`·`org`·`leave-calendar`는 로그인한 계정이 볼 수 있는 범위만 돌려줌 — 결과를 회사 밖으로 옮기지 말 것
- 키체인이 없는 환경(Linux 서버 등)은 `HIWORKS_USERNAME`/`HIWORKS_PASSWORD` 환경변수 사용
Capabilities
주요 기능
- 01설치 후 `/hiworks:setup`으로 이메일·비밀번호 등록 — 비밀번호는 채팅이 아니라 터미널 프롬프트나 OS 비밀번호 창으로만 받고, 맞을 때만 저장
- 02Scrapling으로 하이웍스 로그인 API를 직접 호출해 세션을 저장·재사용 (브라우저 불필요). 2단계 인증(OTP) 계정은 인증 코드 6자리 입력 창 제공
- 03메일 — 목록·읽기·쓰기(첨부·답장·전달)·삭제. 발송·삭제는 `--yes` 없이는 미리보기만
- 04인사 — 내 잔여 휴가, 전사 휴가 캘린더(다른 사람 휴가 기간), 휴가 신청·취소와 결재선 저장, 조직도·직원 조회
- 05근무 체크(출근·퇴근), 전자결재 문서·상태 조회, 일정 조회·등록, 아침 요약(`today`)
- 06로그인·인증 코드는 실패해도 자동 재시도하지 않음(계정 잠김 방지)
- 07비밀번호는 OS 키체인(macOS 키체인·Windows 자격 증명 관리자·Linux Secret Service), 이메일·세션 쿠키는 `~/.hiworks/`(권한 600)
About
About
hiworks is a Claude Code plugin that handles Hiworks groupware login without a browser. It calls the login API directly with Scrapling, stores the session and reuses it, and returns mail, leave, approval, calendar and org-chart data as JSON.
The password is never typed into chat: it is collected through a terminal prompt or an OS password dialog and stored only in the OS keychain, and only after it is verified. Login and verification-code failures are never retried automatically, to avoid locking the account. Sending or deleting mail, requesting leave and similar write actions only preview unless --yes is passed.
It is an unofficial personal project, not affiliated with Hiworks (Gabia), and it replays the API the Hiworks web login uses — if Hiworks changes it, the plugin may stop working. Directory results are limited to what the logged-in account can already see; they should not be moved outside the company.
Related
같은 카테고리의 다른 도구
lyn-lawfirm고소장·내용증명·형사합의서·사실확인서 작성, 형사절차 시뮬레이터, 양형 예측 등 lyn-* 법률 스킬 6종을 한 번에 설치하는 플러그인. 법령·판례 검색은 K Data MCP 연결 설정을 포함한다. AI는 실수할 수 있으며 법률 자문이 아니다.stt클로바노트 전사를 가져오고 Apple 음성 메모·내보낸 녹음은 이 Mac에서 whisper.cpp로 로컬 전사해 Markdown 노트(vault)로 저장하는 플러그인. Apple 녹음은 외부로 업로드하지 않는다.vc-researchDIVA 전자공시를 실시간으로 읽어, 투자받을 수 있는 벤처투자조합·담당 펀드매니저·남은 투자재원 추정·법규위반 이력을 피투자자 관점에서 찾아 주는 플러그인.