🛠️ Ops Copilot

📖 Ops Copilot Guide

A lightweight, offline network troubleshooting assistant that generates smart diagnostic commands and AI-ready prompts for Cisco environments.

Quick Start

1. Online: You're already here! Just use the tabs above.
2. Offline: Download the files from GitHub and open index.html in any browser

No installation required. Works 100% offline.

What It Does

Incident Analysis:

• Enter symptoms in plain language (e.g., "WiFi keeps dropping", "slow internet")
• Get intelligent command suggestions based on keywords and device type
• Auto-generates evidence collection worksheets
• Performs basic offline analysis of command outputs
• Creates structured AI prompts for deeper troubleshooting

Config Review:

• Paste sanitized configs
• Generate AI-ready prompts for security and best practice analysis

🔧 How to Use Incident Analysis

Step-by-Step:

1. Select Incident Type
   • Wired Connectivity
   • Connectivity Issue
   • Performance/Latency
   • Intermittent/Flapping
   • DHCP/IP Issues
   • Wireless Issues
   • Other
2. Choose Device Role
   • Access/IDF (Cat9300/9300X) - Most common for end-user issues
   • Core/Root (Nexus 9K) - For backbone/routing issues
   • Wireless (Catalyst 9800) - For WiFi/AP problems
3. Add Interface (Optional)
   • Enter interface if known: gi1/0/24, te 2/0/4, po-2
   • Tool accepts any format and normalizes it
4. Describe Symptoms in Plain Language
   • ✅ Good: "WiFi keeps disconnecting, users get authentication errors"
   • ✅ Good: "Link flapping on gi1/0/24, seeing errors"
   • ✅ Good: "Internet is slow, Teams calls dropping"
   • The tool detects keywords like "flapping", "slow", "WiFi", "dhcp", etc.
5. Get Smart Command Suggestions
   • Click "Suggest Evidence Commands"
   • Tool auto-generates relevant show commands based on your symptoms
   • Commands adapt to device type (IOS-XE vs NX-OS vs WLC)
6. Insert Evidence Worksheet
   • Click "Insert Evidence Worksheet"
   • Creates a formatted template with suggested commands
   • Run the commands on your device and paste outputs below
7. Offline Analysis (Optional)
   • After pasting command outputs, click "Offline Analysis"
   • Get basic pattern detection (errors, down interfaces, etc.)
   • Enable auto-redaction to sanitize IPs and emails
8. Generate AI Prompt
   • Click "Generate AI Prompt" for deeper analysis
   • Copy and paste into ChatGPT, Claude, or your AI tool
   • Get structured troubleshooting steps and root cause analysis

Smart Detection Examples:

📋 How to Use Config Review

Step-by-Step:

1. Select Device Type
   • Catalyst 9300/9300X (Access switches)
   • Nexus 9000 (Core/distribution)
   • Catalyst 9800 (Wireless controller)
   • Other
2. Describe Intent - Explain what the device should do
   • Example: "Access switch for Building A, 3rd floor, user VLANs 10-20, uplink to core via 10G fiber"
   • Include: Location, purpose, VLANs, uplinks, special requirements
3. Paste Config - Add your sanitized running-config
   • ⚠️ Always sanitize first! Remove/redact:
   • • Passwords and secrets
   • • Public IP addresses
   • • Real hostnames
   • • SNMP community strings
   • • AAA keys
   • ✅ Can paste full config or specific sections
4. Generate AI Prompt
   • Click "Generate AI Prompt" to create a structured review request
   • The prompt asks AI to check for security issues, misconfigurations, and best practices
5. Copy & Use with AI
   • Click "Copy Output" to copy the prompt
   • Paste into ChatGPT, Claude, or your preferred AI tool
   • Get findings categorized as High/Medium/Low with fix suggestions

What the AI Checks:

• 🔒 Security issues (weak passwords, missing ACLs, open services)
• ⚙️ Misconfigurations (VLAN mismatches, STP issues, routing problems)
• 📚 Best practices (naming conventions, QoS, redundancy)
• 🎯 Alignment with stated intent

Example Config Review:

Key Features

• ✅ Smart Detection - Understands natural language ("flapping", "can't connect", "slow")
• ✅ Platform-Aware - Adapts to Cat9300/9300X, Nexus9K, or Cat9800 WLC
• ✅ Interface Parsing - Handles gi1/0/24, te 2/0/4, po-2 formats
• ✅ Offline Analysis - Basic diagnostics without external APIs
• ✅ Auto-Redaction - Sanitizes IPs and emails
• ✅ 100% Offline - No data leaves your browser

Usage Example

The tool detects "authentication" and automatically includes auth-specific commands.

Supported Platforms

• Access: Catalyst 9300, 9300X (IOS-XE)
• Core: Nexus 9000 Series (NX-OS)
• Wireless: Catalyst 9800 WLC
• APs: Catalyst 9100 Series

Privacy & Security

• 100% client-side JavaScript - no server communication
• Safe for sanitized/redacted data
• Auto-redaction available for IPs and emails
• No data storage or tracking

Tips

• Auto-update: Enable "Auto-update suggestions" to see recommendations refresh as you type
• Multiple symptoms: Tool detects multiple issue types and combines relevant commands
• Any interface format: gi1/0/24, g 1/0/24, GigabitEthernet1/0/24 all work

Made for Network Operations Teams