https://github.com/imwebme/imweb-ai-toolkit
Public AI toolkit for installing and using imweb CLI with Codex, Claude, and Cursor.
https://github.com/imwebme/imweb-ai-toolkit
ai-toolkit claude codex cursor imweb imweb-cli
Last synced: 5 days ago
JSON representation
Public AI toolkit for installing and using imweb CLI with Codex, Claude, and Cursor.
- Host: GitHub
- URL: https://github.com/imwebme/imweb-ai-toolkit
- Owner: imwebme
- License: apache-2.0
- Created: 2026-04-24T08:41:34.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-05-22T07:36:02.000Z (12 days ago)
- Last Synced: 2026-05-22T15:29:27.657Z (12 days ago)
- Topics: ai-toolkit, claude, codex, cursor, imweb, imweb-cli
- Language: JavaScript
- Homepage: https://aitoolkit.imweb.me/
- Size: 313 KB
- Stars: 35
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.ja.md
- License: LICENSE
Awesome Lists containing this project
README
# imweb-ai-toolkit
[英語](README.md) | [韓国語](README.ko.md) | [中国語](README.zh-CN.md)
`imweb-ai-toolkit` は `imweb` CLI をインストールし、対応する AI coding tool に接続します。このリポジトリは、ユーザーが CLI の配布構造を意識せずに始められるように、skill asset、surface metadata、サンプル、bootstrap script を提供します。
```mermaid
flowchart LR
Toolkit["imweb-ai-toolkit"] --> CLI["imweb-cli"]
Toolkit --> Codex["Codex"]
Toolkit --> Claude["Claude"]
Toolkit --> Cursor["Cursor"]
Codex --> CLI
Claude --> CLI
Cursor --> CLI
```
## 含まれるもの
- Codex、Claude、Cursor、MCP reference wiring のための `plugin.json`、marketplace metadata、surface metadata
- Claude Desktop Cowork がユーザーの host `imweb` CLI と auth state を再利用するための `bin/imweb-mcp.mjs` local MCP bridge
- `commands/imweb.md`: Claude plugin surface 向けの短い `/imweb` slash-command entrypoint
- `skills/imweb/`: `imweb` skill bundle と bundle-local docs
- `install/`: CLI、skill、plugin setup のための bootstrap/installer script
- `docs/`: 公開利用、統合、support matrix のドキュメント
- `examples/`: sample workflow と fixture
## インストール
- Claude Code では、Claude Code のチャットで次の 2 行を実行します。
```text
/plugin marketplace add imwebme/imweb-ai-toolkit
/plugin install imweb-ai-toolkit@imweb-ai-toolkit
```
- Codex では marketplace を登録し、Plugins UI から `imweb-ai-toolkit` を追加します。
```bash
codex plugin marketplace add imwebme/imweb-ai-toolkit --ref main
```
- Claude Desktop Cowork では、Cowork task 内で Claude に次の依頼を送ります。
```text
imwebツールパッケージをインストールして:
npx -y github:imwebme/imweb-ai-toolkit --tool claude-cowork
imweb-ai-toolkit.plugin と imweb.skill を保存できるように提示して。
```
- Claude Desktop chat local MCP では、one-click MCPB bundle を作成します。
```bash
npx -y github:imwebme/imweb-ai-toolkit --tool claude-desktop
```
- AI coding agent に Codex と Claude Code のローカルセットアップを任せる場合は、次の 1 行を使います。
```bash
npx -y github:imwebme/imweb-ai-toolkit --tool both
```
インストール後の動作は次のとおりです。
- Local plugin installer は、デフォルトで公式 `imweb` CLI をインストールまたは更新します。
- `--tool claude-desktop` は Claude Desktop local MCP bundle である `imweb-ai-toolkit.mcpb` を作成します。Claude Desktop で開いて Install をクリックすると、bundle 内の MCP bridge が初回利用時に CLI のインストール/更新を管理します。
- `--tool claude-cowork` は `imweb-ai-toolkit.plugin` と `imweb.skill` を作成します。提示された plugin/skill card を承認したら、次のような自然言語の業務依頼で開始します。
```text
imwebツールで最近の注文に不審な取引がないか調査して。
```
```text
imwebツールで訪問者が多い商品トップ5を取得し、可能な範囲で詳細ページを点検して。
```
- `imwebツール`、`imwebツール群`、`imwebツールキット` のような短い呼び方も同じ imweb entrypoint として扱います。
- 現在の Claude Desktop Cowork build では、skill が有効でも task 開始前に `/imweb` のような slash-form text が拒否されることがあります。その場合は自然言語の依頼を使います。
- Plugin には Claude plugin surface 向けの `/imweb` slash entrypoint と、対応 host が露出する local `imweb-cli` MCP bridge が含まれます。
- Claude Desktop が imweb tool の権限を求めた場合は `Allow for this task` をクリックします。
- Host CLI のログインが必要な場合は Claude がブラウザログインフローを開始できます。ユーザーはブラウザで imweb ログインを完了するだけで、Claude が auth を再確認して元の依頼を続行します。
- 訪問者数/traffic 順の商品ランキングのように要求された指標が CLI にない場合、Claude は制限を説明し、商品一覧、商品詳細、レビュー、サイト情報、最近の注文など利用可能な read-only 確認に進みます。
- Skill package は同じ imweb 手順を custom Skill fallback として提供します。
## その他のインストール方法
`imweb` CLI binary だけがない場合は、次を実行します。
```bash
npx -y github:imwebme/imweb-ai-toolkit --tool cli
```
対象ツールが plugin をサポートしない場合は、標準 Agent Skill を直接インストールします。
```bash
npx skills add imwebme/imweb-ai-toolkit --skill imweb --copy -y --agent claude-code codex
```
すべての installer flag、検証手順、manual clone fallback は [docs/ai-agent-installation.md](docs/ai-agent-installation.md) を参照してください。高度なローカル設定や固定バージョンのテストは [docs/skill-installation-and-usage.md](docs/skill-installation-and-usage.md) を参照してください。
## アンインストール
Codex と Claude Code のローカル設定を削除するには、次を実行します。
```bash
npx -y github:imwebme/imweb-ai-toolkit --uninstall --tool both
```
生成されたローカル package artifact と installer 管理下の CLI までまとめて削除するには、次を実行します。
```bash
npx -y github:imwebme/imweb-ai-toolkit --uninstall --tool all
```
アンインストールでは toolkit plugin、marketplace、コピー済み skill、toolkit 所有の plugin cache/data/log、生成された `.plugin`/`.skill`/`.mcpb` artifact を削除します。CLI は installer 管理下の場所にある場合だけ削除し、imweb のログイン/auth データは残します。`imweb` CLI を残す場合は `--keep-cli` を追加します。
## 最初に読むもの
1. [docs/ai-agent-installation.md](docs/ai-agent-installation.md)
2. [docs/cowork-ask-claude-install.md](docs/cowork-ask-claude-install.md)
3. [docs/skill-installation-and-usage.md](docs/skill-installation-and-usage.md)
4. [docs/cli-toolkit-integration.md](docs/cli-toolkit-integration.md)
5. [docs/surface-support-matrix.md](docs/surface-support-matrix.md)
6. [skills/imweb/SKILL.md](skills/imweb/SKILL.md)
## サポート範囲
Codex App/CLI、Claude Code、Claude Desktop Cowork は主要な plugin 対応 surface です。Cursor は限定的/手動接続 surface として文書化されています。正式な support detail は [docs/surface-support-matrix.md](docs/surface-support-matrix.md) を参照してください。
## ライセンス
このリポジトリの toolkit asset は [Apache-2.0](LICENSE) でライセンスされています。
Imweb の商標と brand asset は Apache-2.0 ではライセンスされません。詳細は [TRADEMARKS.md](TRADEMARKS.md) を参照してください。