@fukuchang/taskchute-cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 fukuchang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,98 @@
+# @fukuchang/taskchute-cli
+
+[![npm version](https://img.shields.io/npm/v/@fukuchang/taskchute-cli.svg)](https://www.npmjs.com/package/@fukuchang/taskchute-cli)
+
+TaskChute (E2EE 暗号化されたタスク管理アプリ) のタスクをターミナルから操作するための CLI。
+
+## 必要なもの
+
+- Node.js 20 以上
+- TaskChute Web アプリで作成済みのアカウント
+- E2EE セットアップ (Web アプリの「Settings → データの暗号化」で passphrase を設定済み)
+
+> ⚠️ タスクデータは end-to-end 暗号化されているため、復号には passphrase が必須。
+> Web アプリで E2EE をセットアップしていない状態では CLI からタスクを操作できない。
+
+## Install
+
+```sh
+npm install -g @fukuchang/taskchute-cli
+# または pnpm を使うなら
+pnpm add -g @fukuchang/taskchute-cli
+```
+
+インストール後、`taskchute` コマンドが利用可能になる。
+
+```sh
+taskchute --help
+```
+
+## 環境変数
+
+CLI は Supabase に直接接続するため、接続情報を環境変数で渡す必要がある。
+
+| 変数名 | 必須 | 用途 |
+| --- | --- | --- |
+| `TASKCHUTE_SUPABASE_URL` | 必須 | Supabase プロジェクトの URL |
+| `TASKCHUTE_SUPABASE_PUBLISHABLE_KEY` | 必須 | Supabase の publishable (anon) key |
+| `TASKCHUTE_PASSPHRASE` | 任意 | E2EE passphrase。設定すれば対話プロンプトをスキップ。CI/自動化向け |
+
+`.zshrc` などに書いておくのが楽。
+
+```sh
+export TASKCHUTE_SUPABASE_URL="https://xxxxx.supabase.co"
+export TASKCHUTE_SUPABASE_PUBLISHABLE_KEY="eyJh..."
+```
+
+## Quick Start
+
+```sh
+# 1. 認証 (email + password)
+taskchute login
+
+# 2. E2EE unlock (passphrase を OS keyring に保存し、以降のコマンドを対話なしに走らせる)
+taskchute unlock
+
+# 3. タスク一覧 (デフォルトは今日)
+taskchute tasks list
+
+# 4. タスク追加
+taskchute tasks add "朝のメール処理" --duration 30
+
+# 5. タスク開始
+taskchute tasks start <taskId-or-index>
+
+# 6. 完了
+taskchute tasks done <taskId-or-index>
+```
+
+## コマンド一覧
+
+| Command | 説明 |
+| --- | --- |
+| `taskchute login` | email + password で Supabase にログインし、session を OS keyring に保存 |
+| `taskchute whoami` | 現在ログイン中のユーザーを表示 |
+| `taskchute logout` | ログアウト (keyring から session 削除) |
+| `taskchute unlock` | E2EE passphrase を keyring に保存し、以降のコマンドを対話なしに走らせる |
+| `taskchute lock` | keyring から passphrase を削除 (session は維持) |
+| `taskchute tasks list [--date YYYY-MM-DD]` | タスク一覧表示 |
+| `taskchute tasks add <title> [--duration <min>] [--date <date>]` | タスク追加 |
+| `taskchute tasks start <id>` | タスク開始 |
+| `taskchute tasks pause <id>` | タスク中断 |
+| `taskchute tasks done <id>` | タスク完了 |
+
+詳細オプションは `taskchute <command> --help` で確認。
+
+## セキュリティ
+
+- session token と passphrase は OS のセキュア keyring (macOS Keychain / Linux Secret Service / Windows Credential Manager) に保存される。
+- タスクの本文・ノート等は全てクライアント側で AES-GCM 暗号化された状態で Supabase に保存され、CLI/Web どちらからも passphrase を知らないと復号できない。
+- passphrase そのものはサーバには一切送信されない。
+
+## ソースコード
+
+[github.com/fukuchang/TaskChute](https://github.com/fukuchang/TaskChute) (packages/cli)
+
+## License
+
+MIT