よくある質問
esa-cliに関するよくある質問と回答をまとめています。初めての方から上級者まで、段階的に学べるよう構成しています。
🚀 インストール関連
Section titled “🚀 インストール関連”Q: インストール時にエラーが発生しました
Section titled “Q: インストール時にエラーが発生しました”A: 以下のコマンドで再インストールを試してください：
brew uninstall esa-clibrew install shellme/esa-cliQ: バージョンアップはどうすればいいですか？
Section titled “Q: バージョンアップはどうすればいいですか？”A: Homebrewを使用している場合は、以下のコマンドで簡単にアップグレードできます：
通常のアップグレード:
brew upgrade esa-cliアップグレード後の確認:
esa-cli version特定のバージョンに固定したい場合:
# 例：v0.2.8に固定brew pin esa-cli# 固定解除brew unpin esa-cliQ: brew upgrade esa-cli で「Will not overwrite config.template」エラーが出ます
Section titled “Q: brew upgrade esa-cli で「Will not overwrite config.template」エラーが出ます”A: これは既存の設定ファイルが原因でHomebrewが上書きを拒否しているエラーです。以下の手順で解決できます：
- 既存の設定ファイルを削除
rm /opt/homebrew/etc/esa-cli/config.template- アップグレードを再実行
brew upgrade esa-cliQ: アップグレード後に古いバージョンが表示される場合
Section titled “Q: アップグレード後に古いバージョンが表示される場合”A: 以下の手順で確認してください：
- 現在インストールされているバージョンを確認
brew list --versions esa-cli- 最新のリリース情報を確認
brew info esa-cli- 必要に応じて強制アップデート
brew updatebrew upgrade esa-cli- キャッシュをクリア
brew cleanupQ: esa-cli コマンドが見つかりません
Section titled “Q: esa-cli コマンドが見つかりません”A: 以下の点を確認してください：
- パスが正しく設定されているか確認
echo $PATH-
/usr/local/binがパスに含まれているか確認 -
使用しているシェルに応じて、以下の設定ファイルにパスを追加：
bashの場合（~/.bashrc または ~/.bash_profile）:
export PATH="/usr/local/bin:$PATH"zshの場合（~/.zshrc または ~/.zprofile）:
export PATH="/usr/local/bin:$PATH"fishの場合（~/.config/fish/config.fish）:
set -gx PATH /usr/local/bin $PATH- 設定を反映
# bashの場合source ~/.bashrc # または source ~/.bash_profile
# zshの場合source ~/.zshrc # または source ~/.zprofile
# fishの場合source ~/.config/fish/config.fish⚙️ 初期設定
Section titled “⚙️ 初期設定”Q: アクセストークンが無効になりました
Section titled “Q: アクセストークンが無効になりました”A: 新しいトークンを生成し、esa-cli setup を再実行してください。
Q: 設定はどこに保存されますか？
Section titled “Q: 設定はどこに保存されますか？”A: 設定は ~/.esa-cli/config.yaml に保存されます。手動で編集することも可能です。
📖 基本的な使い方
Section titled “📖 基本的な使い方”Q: 記事の一覧を表示するには？
Section titled “Q: 記事の一覧を表示するには？”A: esa-cli list コマンドを使用します。デフォルトで最新10件が表示されます。
esa-cli listQ: 特定のカテゴリの記事だけを表示したい
Section titled “Q: 特定のカテゴリの記事だけを表示したい”A: -c または --category オプションを使用します。
esa-cli list -c 開発esa-cli list --category 開発Q: 自分が作成した記事だけを表示したい
Section titled “Q: 自分が作成した記事だけを表示したい”A: -u または --user オプションを使用します。
esa-cli list -u 自分のユーザー名esa-cli list --user 自分のユーザー名Q: 記事をダウンロードするには？
Section titled “Q: 記事をダウンロードするには？”A: esa-cli fetch <記事番号> で記事をMarkdownファイルとしてダウンロードできます。
# 特定の記事をダウンロードesa-cli fetch 123
# カテゴリの最新記事をダウンロードesa-cli fetch -c 開発 -l
# タグの最新記事をダウンロードesa-cli fetch -t API -lQ: 記事を更新するには？
Section titled “Q: 記事を更新するには？”A: ローカルで編集したMarkdownファイルを esa-cli update <ファイル名> で更新できます。
esa-cli update 123-記事タイトル.mdQ: 短縮形のオプション（-c, -t など）と長いオプション（—category, —tag など）の違いは？
Section titled “Q: 短縮形のオプション（-c, -t など）と長いオプション（—category, —tag など）の違いは？”A: 機能は同じです。短縮形は入力が楽で、長いオプションは可読性が高いです。どちらも使用できます。
Q: 複数のオプションを組み合わせることはできますか？
Section titled “Q: 複数のオプションを組み合わせることはできますか？”A: はい、複数のオプションを組み合わせて使用できます。
esa-cli list -c 開発 -t API -u 自分のユーザー名esa-cli list --category 開発 --tag API --user 自分のユーザー名🔧 高度な使い方
Section titled “🔧 高度な使い方”Q: 複数の記事を一度にカテゴリ移動できますか？
Section titled “Q: 複数の記事を一度にカテゴリ移動できますか？”A: はい、esa-cli move コマンドで一括移動が可能です。
esa-cli move --category 開発 --to ドキュメント --user 自分のユーザー名Q: 移動前に確認プロンプトをスキップできますか？
Section titled “Q: 移動前に確認プロンプトをスキップできますか？”A: はい、-f または --force オプションで確認をスキップできます。
esa-cli move --category 開発 --to ドキュメント --user 自分のユーザー名 --force注意
--force オプションは確認なしで実行されるため、慎重に使用してください。
Q: 移動時にメッセージを残すことはできますか？
Section titled “Q: 移動時にメッセージを残すことはできますか？”A: はい、-m または --message オプションで移動メッセージを指定できます。
esa-cli move --category 開発 --to ドキュメント --user 自分のユーザー名 --message リファクタリング完了Q: 更新時に「リモートの記事は更新されています」と警告が出るのはなぜ？
Section titled “Q: 更新時に「リモートの記事は更新されています」と警告が出るのはなぜ？”A: これは安全機能です。ローカルで編集を開始した後に他の人が記事を更新した場合、誤って上書きすることを防ぐために警告を表示します。
Q: 警告が出た場合はどうすればいいですか？
Section titled “Q: 警告が出た場合はどうすればいいですか？”A: 以下の選択肢があります：
y: 上書きして更新を続行N: キャンセルして手動で確認
Q: 記事の削除はできますか？
Section titled “Q: 記事の削除はできますか？”A: 現在のCLIでは記事の削除機能は実装されていません。削除が必要な場合は、esaのWebインターフェースを使用してください。
Q: 記事の本文を一括で修正できますか？
Section titled “Q: 記事の本文を一括で修正できますか？”A: はい、esa-cli update-all コマンドを使用して複数の記事を一括更新できます。
# 現在のディレクトリの全記事を一括更新esa-cli update-all
# 特定パターンの記事を一括更新esa-cli update-all "123-*.md" --message 一括更新Q: 複数の記事を一度にダウンロードできますか？
Section titled “Q: 複数の記事を一度にダウンロードできますか？”A: はい、esa-cli fetch-all コマンドで一括ダウンロードが可能です。
# カテゴリの記事を一括ダウンロードesa-cli fetch-all -c 開発
# タグの記事を一括ダウンロード（件数制限付き）esa-cli fetch-all -t API --limit 5🛠️ トラブルシューティング
Section titled “🛠️ トラブルシューティング”Q: 記事の更新が反映されません
Section titled “Q: 記事の更新が反映されません”A: 以下の点を確認してください：
- ファイル名が正しいか（記事番号-タイトル.md）
- Front Matterの形式が正しいか
- インターネット接続が安定しているか
Q: オプションが認識されないエラーが出ます
Section titled “Q: オプションが認識されないエラーが出ます”A: オプションの形式を確認してください。- または -- で始まる形式を使用します。
Q: 記事が見つからないエラーが出ます
Section titled “Q: 記事が見つからないエラーが出ます”A: 記事番号が正しいか、アクセストークンが有効か確認してください。
Q: 権限エラーが出ます
Section titled “Q: 権限エラーが出ます”A: アクセストークンに適切な権限（read/write）が設定されているか確認してください。
Q: ネットワークエラーが発生します
Section titled “Q: ネットワークエラーが発生します”A: 以下の点を確認してください：
- インターネット接続が安定しているか
- esaのサービスが正常に動作しているか
- ファイアウォールやプロキシの設定
📚 関連ドキュメント
Section titled “📚 関連ドキュメント”- はじめに - インストールと初期設定
- 初期設定と基本操作 - 基本的な使い方の詳細
- コマンド一覧 - 全コマンドの詳細説明
- トラブルシューティング - より詳細な問題解決ガイド