GitHub 저장소 · 작성자 jh3ady

time-check

Name: time-check
Author: jh3ady

요일별로 설정한 시간대 안에서 프롬프트를 보내기 전에 시간을 확인하게 하는 Claude Code 플러그인입니다.

jh3ady@jh3ady

jh3ady/claude-time-check

번역 완료

이 mod 소개

Time Check

요일별로 설정한 시간대 안에서 프롬프트를 보내기 전에 시간을 확인하게 하는 Claude Code 플러그인입니다.

차단하지 않음: 프롬프트를 잃지 않고 보류하며, 옵션을 고르면 바로 보냅니다.
요일별 시간대: 기본값을 요일마다 덮어쓸 수 있고 자정을 넘는 시간대도 지원합니다.
세 가지 응답: 1 시간 후 알림, 이 시간대가 끝날 때까지 조용히 하기, 이 세션 동안 조용히 하기.

설치

Claude Code 플러그인 디렉터리 또는 이 저장소에서 설치합니다.

/plugin marketplace add jh3ady/claude-time-check
/plugin install time-check@claude-time-check

사용법

/time-check를 실행해 설정 창을 엽니다. 각 필드에는 쉼표로 구분한 HH:MM-HH:MM 시간대를 입력하고 Enter로 저장합니다.

default는 비워 둔 모든 요일에 적용됩니다. 예: 22:00-06:00, 13:00-14:00.
monday부터 sunday까지는 기본값을 덮어쓰고, off는 해당 요일을 끕니다.
자정을 넘는 시간대는 시작한 요일에 속합니다. friday 22:00-06:00은 토요일 06:00까지 적용됩니다.

Escape로 창을 닫으면 각 요일에 적용된 시간대를 출력합니다. 설정과 확인 기록은 로컬에 저장되고 모든 세션이 공유합니다.

이 플러그인은 얼리 액세스 상태인 Claude Code function hooks API를 사용합니다.

프롬프트와 hooks

플러그인이 제출하는 유일한 프롬프트는 사용자가 입력한 것입니다. 프롬프트가 보류되면 텍스트를 세션에 보관하고, 옵션을 고른 뒤 사용자의 말 그대로 변경 없이 제출합니다. 내용을 추가하지 않으며 다른 대화 데이터도 읽거나 보내지 않습니다. 붙여 넣은 이미지는 보류된 프롬프트와 함께 다시 보내지 않습니다.

전체개인정보 보호정책에 플러그인이 저장하는 데이터와 삭제 방법이 설명되어 있습니다.

각 hook의 동작:

prompt.submit: 활성 시간대 안에서 입력한 프롬프트를 보류하고 확인 창을 열며, 다른 모든 프롬프트（알림, 다른 플러그인, 자체 재제출）는 그대로 통과시킵니다.
command.run: session.start에서 등록한 /time-check에만 응답해 설정 창을 엽니다. 다른 명령은 변경 없이 전달합니다.
ui.close: 옵션을 고를 때까지 확인 창을 열어 두고 설정 창이 닫힐 때 적용된 시간대를 출력합니다. 다른 창은 그대로 전달합니다.
ui.render: 플러그인 자체의 두 창을 그립니다.

라이선스

MIT

설치

먼저 작성자의 README에서 marketplace와 플러그인 이름을 확인하세요. 저장소 구조에 따라 명령어가 달라질 수 있습니다.

claude plugin marketplace add jh3ady/claude-time-check
claude plugin install time-check

원문 / README

Time Check

A Claude Code plugin that asks you to acknowledge the time before your prompt is sent, inside time windows you configure for each day of the week.

Non-blocking: your prompt is held, not lost. It is sent as soon as you pick an option.
Per-day windows: one default, overridden day by day, with windows that may cross midnight.
Three answers: remind me in 1 hour, stay quiet until this window ends, or stay quiet for this session.

Installation

From the Claude Code plugin directory, or from this repository:

/plugin marketplace add jh3ady/claude-time-check
/plugin install time-check@claude-time-check

Usage

Run /time-check to open the settings pane. Each field takes comma-separated HH:MM-HH:MM windows and is saved with Enter:

default applies to every day left empty, for example 22:00-06:00, 13:00-14:00.
monday to sunday override the default; off disables a day.
A window crossing midnight belongs to the day it starts: friday 22:00-06:00 covers Saturday until 06:00.

Closing the pane with Escape prints the windows applied to each day. Settings and acknowledgements are stored locally and shared by every session.

The plugin uses the Claude Code function hooks API, which is in early access.

Prompts and hooks

The only prompt the plugin submits is the one you typed: when a prompt is held, its text is kept in the session and submitted unchanged, as your own words, once you pick an option. Nothing is added to it, and no other conversation data is read or sent. Pasted images are not resent with a held prompt.

The full privacy policy describes the data the plugin stores and how to delete it.

What each hook does:

prompt.submit: holds a prompt you typed inside an active window, opens the acknowledgement pane, and lets every other prompt through untouched (notifications, other plugins, its own resubmission).
command.run: answers only /time-check, registered at session.start, and opens the settings pane. Other commands are passed on unchanged.
ui.close: keeps the acknowledgement pane open until you pick an option, and prints the windows applied when the settings pane closes. Other panes are passed on unchanged.
ui.render: draws the plugin's own two panes.