/ui

sidebar_position: 1

ui

視覚的な Skill 管理のための Web ダッシュボードを起動します。

skillshare ui                  # フォアグラウンドで実行
skillshare ui start            # バックグラウンドサーバーを起動（既存があれば再利用）
skillshare ui stop             # バックグラウンドサーバーを停止

デフォルトブラウザで `http://127.0.0.1:19420` を開きます。

モード

| モード | 動作 | |------|------| | `skillshare ui`（デフォルト） | UI サーバーをフォアグラウンドで実行。`Ctrl+C` で停止 | | `skillshare ui start` | UI サーバーをバックグラウンドプロセスとして起動し、シェルの制御を返す。再度 `start` を実行した場合、既存のプロセスが正常であればそれを再利用 | | `skillshare ui stop` | `skillshare ui start` で起動したバックグラウンド UI サーバーを停止 |

使うタイミング

• Skill、Target、sync を視覚的な Web インターフェースで管理したい
• CLI フラグを覚えずに Skill を閲覧・インストールしたい
• 視覚的な検出結果レポート付きでセキュリティ監査を実行したい
• CLI に不慣れなチームメンバーとダッシュボードビューを共有したい

フラグ

| フラグ | デフォルト | 説明 | |------|---------|-------------| | `-p`, `--project` | | Project mode で実行（`.skillshare/` を使用） | | `-g`, `--global` | | グローバルモードで実行（`~/.config/skillshare/` を使用） | | `--port <port>` | `19420` | HTTP サーバーのポート | | `--host <host>` | `127.0.0.1` | バインドアドレス（Docker の場合は `0.0.0.0` を使用） | | `-b`, `--base-path <path>` | | リバースプロキシ用のサブパス（例: `/skillshare`） | | `--no-open` | `false` | ブラウザを自動的に開かない | | `--app` | `false` | 可能な場合、ダッシュボードをデスクトップ風の Chromium アプリウィンドウとして開く（`start` モードのみ） | | `--clear-cache` | | フォアグラウンド形式の場合: キャッシュされた UI アセットをクリアして終了。`start` と組み合わせた場合: キャッシュをクリアしてからバックグラウンドで起動 |

:::tip 自動検出 カレントディレクトリに `.skillshare/config.yaml` が存在する場合、ダッシュボードは自動的に Project mode で起動します。グローバルモードを強制するには `-g` を使用してください。 :::

例

# デフォルト: localhost:19420 でブラウザを開く（フォアグラウンド）
skillshare ui

# Project mode（.skillshare/ の Skill を管理）
skillshare ui -p

# カスタムポート
skillshare ui --port 8080

# Docker / リモートアクセス
skillshare ui --host 0.0.0.0 --no-open

# バックグラウンドで起動し、シェルに制御を戻す
skillshare ui start

# デスクトップ風のクロームレスアプリウィンドウとして起動
skillshare ui start --app

# バックグラウンドサーバーを停止（記憶されている host/port を使用）
skillshare ui stop

# キャッシュされた UI アセットをクリアしてからバックグラウンドで新規起動
skillshare ui start --clear-cache

ダッシュボードのページ

サイドバーはページをタスクごとにグループ化します: sync すること、管理しているもの、同期先、メンテナンス。名前の下の行にはモードとそのフォルダ（例: `Global · ~/.config/skillshare`）が表示されます。

一部のページは、対応が必要な場合にサイドバーに件数を表示します。この件数は、ダッシュボードのタブが開いている間、15 秒ごとに更新されます。

• **Sync**: sync によって適用される変更
• **Git Sync**: 未コミットのファイル、またはツリーがクリーンな場合はまだプッシュされていないコミット
• **Audit**: 直近のスキャンでブロックされた Skill と Agent（スキャンを実行した後に表示）

