mcpField
C
cnote

cnote

github.com/mnhkahn生産性0129 回インストール3 日前に更新
リポジトリ

cnote について

cnoteは、OneDriveの「Notes」フォルダーにあるHTMLノートを管理するcyeamのスキルです。コマンドラインでノートを扱うユーザー向けに、一覧表示、読み取り、新規作成、追記に対応し、HTMLをMarkdownまたはテキストで表示できます。

主な機能

  1. 01ノートと更新日時の一覧表示
  2. 02ノート内容の読み取りと変換
  3. 03標準入力からのノート作成
  4. 04ノート内容の読み取りと追記

活用シーン

  1. 01OneDrive内のノートを確認
  2. 02HTMLノートをMarkdownに変換
  3. 03パイプ経由でノートを作成
  4. 04既存ノートに内容を追記

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/mnhkahn/cyeam-cli --skill cnote

インストール後、Claude Code で/cnoteを入力して読み込まれたか確認します。

詳細

クラウドノート

概要

OneDrive の Notes フォルダーで HTML ノートを管理します。事前に Microsoft アカウントへのログインが必要です（ログイン方法は cyeam-cli skill の「ログイン方法」を参照してください）。

cyeam cnote list                     # 列出所有笔记
cyeam cnote get "笔记标题"            # 查看（默认 markdown 格式）
cyeam cnote get "笔记标题" --format text
cyeam cnote new "笔记标题" < note.html
cyeam cnote append "笔记标题" < more.html

インストール

インストールの前に、以下のコマンドを確認してください。例では v1.1.4 に固定しており、latest には追従しません。ダウンロードするのは実行可能プログラムのアーカイブです。 CLI のインストールが必要な場合にのみ実行してください。コマンドを呼び出すたびに、インストールを繰り返す必要はありません。

macOS / Linux：検証後にユーザーディレクトリへインストール

Bash または Zsh で実行します。curl、tar、install と、shasum または sha256sum が必要です。 スクリプトは macOS / Linux の arm64 または x86_64 を自動的に選択し、それ以外のプラットフォームでは停止します。

(
  set -eu
  version='v1.1.4'
  case "$(uname -s)/$(uname -m)" in
    Darwin/arm64)
      asset='cyeam_Darwin_arm64.tar.gz'
      sha256='06b5af004ab4f0f05d5829ea6bd18b97c4449c262af7df14c67175f7d3cb29db' ;;
    Darwin/x86_64)
      asset='cyeam_Darwin_x86_64.tar.gz'
      sha256='107342bb9d2fa444b96155c468e71b8cc63e0f5ad0acc784698afe221548efa6' ;;
    Linux/aarch64|Linux/arm64)
      asset='cyeam_Linux_arm64.tar.gz'
      sha256='ed87697f3948bead67b585e9881c3bef20e8d2d903beb5b125587281a5091c5b' ;;
    Linux/x86_64)
      asset='cyeam_Linux_x86_64.tar.gz'
      sha256='873d6805fab8ab56540bb034aaf2f57f12eb672fcabd322ebe401e8250a5966d' ;;
    *) echo '不支持的平台，请查看固定版本的 Release。' >&2; exit 1 ;;
  esac
  workdir=$(mktemp -d)
  trap 'rm -rf "$workdir"' EXIT
  cd "$workdir"
  curl --fail --show-error --silent --location --proto '=https' --proto-redir '=https' \
    --output "$asset" "https://github.com/mnhkahn/cyeam-cli/releases/download/$version/$asset"
  printf '%s  %s\n' "$sha256" "$asset" > expected.sha256
  if command -v sha256sum >/dev/null 2>&1; then
    sha256sum -c expected.sha256
  else
    shasum -a 256 -c expected.sha256
  fi
  # set -e 确保下载或校验失败时，不会解压或安装。
  tar -xzf "$asset" cyeam
  mkdir -p "$HOME/.local/bin"
  install -m 0755 cyeam "$HOME/.local/bin/cyeam"
  CYEAM_CLI_NO_UPDATE_NOTIFIER=1 "$HOME/.local/bin/cyeam" --no-analytics version
)

一時ディレクトリと ~/.local/bin/cyeam（同名のプログラムがある場合は置き換えます）にのみ書き込みます。管理者権限は不要です。 システムディレクトリ、サービス、シェル設定は変更しません。現在のシェルで使用するには、次のようにします。

export PATH="$HOME/.local/bin:$PATH"

永続的に有効にするには、上記の行をシェル設定に追加してください。 v1.1.4 リリースページ と checksums.txt でチェックサムを確認できます。固定バージョンにアップグレードするときは、バージョン番号と対応する SHA-256 を両方確認して置き換える必要があります。 チェックサムはリリースファイルの整合性を確認するためのものであり、独立した署名やセキュリティ監査に相当するものではありません。

外部リクエストと権限の用途
  • インストール時のダウンロード：GitHub の固定 Release から選択したアーカイブのみをダウンロードします。GitHub によって、そのアセット CDN にリダイレクトされる場合があります。 ダウンロード後、文書に記載された固定 SHA-256 を検証してから、単一の cyeam ファイルを展開します。インストール時の確認では、統計情報と更新通知を無効にします。
  • Microsoft 認証：クラウド機能が必要な場合に限り cyeam login を実行します。 https://login.microsoftonline.com/consumers のデバイスコードフローでログインし、認証ページを開こうとします。 Files.ReadWrite（OneDrive ファイルの読み書き）、User.Read（アカウント情報の読み取り）、 offline_access（毎回ログインしなくて済むようにするための更新トークン）を要求します。ファイル権限は認証したアカウントの OneDrive ファイル全体に適用され、このスキルのフォルダーに限定されません。トークンはシステムのキーチェーンへの保存を優先し、利用できない場合は ~/.cyeam/token.json に保存します。
  • クラウドノート：https://graph.microsoft.com/v1.0 を通じて OneDrive の Notes/ フォルダーを読み書きします。 Microsoft からのファイルダウンロードは、同社のストレージドメインにリダイレクトされる場合があります。list/get はファイル情報または内容を読み取り、new は stdin の HTML をアップロードします（同名のファイルがある場合は置き換えます）。append は元の内容を読み取ってから、追記した全文をアップロードします。 これらの操作には、ユーザーが指定したノートの内容とタイトルが必要ですが、システム管理者権限は不要です。
  • 使用統計：デフォルトでは、コマンド名、CLI バージョン、システム情報、ランダムなインストール ID を https://us.i.posthog.com に送信します。サーバー側では接続元 IP から地域を特定する場合があります。コマンド引数、画像の内容、ログイン認証情報は送信しません。 ランダム ID は ~/.cyeam/analytics-id に保存されます。--no-analytics または CYEAM_CLI_NO_ANALYTICS=1 で無効にできます。
  • 更新通知：デフォルトでは、24 時間に最大 1 回 GitHub に最新バージョンを確認し、~/.cyeam/update-state.json にキャッシュします。通知によってプログラムが置き換えられることはありません。CYEAM_CLI_NO_UPDATE_NOTIFIER=1 で無効にできます。 cyeam update は明示的なアップグレードコマンドです。最新の Release をダウンロードして検証し、現在のプログラムを置き換えます。成功後、npx skills add による skills の同期も試みます。固定バージョンを維持する場合は実行せず、上記の手順で選択したバージョンをインストールしてください。

CLI の統計情報と更新通知を無効にするには（この機能自体によるネットワークリクエストには影響しません）、現在のシェルで次のように設定します。

export CYEAM_CLI_NO_ANALYTICS=1
export CYEAM_CLI_NO_UPDATE_NOTIFIER=1

コマンド

cyeam whoami                         查看登录状态（登录方式见 cyeam-cli skill）

cyeam cnote list                     列出笔记（显示文件名、修改时间、可点击链接）
cyeam cnote get <title>              读取笔记内容（默认 markdown 渲染）
cyeam cnote get <title> --format text
cyeam cnote new <title> < note.html  从 stdin 创建笔记
cyeam cnote append <title> < note.html

データストレージ

ノートは OneDrive の Notes/ フォルダーに保存され、各ノートは .html ファイルです。リストに webUrl がある場合は、クリック可能な「開く」リンクが表示されます。

注意事項

  • Microsoft アカウントへのログインが必要です。Device Code フローを使用します（ログイン方法は cyeam-cli skill を参照してください）。
  • ログイン後、トークンは自動的に更新されます（refresh_token を使用）。
  • 内容はプレーンな HTML です。get コマンドは内容を解析し、markdown/text に変換して表示します。
  • new と append は stdin から読み取るため、パイプに適しています：echo "<h1>hello</h1>" | cyeam cnote new test

コメント

Markdown 対応