コマンドラインで PinMark のデスクトップメモを自動化

pinmark コマンドラインツールは、Mac のデスクトップに置いたメモをスクリプトから安定して扱えるようにします。データベースを直接読むことも、画面を奪うこともありません。

ローカル優先の設計。 コマンドはローカル IPC 経由で PinMark アプリに渡されます。書き込み操作は、アプリ内の操作とまったく同じ検証と Pro の境界に従います。

コマンドをインストール

設定 → 一般 → コマンドラインを開き、「インストール」を選びます。続いて、コマンドから起動中のアプリまでの接続全体を確認します：

pinmark doctor

メモ操作のすべて

Markdown、テンプレート、画像ファイル、クリップボードからメモを作成し、色と用紙を選べます。追記、更新、ゴミ箱へ移動、復元、デスクトップへの固定と解除、オープンにも対応。一覧と検索はページ送りと絞り込みができ、ゴミ箱内のメモも含めてどのメモでも読み取れます。

printf '# Release checklist\n- [ ] Verify build' | pinmark create --from-file - pinmark templates pinmark create --template <template-id> --paper lined pinmark search "release" --limit 20 --offset 20 pinmark show <note-id> --format markdown pinmark append <note-id> --from-file - pinmark open <note-id>

信頼できる自動化のために

デフォルトで JSON を出力し、スクリプトから安定して扱えます。不正なオプションは送信前に、明確な終了コードでエラーになります。
PinMark を最前面に出すのは open と --open だけで、ほかのコマンドはフォーカスを奪わずにバックグラウンドでメモを更新します。
削除はゴミ箱への移動なので、復元できます。
pinmark doctor がどの段階で失敗しているか、どう直せばよいかを示します。

AI クライアントと連携

お使いのツールが MCP に対応しているなら、CLI 呼び出しを自分で組み立てず、ローカルの MCP サーバーを使ってください。