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

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

出力モード

フラグ	モード	用途
(デフォルト)	table (TTY) / JSON (パイプ)	人間用 / スクリプト自動検出
--format json	コンパクト JSON	エージェント解析、jq へのパイプ処理
--format yaml	YAML	LLM 向けトークン効率的
--raw	フル API エンベロープ	デバッグ
--human-time	タイムスタンプ → ローカル時刻	ログ読込
--dry-run	プレビュー、実行しない	安全確認

ドメインスキル

スキル	ファイル	スコープ
Monitor	monitor.md	CPU、メモリ、トラフィック、クライアント
Network	network.md	DNS、DHCP、VLAN、NAT、WAN/LAN、PPPoE
Security	security.md	ACL、MAC、L7、URL、ドメインブラックリスト、peerconn
VPN	vpn.md	PPTP、L2TP、OpenVPN、IKEv2、IPSec、WireGuard
Users	users.md	オンラインユーザー、アカウント、パッケージ
System	system.md	設定、スケジュール、リモートアクセス、VRRP、ALG、カーネル
Auth	auth.md	ログイン、PPPoE 認証アカウント
Auth Server	auth-server.md	Web ポータル認証設定
Log	log.md	システム/DHCP/PPPoE/認証/ARP ログ
Objects	objects.md	IP/IPv6/MAC/ポート/プロトコル/ドメイン/時刻オブジェクト
QoS	qos.md	IP/MAC 帯域幅制御
Routing	routing.md	静的ルート、ストリーム分流
Wireless	wireless.md	ブラックリスト、VLAN、AC 管理
Advanced	advanced.md	FTP、HTTP、Samba、SNMPD
Batch	batch.md	マルチコマンドワークフロー

コマンド形式

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"}

コード	意味	対処法
3007	トークン無効/期限切れ	auth set-token <TOKEN>
1008	セッション期限切れ	auth set-token <TOKEN>
10014	アクセス拒否	ユーザーのアクセス許可を確認してください