ikuai-cli

Name: ikuai-cli
Author: ikuaidev

github.com/ikuaidevCloud & DevOps141283 installsUpdated 10w ago

About ikuai-cli

ikuai-cli is a Go command-line tool for managing iKuai routers through the local v4.0 HTTP API, aimed at operators and agents. It covers network, security, user, and system operations, with output formats for scripts and agents plus a dry-run preview.

Key features

01Inspect router status and traffic
02Manage DNS, DHCP, VLAN, NAT, and VPN
03Manage online users and auth accounts
04Configure access controls and filters
05Use JSON, YAML, and dry-run modes

Use cases

01Check router resources and network traffic
02Configure network and VPN settings
03Manage online sessions and access controls
04Preview or run batch operations through scripts

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/ikuaidev/ikuai-cli --skill ikuai-cli

After installing, type/ikuai-cliin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

.gitignore

.golangci.yml

README.md

CONTRIBUTING.md

CODE_OF_CONDUCT.md

.goreleaser.yml

Makefile

SECURITY.md

LICENSE

README_CN.md

.github/

dependabot.yml

pull_request_template.md

.github/ISSUE_TEMPLATE/

feature_request.md

bug_report.md

config.yml

.github/workflows/

codeql.yml

ci.yml

release.yml

cmd/ikuai-cli/

main.go

docs/

cli-reference.md

compatibility.md

install.md

docs/commands/

output.md

docs/examples/

auth-status.pretty.json

auth-status.compact.json

monitor-system.pretty.json

README.md

version.compact.json

users-accounts-list.compact.json

system-set-response.compact.json

Details

From the project README

ikuai-cli — AI Agent Skill

Go CLI for managing iKuai routers through the local v4.0 HTTP API.

When to Use

Router status, CPU, memory, uptime, traffic
Network: DNS, DHCP, VLAN, NAT, PPPoE, VPN
Users: online sessions, kick, auth accounts
Security: ACL, MAC filter, URL filter, domain blacklist
System: logs, schedules, remote access, VRRP

Prerequisites

# Session (persistent)
ikuai-cli auth set-url https://192.168.1.1
ikuai-cli auth set-token <TOKEN>

# OR environment variables (ephemeral)
export IKUAI_CLI_BASE_URL=https://192.168.1.1
export IKUAI_CLI_TOKEN=<TOKEN>

# Verify
ikuai-cli auth status --format json

Priority: Session file > Environment variables > None.

Output Modes

Flag	Mode	Use case
(default)	table (TTY) / JSON (pipe)	human / script auto-detect
`--format json`	compact JSON	agent parsing, pipe to `jq`
`--format yaml`	YAML	token-efficient for LLM
`--raw`	full API envelope	debug
`--human-time`	timestamp → local time	log reading
`--dry-run`	preview, no execute	safety check

Domain Skills

Skill	File	Scope
Monitor	monitor.md	CPU, memory, traffic, clients
Network	network.md	DNS, DHCP, VLAN, NAT, WAN/LAN, PPPoE
Security	security.md	ACL, MAC, L7, URL, domain blacklist, peerconn
VPN	vpn.md	PPTP, L2TP, OpenVPN, IKEv2, IPSec, WireGuard
Users	users.md	Online users, accounts, packages
System	system.md	Config, schedules, remote access, VRRP, ALG, kernel
Auth	auth.md	Login, PPPoE auth accounts
Auth Server	auth-server.md	Web portal auth config
Log	log.md	System/DHCP/PPPoE/auth/ARP logs
Objects	objects.md	IP/IPv6/MAC/port/protocol/domain/time objects
QoS	qos.md	IP/MAC bandwidth control
Routing	routing.md	Static routes, stream shunting
Wireless	wireless.md	Blacklist, VLAN, AC management
Advanced	advanced.md	FTP, HTTP, Samba, SNMPD
Batch	batch.md	Multi-command workflows

Command Shape

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

Read: ikuai-cli monitor system --format json
List: ikuai-cli network dhcp list --page 1 --page-size 50
Write: ikuai-cli network dhcp create --name "Office" --interface lan1 --addr-pool 192.168.1.100-200
Write (escape hatch): ikuai-cli network dns set --data '{"key":"value"}'
REPL: ikuai-cli (interactive shell)

Error Handling

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

Code	Meaning	Fix
3007	Invalid/expired token	`auth set-token <TOKEN>`
1008	Session expired	`auth set-token <TOKEN>`
10014	Permission denied	Check user permissions

Comments

Markdown supported

Details

Author: ikuaidev
Repository: ikuaidev/ikuai-cli
Category: Cloud & DevOps
Installs: 283
GitHub stars: 141

Report

More skills

All skills

lark-apps

open.feishu.cn

732.0k

Develop and host Miaoda (Spark/Miaoda) apps: app creation, local full-stack development, cloud generation and iteration, creative design (UI mockups / interactive prototypes / wireframes / landing pages / dashboards / slide decks / visual exploration), integration of AI-related capabilities, Feishu platform capabilities, or other external capabilities; log/Trace/monitoring metric/PV/UV queries; environment variable management; app collaborators and collaboration permissions; app roles and members; and automation triggers (scheduled / record changes / Webhook / Feishu approvals). Use when users want to develop or create a system, tool, platform, or app; develop locally or in the cloud, modify, deploy, publish, launch, or get a shareable link; create a page or website with HTML and deploy it to Miaoda; design, create a mockup, prototype, wireframe, PPT, deck, or visual exploration; or mention Miaoda/Spark/Miaoda apps (links like `/app/app_xxx` or `/page/<token>`, runtime domains like *.aiforce.cloud), app databases, app file storage, open API Keys, visibility, app collaborators/developer permissions, app roles/role members, production logs, API request volume, error volume, latency, traffic, environment variables, or setting up automation tasks, scheduled triggers, or approval-triggered automation for Miaoda apps. Not for regular cloud drive file uploads (lark-drive), Feishu document editing (lark-doc), or native slide creation (lark-slides).

azure-prepare

github.com/microsoft

571.7k

Prepare azd-based Azure projects for deployment: generates azure.yaml, infrastructure (Bicep/Terraform), and Dockerfiles for the Azure Developer CLI (azd) workflow. USE ONLY when the user explicitly wants to use azd as the deployment tool, or the project already has an azure.yaml file. DO NOT USE FOR: non-azd deployments, Python App Service code-only deploys (use python-appservice-deploy), or cross-cloud migration (use azure-cloud-migrate). WHEN: prepare app for azd, create azure.yaml, set up azd infrastructure, modernize app for Azure with azd, deploy with azd, function app, timer trigger, service bus trigger, event-driven function, managed identity, generate Bicep, generate Terraform, create and deploy to Azure.

wizard

github.com/mattpocock

571.5k

Generate an interactive bash wizard that walks a human through steps only they can perform. Use when provisioning infrastructure, setting up credentials or CI secrets, walking an unfamiliar third-party dashboard, or running a one-off migration or cutover. Don't invoke this for steps the agent can perform itself.

azure-ai

github.com/microsoft

571.2k

Use for Azure AI: Search, Speech, OpenAI, Document Intelligence. Helps with search, vector/hybrid search, speech-to-text, text-to-speech, transcription, OCR. WHEN: AI Search, query search, vector search, hybrid search, semantic search, speech-to-text, text-to-speech, transcribe, OCR, convert text to speech.