iCommand

Claude Code plugin for the LambdaTest iOS team — slash commands, knowledge base, and MCP servers.

One repo. One install. Every team member gets all workflows globally.

git clone [email protected]:LambdatestIncPrivate/iCommand.git
cd iCommand
./install.sh

Open Claude Code in any repo and type / to see all available commands.

Requires the hostctl binary. See Setup below.

Get a snapshot of a remote host: system stats, connected devices, service health, and recent errors.

/host-inspect <host_ip> [environment]

/host-inspect 10.151.1.211
/host-inspect 10.151.1.211 prod

What it runs: hostctl inspect, hostctl stats, hostctl health, hostctl devices (in parallel)

Output:

• System table — hostname, OS, uptime, CPU, memory, disk
• Connected devices — UDID, model, iOS version, battery
• Service health — LRR/MB running status, PID, health check result
• Anomaly flags — disk > 80% suggests /clean-host, stopped service suggests /service-manage restart

Comprehensive diagnostic covering every aspect of the host.

/host-diag <host_ip> [environment]

/host-diag 10.151.1.211
/host-diag 10.151.1.213 prod

What it runs (all in parallel):

Anomaly detection:

• Disk > 80% → suggests /clean-host
• Memory pressure critical → shows top memory consumers
• CPU > 90% → shows top CPU consumers
• Unavailable simulators → suggests cleanup

Intelligent RCA combining log pattern matching with source code correlation. Maps errors to exact file:line references in your local source code.

/host-rca <host_ip> <udid> [environment]

/host-rca 10.151.1.211 00008110-001E04C10C8A801E
/host-rca 10.151.1.211 00008110-001E04C10C8A801E prod

Two-layer analysis:

Known failure signatures cross-referenced:

Output: Findings with severity (P1-P4), frequency, source file:line, error timeline, service status. Offers to post to Slack or create /incident.

Manage iOS devices connected to a remote host.

/device-manage <action> <host_ip> [udid] [environment]

list — Show all connected devices

/device-manage list 10.151.1.211
/device-manage list 10.151.1.211 prod

Output: UDID, name, model, iOS version, battery %

info — Detailed device metadata

/device-manage info 10.151.1.211 00008110-001E04C10C8A801E

Output: Serial, WiFi MAC, Bluetooth, storage, all device properties

apps — List installed applications

/device-manage apps 10.151.1.211 00008110-001E04C10C8A801E

Supports filtering: user, system, or all (default: user)

screenshot — Capture and download screenshot

/device-manage screenshot 10.151.1.211 00008110-001E04C10C8A801E

Saves to /tmp/screenshot-<last8_udid>.png

reboot — Reboot device (requires confirmation)

/device-manage reboot 10.151.1.211 00008110-001E04C10C8A801E

syslog — Stream iOS system logs

/device-manage syslog 10.151.1.211 00008110-001E04C10C8A801E

Shows last 200 lines. Use --follow for live streaming.

Manage LRR (Lambda Remote Runner) and MB (Mobile Binary) services on remote hosts.

/service-manage <action> <host_ip> [service] [environment]

status — Show service process info

/service-manage status 10.151.1.211

Output: Service name, status (RUNNING/STOPPED), PID, CPU%, MEM%

health — Run health checks

/service-manage health 10.151.1.211
/service-manage health 10.151.1.211 prod

Output: Process check + custom health command result (OK/FAIL)

restart — Restart a service (requires confirmation)

/service-manage restart 10.151.1.211 lrr
/service-manage restart 10.151.1.211 mb prod

Sends SIGTERM, waits 2s, verifies auto-restart. Reports new PID.

stop — Stop a service (requires confirmation)

/service-manage stop 10.151.1.211 mb

Add --force for SIGKILL.

logs — Tail or stream service logs

/service-manage logs 10.151.1.211 lrr 00008110-001E04C10C8A801E
/service-manage logs 10.151.1.211 mb 00008110-001E04C10C8A801E

Shows last 200 lines. Supports --follow for live streaming.

