nichiji

command module
v0.0.0-...-1a4df21 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 4, 2026 License: MIT Imports: 21 Imported by: 0

README

nichiji

CSV(日時,内容,メモ)で動く、コマンドラインの小さな予定表です。画面(TUI)は持たず、編集は好きなエディタで CSV を直接、確認とよく使う操作はコマンドで。

  • 1ファイル = 1人か1台。同じファイルの中で時間が重なる予定は入れられない
  • 予定はどれも、実際に動くための時間枠。時刻の決まっていない予定は、決めるまで促す
  • 曜日や祝日もただの CSV として一緒に並べる

入れ方

go install github.com/Mokkori-Tom/nichiji@latest

使い方

nichiji examples/曜日.csv tom.csv hana.csv   # 直近の予定(nichiji ls と同じ)。今日がいちばん下、済んだ予定は -all で
                                              # 前の日に済ませていない予定(LATE)があれば、確認するよう上に出す
nichiji ls -notime tom.csv                    # 時刻の決まっていない予定
nichiji add -f tom.csv '10/30 19:00-21:00 飲み会'
nichiji add -f tom.csv '12/24~26 9:00-17:00 研修'  # 何日から何日まで(毎日 9:00-17:00)
nichiji set -f tom.csv 飲み<Tab>              # 今の -d -text -m まで展開されるので、直して Enter
nichiji check tom.csv                         # エディタで書き換えたあとの確認
nichiji when                                  # 日時の書き方(今日を基準にどう読むか)。nichiji when '12/24 14:00' で1つだけ
nichiji uniq 休日予定.csv task.csv            # どれか1つにしか無い予定(日時と内容が同じなら同じ予定)
nichiji -h                                    # ほかのコマンド(find / set / done / rm / free / notify)

-f を省くと既定のファイル($NICHIJI_FILE か ~/.local/share/nichiji/nichiji.csv)を使う。

タブ補完(bash / fish)はコマンド、オプション、-match の内容、-at の日時に効く。nichiji set で1件に決まると、今の日時・内容・メモまで展開する。[done] [canceled] の予定は、set done rm に -all を付けたときだけ候補に出る。

echo 'eval "$(nichiji completion bash)"' >> ~/.bashrc
echo 'nichiji completion fish | source' >> ~/.config/fish/config.fish

展開した行は長くなるので、ble.sh や fish のように複数行を編集できるラインエディタで使うと直しやすい。 fish では候補の説明に今の日時とメモを出す。展開のために Tab と Enter のキー割り当てを使うので、ほかの設定でこの2つを割り当て直していると展開されない。

CSV

日時,内容,メモ
2026-10-22 14:00,歯医者,"保険証を持っていく
会計は現金のみ"
2026-10-22 13:00-15:30,研修
,いつか本を返す
w=日 10:00-11:00,教会
2026-12-24~2026-12-26 09:00-17:00,出張
2026-12-30~2027-01-03,帰省
  • 1列目 日時、2列目 内容、3列目 メモ(無くてよい)。CSV のルール(RFC 4180)どおり
  • 日時が空なら未定。繰り返しの書き方は nichiji -h、今日を基準にどう読むかは nichiji when
  • 何日から何日までは 開始~終了(両端の日を含む)。後ろに時刻を書くと毎日その時刻になる。入力では 12/24~26(同じ月)、12/30~1/3(年をまたぐ)、〜 も使える
  • # nichiji: label の行があるファイル(曜日など)は、ほかの予定がある日に添えるだけ
  • ファイルを並べ替えるなら、セルの中の改行を壊さないツールで(例: mlr --csv -N --allow-ragged-csv-input --pass-comments sort -f 1)

tmux に通知する

nichiji notify は、始まる前、終わりを過ぎても [reserved] [running] のまま(LATE)のとき、時刻の無い予定があるときに知らせる。前の日の LATE は、済ませる(nichiji done)か取り消す(nichiji set 語 -status canceled)まで1日1回知らせる。

-cmd が無ければ、tmux に繋いでいる画面の全部の下の行に10秒だけ出し、デスクトップやスマホの通知(termux-notification / notify-send / WSL なら Windows の通知)にも出す。どちらも無ければ端末に出してベルを鳴らす。

-cmd を付けると、そのコマンドに題と本文を引数で渡す。始まる10分前(-before で変更)に、tmux のステータスラインと履歴へ残す例が examples/ にある。

mkdir -p ~/bin ~/.config/systemd/user
install -m 755 examples/tmux-notify ~/bin/tmux-notify
install -m 644 examples/nichiji-notify.service ~/.config/systemd/user/
cat examples/tmux.conf >> ~/.tmux.conf && tmux source-file ~/.tmux.conf
systemctl --user daemon-reload
systemctl --user enable --now nichiji-notify.service
  • 通知は履歴を開く(prefix N)まで出たまま。ほかのコマンドも ~/bin/tmux-notify "題" で同じ履歴に残せる
  • -cmd の値は空白で区切られるので、パスに空白を入れない
  • サービスで動かすときは、nichiji-notify.service の PATH に tmux の場所を入れる
  • ログインしている間だけ動く

ライセンス

MIT

Documentation

The Go Gopher

There is no documentation for this package.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL