sync - coscli

sync

coscli の sync グループコマンド一覧です。

Cosense のページとローカルファイルを同期します。

共通フラグ

-p, --project <name> — 対象プロジェクト (env: COS_PROJECT)

--dir <path> — 同期先のローカルディレクトリ (デフォルト: カレントディレクトリ)

--format=txt — 同期ファイル形式 (現在 txt のみ対応)

--all — プロジェクト内の全ページを対象にする

--dry-run — 実際の変更をスキップして差分を確認する

コマンド一覧

sync diff — Cosense とローカルの差分を表示する

sync pull — Cosense → ローカルにダウンロードする

sync push — ローカル → Cosense にアップロードする

基本的な使い方

code:bash

# 1. まず差分を確認する

cos sync diff "ページタイトル" --dir ./sync --project myproject

# 2. Cosense → ローカルに取得

cos sync pull "ページタイトル" --dir ./sync --project myproject

# 3. ローカルのファイルを編集後、Cosense に反映

cos sync push "ページタイトル" --dir ./sync --project myproject

# 全ページを対象にする場合

cos sync pull --all --dir ./sync --project myproject

競合時の対処 (exit 6)

cos sync push が exit 6 (楽観ロック競合) で失敗した場合:

code:bash

# 最新版を取得してマージ後に再 push

cos sync pull "ページタイトル" --dir ./sync --project myproject

cos sync push "ページタイトル" --dir ./sync --project myproject

ファイル形式

ローカルファイル名はページタイトルをファイルシステム安全な文字列に変換したものになります。

拡張子は --format に応じて .txt です。