はじめかた

ログインする

kichijitsu は Google カレンダーのクライアントで、予定そのものは Google に置いたまま、表示と編集だけを引き受ける。したがって最初にすることは Google アカウントの連携だ。ユーザー名やパスワードを kichijitsu に登録する手順は無い ―― 認証はすべて Google 側で行う。

1. 「Google 連携」を押す

   アプリを開くと、上部ツールバーの右側に「Google 連携」ボタンが出ている(連携済みのアカウントが1件も無い間だけ表示される)。スマホのような狭い画面では、右端の「⋯」メニューの中にある。押すと Google の同意画面へ移動する。

2. 同意画面で権限を許可する

   kichijitsu が求めるのは次の権限だけ。カレンダーのフル権限 (calendar) は要求しない。

   スコープ	必須	何に使うか
   openid / email	必須	どのアカウントとしてログインしているかを識別する。設定画面に出る メールアドレスもこれ。
   calendar.events	必須	予定の読み取りと書き込み。表示だけでなく、ドラッグでの移動・作成・削除・RSVP 返信をそのまま Google カレンダーへ反映するために要る。
   calendar.calendarlist.readonly	必須	カレンダーの一覧を読む。どのカレンダーを表示するか選ぶ画面がこれで作られる。
   tasks	任意	Google ToDo リストの読み書き。カレンダー上にタスクを並べ、チェックで完了に するために使う。外してもカレンダーは通常どおり動く。

3. カレンダーが表示される

   許可するとアプリへ戻り、そのアカウントのメインカレンダー (primary) だけが選ばれた状態で予定が並ぶ。他のカレンダーは自分で選んで足す (表示するカレンダーを選ぶ)。

tasks だけを外した場合と、タスク対応より前に連携したアカウントは、予定は 普通に見えるがタスクだけが出ない。設定 (歯車) の「アカウント」に「タスクを表示するには 再連携が必要です」というヒントと「再連携」ボタンが出るので、そこから同じアカウントを 選び直せばよい。

公式インスタンスは招待制

kichijitsu.love-rox.cc は招待制で、許可リストに載っているメールアドレス だけが連携できる。載っていないアドレスは、Google の同意画面まで進んで許可しても 登録されずにトップへ戻される (?auth_error=not_invited)。このとき Google のトークンはサーバーに一切保存されない。自分のために立てたい場合は セルフホスト手順 を参照。

ログイン状態はどれだけ続くか

ログインすると sid という cookie が発行され、30 日間ログイン状態が保たれる。期限が切れたり cookie を消したりした場合は、もう一度「Google 連携」から入り直せばよい ―― 同じアカウントで戻れば、元のカレンダー選択もそのまま復元される。

複数の Google アカウントを足す

仕事用と個人用のように複数の Google アカウントを持っている場合、それらを1つの画面にまとめられる。最初にログインした アカウントがオーナーになり、あとから足したものは接続アカウントとして同じ束 (プロファイル) にぶら下がる。予定は束の中で横並びに表示され、左ペインではアカウントごとに セクションが分かれる。

1. 設定を開く

   ツールバー右側の歯車「設定」を押す。狭い画面では「⋯」メニューの「設定」。

2. 「+ アカウントを追加」を押す

   「アカウント」セクションの一番下にある。押すと Google の同意画面へ移動するので、足したいアカウントを選んで許可する。求める権限は最初の ログインと同じ。

3. 左ペインにセクションが増える

   戻ってくると、左ペイン「カレンダー」にそのアカウントのセクションが増え、メイン カレンダーが選ばれた状態で予定が流れ込む。追加のときは今のログインがそのまま 引き継がれる (ログインし直しにはならない)。

連携を解除すると何が消えるか

設定の「アカウント」で、各アカウントの下にある「連携解除」を押す (確認が1段入る)。何が起きるかは、対象がどちらかで変わる。

• 接続アカウントを解除したとき ―― そのアカウントだけが外れる。Google 側のトークンを失効させ、サーバーの同期状態と登録を消し、このブラウザに溜まっていた そのアカウントの予定・終日予定・タスクも消える。他のアカウントには影響しない。
• オーナーアカウントを解除したとき ―― 束ごと全部の解除に格上げされる。ぶら下がっている接続アカウントも同時に外れる。 「誰の束か分からない状態」を作らないための安全側の扱いで、接続アカウントの1つが 勝手にオーナーに昇格することはない。
• アカウントが1つも残らなくなったとき ―― セッションが破棄されてログアウト状態に戻る。あわせて GitHub 連携・MCP トークン・ 作業実績の記録もサーバーから削除される。

トークンを失効させるので、Google アカウント側の「サードパーティ製アプリとサービス」 からも kichijitsu は消える。ただし予定データの削除は解除の操作をした ブラウザの中だけで起きる ―― 同じアカウントを別の端末やブラウザでも開いていた 場合、そちらに残っているコピーはこの操作では消えない。どこに何が保存されているかは データの扱い にまとめてある。

画面の見かた

画面は「上部ツールバー」「左ペイン (カレンダー)」「中央のカレンダー」「右ペイン (実績)」の4つでできている。左右のペインはツールバーのボタンで開け閉めする。

上部ツールバー

