hiworks

브라우저 없이 하이웍스 로그인 세션을 만들어 메일·휴가·결재·일정·조직도를 JSON으로 다루는 플러그인. 비밀번호는 OS 키체인에만 저장한다. 하이웍스와 무관한 비공식 프로젝트.

#hiworks#groupware#mail#leave#scrapling#keychain#plugin
Install

설치

claude plugin marketplace add hjsh200219/hiworks && claude plugin install hiworks@hiworks
Requirements
  • 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.