| ページ | 説明 | |------|-------------| | **Dashboard** | Skill、Agent、Extras、MCP サーバー、Plugin、Target の件数、および対応が必要な項目 | | **Sync** | 書き込む前に、Target ごとにすべての変更をプレビュー。含める項目を選択（Skills、Agents、Extras、MCP）。Target 内で編集されたファイルは、**Force** がオンでない限り保持される。Target にのみ存在する項目は、ここから Source に collect し戻せる。各 sync は最初に Target フォルダをバックアップする | | **Git Sync** | Source リポジトリのコミットとプッシュ、remote にまだないコミットのプッシュ、プルを実行。ページを開くと remote から fetch するため、**Pull** には remote にあるコミット数が表示される。プルはリポジトリのスコープ（`skills`、`agents`、`extras`、または `root`）が保持するものを sync する。詳細は [`pull`](/docs/reference/commands/pull) を参照。remote に新しいコミットがあるためにプッシュが拒否された場合、エラーに **Pull** が表示される。最初のプルが remote とマージできない場合、remote ブランチでローカルファイルを置き換える force pull を提案する | | **Hubs** | Skills ページから移動。**Browse** は hub をフィルタしてそこからインストール、**My hubs** はインストール済み Skill からインデックスを組み立て、検証してエクスポートする。[`hub`](/docs/reference/commands/hub) を参照 | | **Skills** / **Agents** | インストール済みの項目、**Updates** タブ、**Trash** タブ。Skills にはさらに、Target のコンテキストに Skill が追加するトークン数を見積もる **Analyze** タブがある。**Install** は GitHub を検索するか、URL やパスからインストールする。**+ New Skill** は作成ウィザードを開く。`disable-model-invocation: true` を持つ Skill は、一覧・タイル・詳細ページで **manual only** タグが付く。これは [`list`](/docs/reference/commands/list) で `M` キーが切り替えるのと同じ状態。Skill エディタでは、**Add field** が各フロントマターフィールドの説明を表示する。**Sync skills** / **Sync agents** はプレビューしてから、その種類だけをすべての Target に sync する。update、アンインストール、collect の後に表示される **Sync Now** からも同じダイアログが開く | | **Extras** | Skill と一緒に sync される rules、commands、その他のフォルダ | | **MCP** | サーバーごとに 1 行表示され、sync 先の Agent がトグルとして並ぶ。**サーバーを追加** は URL、コマンド、貼り付けたスニペット、またはファイルを受け付ける。**target からインポート** はインストール済みの Agent が既に持っているものを読み込む。各サーバーのメニューには **各 Agent に書き込まれる設定を表示** があり、未保存の編集を含む Agent ごとのネイティブ設定を表示する。コンフリクトでは **その Agent からインポート** か **ソースで上書き** を選べ、バックアップは復元前にプレビューできる。`pi-mcp-adapter` を使う Pi サーバーでは、サーバーのダイアログに **Direct tools** と、[`piOptions`](./mcp.md#pi-options) を JSON で受け付ける **その他の adapter 設定** の入力欄もある。**デフォルト** は `mcp.targets` と `mcp.directTools` を編集する。Sync ボックスの **Sync MCP** は保留中の変更を一覧表示し、MCP の設定ファイルだけを書き込み、それぞれのバックアップを保存する。 | | **Plugins** | Plugin ごとに 1 行表示され、その Agent がトグルとして並ぶ。行を展開すると、そのソースが対応する他の Agent も一覧され、いずれかにチェックを入れるとインストールのプレビューが表示される。行のメニューから sync、update、削除ができ、Skillshare がレビューしたローカルコピーを読み取り専用で閲覧する **View files** も開ける。[Manage plugins across tools](/docs/how-to/daily-tasks/sharing-plugins) を参照 | | **Targets** | ステータス付きの Target 一覧。**ターゲットを追加** では **別のアカウント** も選べます。すでに使っている Agent の 2 つ目の config フォルダで、書き込み先のプレビューが付きます。各 Target のページで include/exclude フィルタを編集し、ローカルのみの Skill を Source に collect し戻せる。一覧には各 Agent が受け取る MCP サーバー数も表示される。MCP 設定ファイルを持つ Target には **MCP** タブがあり、サーバーごとに 1 行で選ぶ。クリックするとすぐ保存され、**Sync all targets** ですべての Target の MCP ファイルに書き込まれる | | **Projects** | global mode のみ。global config が sync する project フォルダーで、[`projects`](/docs/reference/targets/configuration#projects) と [`mcp.projects`](./mcp.md#projects-in-the-dashboard) から一覧される。**プロジェクトを追加** はフォルダー、その target、sync する内容を指定する。各 project には **Skills** と **Agents** タブがあり、フィルター、プレビュー、書き込まれるフォルダーを表示する。**MCP** タブでは、そのフォルダー内で global サーバーをオフにしたり、その project 独自のサーバーを追加したりできる。**Sync project** はプレビューしてから、その project の skills、agents、MCP だけを sync する。すでに project フォルダーを指している Target は変換できる | | **Audit** | Skill と Agent のセキュリティスキャン。重大度別の検出結果を表示。**Rules** タブでは、カテゴリごとにすべてのルールを閲覧できる: ルールをオフにする、重大度を変更する、カテゴリ全体に重大度を適用する、スキャンプロファイル（`default`、`strict`、`permissive`）を選ぶ、カスタム `audit-rules.yaml` のエディタを開く、のいずれかができる | | **Settings** | タブ分け: **General**（Source パス、sync モード、外観）、**Backup**（スナップショットと復元）、**Log**（操作履歴）、**Health**（[`doctor`](/docs/reference/commands/doctor) と同じチェック）、**Extensions**（sync 時のファイル変換）、**Files**（`config.yaml`、`.skillignore`、`.agentignore` の直接編集） |

`/collect`、`/install`、`/search`、`/trash`、`/analyze`、`/backup`、`/log`、`/doctor` などの古いリンク