GEO Wiki Pro はコマンドラインツール `geo` を提供し、知識ベースのドキュメント、カテゴリ、タグ、ユーザーなどの管理を行います。 ## インストール ### 環境要件 - Node.js >= 18 - npm >= 9 ### バージョン確認 インストール前に現在のインストール状況とバージョン情報を確認します： ```bash geo --version ``` - `command not found` と表示された場合：未インストールです。下記のインストール手順に進んでください - バージョン番号が表示された場合：最新バージョンと比較し、更新が必要かどうかを判断します > Agent はユーザーに案内します："現在インストールされているのは X.X.X で、最新バージョンは X.X.X です。更新しますか？" ユーザーの確認後に操作します。 ### バージョン更新 旧バージョンを更新する場合は、アンインストールしてから再インストールします（`npm uninstall -g` は `geowiki-cli` のみアンインストールし、他のグローバルパッケージには影響しません）： ```bash npm uninstall -g geowiki-cli ``` アンインストールの確認： ```bash geo --version # command not found と表示されれば、アンインストール完了 ``` > 注意：権限エラーが発生した場合は、`sudo npm uninstall -g geowiki-cli` を使用してください。 ### Node.js のインストール（未インストールの場合） GEO Wiki CLI は Node.js に依存しています。システムに `node` と `npm` コマンドがない場合は、以下の方法でインストールしてください： | プラットフォーム | インストールコマンド | 説明 | |:----:|---------|------| | 🍎 macOS | `brew install node` | 推奨；または nodejs.org から `.pkg` をダウンロード | | 🐧 Ubuntu/Debian | `sudo apt install nodejs npm` | | | 🐧 Fedora | `sudo dnf install nodejs npm` | | | 🪟 Windows | `winget install OpenJS.NodeJS.LTS` | 推奨；または nodejs.org から `.msi` をダウンロード | ```bash # インストール後の確認 node --version npm --version ``` ### グローバルインストール ```bash npm install -g geowiki-cli ``` インストールの確認： ```bash geo --version # 期待出力: geowiki-cli v1.0.7+ geo --help ``` ### 権限の問題 権限エラーが発生した場合： ```bash # 方法1：sudo を使用 sudo npm install -g geowiki-cli # 方法2：npm グローバルディレクトリを変更 mkdir ~/.npm-global npm config set prefix '~/.npm-global' export PATH=~/.npm-global/bin:$PATH npm install -g geowiki-cli ``` ## ログイン ### Token ログイン（推奨） ```bash geo login --url https://geowiki.pro --token geo_xxxxx ``` | パラメータ | 短縮形 | 説明 | 必須 | |------|------|------|------| | `--url` | `-u` | サーバーアドレス | はい | | `--token` | `-t` | API Token | はい | Token ログインは CAPTCHA 不要で、有効期間は90日です。管理パネルの「設定 -> API Token」で生成します。 ## ログイン状態 ```bash geo status # 現在の接続状態を確認 geo logout # ローカル認証情報をクリアしてログアウト ``` ログイン成功後、Token は `~/.geowiki/config.json` に自動保存され、以降のコマンドは自動的に認証情報を携带します。 ## よくある質問 **Q: インストール後に `geo` コマンドが見つからない？** npm グローバル bin ディレクトリがシステム PATH にあることを確認してください。`npm config get prefix` でグローバルディレクトリのパスを確認できます。 **Q: 以前インストールした旧バージョンが新しいバージョンと競合する？** まず `npm uninstall -g geowiki-cli` で旧バージョンをアンインストールしてから、最新バージョンを再インストールしてください。 **Q: Token の有効期限が切れた場合は？** 管理パネルの「設定 -> API Token」で新しい Token を生成し、`geo login --url ... --token <新Token>` で再ログインしてください。 **Q: 現在ログインしているユーザーを確認する方法は？** `geo status` を実行して、現在のサーバー接続情報とユーザー情報を確認できます。 ## 次のステップ - [CLI クイックリファレンス](/docs/cli-quick-reference) -- よく使うコマンドを素早くマスター - [CLI コマンドリファレンス](/docs/cli-reference) -- 全コマンドのパラメータ詳細 - [GEO Wiki Agent Skill 使用ガイド](/docs/agent-skill) -- AI Agent インテグレーションモードとワークフロー