dropnote

dropnote

テキストの一部をちょっとしたメモに残したいときがあります。ターミナルからコピーした1行、まとまりきっていない考え、ウィンドウを切り替える間に失いたくないスニペットなどです。dropnote は、その小さな受け渡しだけを行います。短いプレーンテキストの断片を受け取り、ローカルの noglow アプリを起動して、noglow デスクトップメモのターゲットスロット（スロットはアプリ内の設定で選択します）に書き込みます。

テキストがコマンドライン文字列として渡されることはありません。 dropnote はテキストを UTF-8 でバイト単位そのまま、一意の名前を付けた一時ファイル（OS の一時ディレクトリ内の noglow-drop-<unique>.txt）に書き込み、--drop-file <path> という単一の引数を指定してアプリを起動します。argv に含まれるのはパスだけなので、改行、引用符、$、バッククォートはすべて入力どおりに保持され、断片そのものがプロセス一覧に表示されることもありません。起動処理は結果を待たずに終了します。dropnote はアプリプロセスの起動直後に成功を報告し、一時ファイルはそのまま残します。ファイルの読み込みと削除はアプリが行います。

断片の長さは1500文字までです。text が存在しない場合、文字列でない場合、空の場合、長さの上限を超えている場合は、いずれも固定メッセージのエラーになります。一時ファイルを書き込めない場合やバイナリを起動できない場合も同様です。

起動するバイナリは、決められた順序で解決されます。NOGLOW_BIN 環境変数が設定されていて空でない場合はその値を使用し、それ以外の場合はプラットフォームのデフォルト値を使用します。macOS では /Applications/noglow.app/Contents/MacOS/noglow、Windows では %LOCALAPPDATA%\noglow\noglow.exe です。Linux では名前 noglow をそのまま使い、PATH を通じて解決します。drop を機能させるには noglow デスクトップアプリがインストールされている必要があります。インストールされていない場合、起動エラーには試行したパスが記載され、NOGLOW_BIN を指定するよう案内されます。

成功すると、drop は dropped（true）、characters（断片の長さ）、tempFile（一時ファイルのパス）、binary（起動した解決済みバイナリ）をこの順で返します。

CLI

npx @reneturcios/dropnote drop '{"text":"a fragment to keep"}'
npx @reneturcios/dropnote --version

drop コマンドは、引数オブジェクト全体を1つの JSON 文字列として受け取り、結果を JSON として出力します。

{
  "dropped": true,
  "characters": 18,
  "tempFile": "/tmp/noglow-drop-3f2a1c9e-4b7d-8e5a-9c0d-1a2b3c4d5e6f.txt",
  "binary": "noglow"
}

終了コード：成功時は 0、実行時エラー（解析できない JSON 引数や drop の失敗を含む）時は 1、使用方法のエラー時は 2 です。

MCP サーバー

npx -y @reneturcios/dropnote mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "dropnote": {
      "command": "npx",
      "args": ["-y", "@reneturcios/dropnote", "mcp"]
    }
  }
}

ツール

• drop — ローカルの noglow アプリを使って、短いテキストの断片（最大1500文字）を noglow メモのターゲットスロットに書き込みます。明示的なユーザーリクエストがあった場合にのみ実行されます。

  • text（文字列、必須）— 書き込む断片。改行と書式は保持されます。

  {dropped, characters, tempFile, binary} を返します。 エラーは、次の固定メッセージのいずれかを含むエラー結果として返されます：text is required、text must not be empty、text exceeds the 1500-character limit (got N)、failed to write drop file: <message>、または failed to launch noglow binary at <path>: <message> (set NOGLOW_BIN to override the binary path)。

Docker

docker run -i ghcr.io/cloudcorprecords/dropnote
docker run --rm ghcr.io/cloudcorprecords/dropnote drop '{"text":"a fragment to keep"}'

コンテナ内で drop を実行すると、コンテナ内の noglow バイナリが起動する点に注意してください。コンテナ内で使用できるバイナリを NOGLOW_BIN に指定するか、ローカルへのインストールをおすすめします。

開発

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake executor plus a stand-in script; no real app)
npm run dev     # run the CLI from source

ライセンス

MIT — Copyright (c) 2026 Rene Turcios