ikuai-cli — AI エージェント スキル

ローカル v4.0 HTTP API を通じて iKuai ルーターを管理するための Go CLI。

使用場面

• ルーターステータス、CPU、メモリ、稼働時間、トラフィック
• ネットワーク: DNS、DHCP、VLAN、NAT、PPPoE、VPN
• ユーザー: オンラインセッション、キック、認証アカウント
• セキュリティ: ACL、MAC フィルター、URL フィルター、ドメインブラックリスト
• システム: ログ、スケジュール、リモートアクセス、VRRP

前提条件

# セッション (永続的)
ikuai-cli auth set-url https://192.168.1.1
ikuai-cli auth set-token <TOKEN>

# または環境変数 (一時的)
export IKUAI_CLI_BASE_URL=https://192.168.1.1
export IKUAI_CLI_TOKEN=<TOKEN>

# 確認
ikuai-cli auth status --format json

優先度: セッションファイル > 環境変数 > なし

出力モード

ドメインスキル

コマンド形式

ikuai-cli <resource> <action> [args] [flags]

• 読込: ikuai-cli monitor system --format json
• リスト: ikuai-cli network dhcp list --page 1 --page-size 50
• 書込: ikuai-cli network dhcp create --name "Office" --interface lan1 --addr-pool 192.168.1.100-200
• 書込 (エスケープハッチ): ikuai-cli network dns set --data '{"key":"value"}'
• REPL: ikuai-cli (インタラクティブシェル)

エラーハンドリング

{"code": 3007, "message": "Invalid token"}