Execute arbitrary shell commands on a remote host through the bastion SSH tunnel.

/host-exec <host_ip> "<command>" [environment]

/host-exec 10.151.1.211 "ps aux | grep mobile"
/host-exec 10.151.1.211 "df -h" prod
/host-exec 10.151.1.213 "ls -la ~/Documents/Mobile_Binary/"
/host-exec 10.151.1.211 "cat /etc/os-release"

Safety checks:

• Blocked: rm -rf /, shutdown, dd on disks, SSH key modifications
• Requires confirmation: rm, kill, sudo, file modifications
• No confirmation needed: Read-only commands (ls, ps, df, cat, uptime)

Clean DerivedData, Xcode caches, and unavailable simulators. Shows before/after disk usage.

/clean-host <host_ip> [environment]

/clean-host 10.151.1.211
/clean-host 10.151.1.211 prod

Workflow:

1. Shows current disk usage (root, DerivedData, caches)
2. Asks what to clean:
   • DerivedData only (safest, usually largest gain)
   • Xcode caches
   • Unavailable simulators
   • All of the above
3. Runs cleanup
4. Shows before/after comparison with space freed

1. Get the hostctl binary from your team lead and place it in your PATH:

   cp hostctl ~/bin/hostctl
   chmod +x ~/bin/hostctl

2. Create config templates:

   hostctl config init

3. Edit ~/.hostctl/{dev,stage,prod}.yaml with your bastion username and credentials.

4. Verify:

   hostctl --version

environment: prod
bastion:
    host: bastion-prod.lambdatest.com
    user: <your_username>
    password: "<your_password>"
host:
    user: ltadmin
    password: "<host_password>"
services:
    lrr:
        name: Lambda Remote Runner
        log_path: ~/Documents/LambdaRemoteRunner/lamda-remote-runner-{{udid}}.log
        source_path: /path/to/lambda-remote-runner  # optional, enables /host-rca source analysis
    mb:
        name: Mobile Binary
        log_path: ~/Documents/Mobile_Binary/lt-{{udid}}.log
        source_path: /path/to/mobile-automation      # optional

The logtail MCP server (used by /debug-host, /check-health, /incident) reads credentials from macOS Keychain:

# Bastion passwords (replace with your username)
security add-generic-password -s 'logtail-bastion-prod' -a '<username>' -w '<password>'
security add-generic-password -s 'logtail-bastion-stage' -a '<username>' -w '<password>'

# Host passwords
security add-generic-password -s 'logtail-host-prod' -a 'ltadmin' -w '<password>'
security add-generic-password -s 'logtail-host-stage' -a 'ltadmin' -w '<password>'

install.sh symlinks every commands/*.md to ~/.claude/commands/, making them available as global slash commands in Claude Code from any directory. The repo path is stored in ~/.claude/icommand-path so commands can find docs/.

# Update (no reinstall needed)
cd iCommand && git pull

# Uninstall
cd iCommand && ./uninstall.sh

# Verify installation
/doctor

iCommand/
├── install.sh                         # One-command setup
├── uninstall.sh                       # Clean removal
├── commands/                          # 22 slash commands
│   ├── host-inspect.md                #   hostctl-powered
│   ├── host-diag.md
│   ├── host-rca.md
│   ├── device-manage.md
│   ├── service-manage.md
│   ├── host-exec.md
│   ├── clean-host.md
│   ├── debug-host.md                  #   logtail MCP-powered
│   ├── check-health.md
│   ├── incident.md
│   ├── feature.md                     #   dev workflow
│   ├── fix-bug.md
│   ├── commit-push-pr.md
│   ├── review-pr.md
│   ├── deploy-check.md
│   ├── read-prd.md
│   ├── write-rfc.md
│   ├── standup.md
│   ├── slack-update.md
│   ├── transition-jira.md
│   ├── changelog.md
│   └── doctor.md
├── skills/                            # 4 auto-triggered skills
├── docs/                              # Knowledge base
├── mcp-servers/logtail/               # SSH log access MCP server
└── templates/                         # CLAUDE.md templates