• ← / 今日 / → ―― 表示している期間を前後に動かす。「今日」で戻る。
• 検索 (虫眼鏡) ―― 予定をキーワードで探す。
• 表示切替 ―― 広い画面では「週 / 月」、スマホのような狭い画面では 「1日 / 3日 / 月」。
• 時間軸の高さ ―― 1時間ぶんの高さを変えて、1画面に入る時間帯を増減する。 時間軸を持たない月表示では出ない。
• 日付ラベル ―― いま見ている年月 (日)。狭い画面では短く縮む。
• 設定 (歯車) ―― 下記の設定モーダルを開く。連携アカウントが1件以上ある ときだけ出る。
• 同期 ―― Google から取り直す。ふだんは自動で走るので押さなくてよい。
• カレンダー ―― 左ペインの開閉。
• 実績 ―― 右ペインの開閉。GitHub と連携しているときだけ出る。
• 走行中タイマー ―― 作業時間の計測が動いている間だけ出て、そこから 止められる。
• ? ―― キーボードショートカット一覧。? キーでも開く。
• オフライン ―― サーバーに繋がらない間に出る。表示しているのはこの端末に 保存済みのデータで、閲覧は続けられる。

スマホ幅では、右端の「⋯」に 時間軸の高さ / カレンダー / 実績 / 設定 / 同期 / キーボードショートカット / プライバシー・規約 が畳まれる。常に出ているのは ロゴ・前後ナビ・検索・表示切替・日付・オフライン表示・走行中タイマーと「⋯」だけ。

左ペイン「カレンダー」

上から順に、こう並ぶ。

• ミニ月カレンダー ―― 日付をクリックするとその日へ飛ぶ。
• 表示 ―― 「不参加の予定を表示」の ON/OFF。OFF にするとサブ項目「自分が主催の予定は残す」が現れる。
• アカウントごとのセクション ―― メールアドレスの見出しの下に 「マイカレンダー」「他のカレンダー」「タスクリスト」。見出しはクリックで折りたためる。
• GitHub ―― 連携状態の表示と、実績オーバーレイ / CI・Actions 実行の表示 ON/OFF、作業キュー (右ペイン) と時間記録レポートへの入口。
• フッター ―― プライバシーと規約へのリンク。常に最下部に見えている。

中央のカレンダー

週 (または1日・3日) のタイムラインか、月表示のグリッド。ここで予定をドラッグして 動かしたり、空き時間をドラッグして新しい予定を作ったりする。操作の詳細は 予定の扱い にまとめてある。

右ペイン「実績」

GitHub と連携しているときだけ開ける。実行中のタイマー・作業キュー (issue や PR)・ 作業実績の記録と履歴が入っている。詳しくは GitHub 連携と実績記録 を参照。

設定 (歯車) からできること

モーダルの一番下には、プライバシー・規約へのリンクと、いま見ているビルド番号、 「キャッシュを削除して再読み込み」、「予定を再同期」がこの順で並ぶ。あとの2つは 困ったときの脱出口で、使い分けはこうなる。

• キャッシュを削除して再読み込み ―― 更新したはずなのに表示が古いまま のときに使う。消えるのは画面を組み立てるファイルのキャッシュだけで、予定データ・ 連携アカウント・設定は消えない。
• 予定を再同期 ―― 予定の中身が Google と食い違っているときに使う。表示中のカレンダーの予定と取得済みのタスクを全件取り 直して手元の複製を作り直すだけで、こちらも連携アカウント・設定は消えない (詳しくはデスクトップ版と PWA の「更新されないとき」)。

表示するカレンダーを選ぶ

左ペイン「カレンダー」の各行にある枡 (チェック) を押すと、そのカレンダーの表示が 切り替わる。カレンダーは自動で2つに分けられる。

• マイカレンダー ―― 自分が所有しているカレンダー。
• 他のカレンダー ―― 祝日、購読しているもの、同僚から共有されたものなど。

アカウントを連携した直後はメインカレンダー (primary) だけが選ばれている。他は必要なぶんだけ自分で ON にする。空のグループは見出しごと 出ないので、「他のカレンダー」が見当たらない場合はそのアカウントに該当するものが無い。

• ON にした瞬間、そのカレンダーだけを取りに行くので、待たずに予定が 並ぶ。
• OFF にしても取り込んだデータは消さない。表示から隠すだけなので、 もう一度 ON にすれば即座に元通りになる。データが実際に消えるのは、アカウントの 連携を解除したときだけ。
• カレンダーの選択はサーバーにも保存される。別の端末で開いても同じ カレンダーが選ばれた状態になる。

なお、タスクリストを非表示にしても取得自体は続く (再度 ON にしたときすぐ出るようにするため)。表示から外したいだけなら枡を OFF にすれば足りる。

次に読むもの

ここまでで、自分の予定が画面に並ぶところまで来た。次は 予定の扱い ―― 予定の作成・編集、参加可否 (RSVP) の返信、不在や勤務場所、キーボード ショートカットまで、日々の操作をまとめてある。

そのあとは、必要になったものから読めばよい。

• GitHub 連携と実績記録 ―― issue や PR を作業キューに載せ、かけた時間を記録する。
• カレンダーブロック ―― 別のカレンダーへ予定を自動でミラーして多重予約を防ぐ。
• デスクトップ版と PWA ―― ブラウザ以外での使いかた。
• データの扱い ―― 予定・認可情報・UI 設定がそれぞれどこに保存されるか。
• MCP 接続ガイド ―― Claude などのエージェントに予定を読み書きさせる。