Petodo

petodo-cli

ターミナルから Petodo の ToDo リストを操作できます。 MCP サーバーでもあるため、Claude Code、Claude Desktop、Cursor から同じリストを直接操作できます。

Petodo は、ToDo リストを持つデスクトップペットです。ネットワーク経由で同じリストにアクセスするため、操作しているマシンでアプリが実行中かどうかにかかわらず利用できます。

npx petodo-cli login
npx petodo-cli add "call Sam 2pm"

複数回使う場合は、きちんとインストールしてください。

npm install -g petodo-cli
petodo list

Node 18 以降が必要です。依存関係はありません。

サインイン

petodo login

短いコードが表示され、ブラウザーが開きます。承認する前に、画面に表示されたコードがターミナルのコードと一致していることを確認してください。これにより、他の人のサインイン試行があなたのアカウントに紐付くのを防げます。

トークンは、あなたのみが読み取れる ~/.petodo/config.json に書き込まれます。petodo logout を実行すると、トークンが取り消され、ファイルが削除されます。

日常的な使い方

petodo list [--all|--done] [--today|--tomorrow]
petodo add "call Sam 2pm"        times in the text are understood
petodo done <id>                 an id prefix, or part of the title, is enough
petodo undo <id>
petodo rm <id>
petodo edit <id> [--title "..."] [--due "3pm"] [--clear-due] [--today|--tomorrow]
petodo report                    what is overdue, due soon, and your streak
petodo whoami

ID は UUID で、petodo list には先頭の 8 文字が表示されます。入力する必要があるのはそれだけです。それでも曖昧な場合、コマンドは推測せず、その旨を知らせます。

$ petodo done bbbb
"bbbb" matches 2 tasks. Use more of the id.

時刻を表す語句は、あなたの時計に合わせてタイトルから読み取られます。 petodo add "call Sam 2pm" とすると、タスクが今日の午後 2 時に設定され、リマインダーも設定されます。上書きしたい場合にのみ --due を指定してください。

「繰り返し」を表す語句も同様です。

$ petodo add "gym every weekday at 6pm"
repeating  4f2a91cc  gym
           Every weekday at 6:00 PM
           first one 6:00 PM

繰り返しタスクは 1 日ずつ表示されます。petodo list では今日のタスクに ↻ が付き、その下にルールが表示されます。タスクに対して petodo done を実行するとその日の分が完了し、ルールに対して petodo rm を実行すると繰り返しが停止し、今後の日付分も取り除かれます。

アシスタントと使う

petodo mcp は、標準入力と標準出力で MCP サーバーを実行します。通常、自分で実行する必要はありません。一度登録するだけです。

petodo connect claude-code       # or claude-desktop, or cursor
petodo connect --print           # the config, to paste yourself

アシスタントは、タスクの一覧表示、追加、完了、編集、削除、要約ができるようになります。アシスタントによる操作はすべてあなた自身のアカウントで行われ、すぐにアプリに反映されます。

MCP ではなく HTTP を使いたいアシスタントには、そのアシスタント専用のキーを作成してください。

petodo keys create "Claude"
petodo keys list
petodo keys revoke <id>

キーからアクセスできるのはリストだけで、それ以外にはアクセスできません。メールアドレスの読み取り、別のキーの作成、デバイスの削除はできません。キーを取り消すと、そのアシスタントだけがアクセスできなくなります。

環境変数

変数	説明
PETODO_TOKEN	サインイン済みのトークンの代わりに、このコマンドでのみこのトークンを使用します。
PETODO_ENDPOINT	別の API を指定します。デフォルトは https://app.petodoapp.com/api です。
PETODO_HOME	設定ファイルの保存場所です。デフォルトは ~/.petodo です。

環境変数は常に保存済みの設定より優先されるため、一時的な上書きはそのコマンドに限られます。

ライセンス

MIT。