gh-greyhaven-ai-claude-code-config-grey-haven-plugins-cc-trace/commands/cc-trace-connect.md

name, description

name	description
cc-trace-connect	Display instructions and commands for connecting Claude Code to an active mitmproxy capture session

Display instructions and ready-to-use commands for starting Claude Code through the mitmproxy proxy. Use this after running /cc-trace-start to get the exact commands needed.

What This Command Does

1. Check mitmweb Status

   • Verify mitmweb is running
   • Show current PID and ports
   • Display flow file location

2. Provide Connection Commands

   • Show the proxy script command
   • Display manual environment variable setup
   • Provide one-liner option for quick start

3. Display Current Session Info

   • Web interface URL and password
   • Proxy configuration details
   • Flow file location

Usage

# Show connection instructions
/cc-trace-connect

Implementation

When you use this command, Claude will:

Step 1: Check mitmweb Status

# Check if mitmweb is running
if ps aux | grep -v grep | grep "mitmweb.*8080" > /dev/null 2>&1; then
    echo "✓ mitmweb is running"
    MITM_PID=$(ps aux | grep -v grep | grep "mitmweb.*8080" | awk '{print $2}')
    echo "  PID: $MITM_PID"
else
    echo "✗ mitmweb is not running"
    echo "  Run /cc-trace-start first"
    exit 1
fi

Step 2: Display Connection Instructions

cat << 'EOF'
╔════════════════════════════════════════════════════════════════╗
║           Connect Claude Code to CC-Trace Session              ║
╚════════════════════════════════════════════════════════════════╝

📡 mitmweb is ACTIVE and ready to capture traffic!

┌─ OPTION 1: Using Proxy Script (Recommended - Easiest!) ─────────┐
│                                                                  │
│  Open a NEW terminal window and copy-paste this command:        │
│                                                                  │
│  bash ~/.claude/plugins/marketplaces/grey-haven-plugins/grey-haven-plugins/cc-trace/scripts/proxy-claude.sh
│                                                                  │
│  This automatically sets up the proxy, runs Claude, and cleans  │
│  up when you exit. No shell configuration needed!               │
│                                                                  │
└──────────────────────────────────────────────────────────────────┘

┌─ OPTION 2: Environment Variables One-Liner ─────────────────────┐
│                                                                  │
│  HTTP_PROXY=http://127.0.0.1:8080 \                             │
│  HTTPS_PROXY=http://127.0.0.1:8080 \                            │
│  NODE_EXTRA_CA_CERTS="$HOME/.mitmproxy/mitmproxy-ca-cert.pem" \ │
│  NODE_TLS_REJECT_UNAUTHORIZED=0 \                               │
│  claude                                                          │
│                                                                  │
└──────────────────────────────────────────────────────────────────┘

┌─ OPTION 3: Manual Setup ─────────────────────────────────────────┐
│                                                                  │
│  In a new terminal, run these commands:                         │
│                                                                  │
│  export HTTP_PROXY=http://127.0.0.1:8080                        │
│  export HTTPS_PROXY=http://127.0.0.1:8080                       │
│  export NODE_EXTRA_CA_CERTS="$HOME/.mitmproxy/mitmproxy-ca-cert.pem" │
│  export NODE_TLS_REJECT_UNAUTHORIZED=0                          │
│  claude                                                          │
│                                                                  │
└──────────────────────────────────────────────────────────────────┘

📊 SESSION INFO
   • Web Interface: http://127.0.0.1:8081
   • Password: cc-trace
   • Proxy Port: 8080
   • mitmweb PID: 24007

💡 WHAT HAPPENS NEXT
   1. Open new terminal
   2. Run one of the commands above
   3. Use Claude Code normally
   4. All API traffic appears at http://127.0.0.1:8081

⚠️  IMPORTANT
   • Don't run these commands in THIS terminal
   • You need a SEPARATE terminal for the proxied Claude session
   • This session will continue to show mitmweb status

═══════════════════════════════════════════════════════════════════
EOF

Step 3: Show Current Capture Status

# Show flow file info
FLOW_FILE=$(ps aux | grep -v grep | grep "mitmweb.*8080" | grep -o "claude-flows-[0-9-]*.mitm" | head -1)
if [ -n "$FLOW_FILE" ]; then
    echo ""
    echo "📁 Flow File: ~/$FLOW_FILE"
    if [ -f "$HOME/$FLOW_FILE" ]; then
        FLOW_SIZE=$(ls -lh "$HOME/$FLOW_FILE" | awk '{print $5}')
        echo "   Size: $FLOW_SIZE"
    fi
fi

# Check port status
echo ""
echo "🔌 Port Status:"
if lsof -i :8080 > /dev/null 2>&1; then
    echo "   ✓ Port 8080 (proxy) - LISTENING"
else
    echo "   ✗ Port 8080 (proxy) - NOT LISTENING"
fi

if lsof -i :8081 > /dev/null 2>&1; then
    echo "   ✓ Port 8081 (web) - LISTENING"
else
    echo "   ✗ Port 8081 (web) - NOT LISTENING"
fi

Output Format

The command provides formatted output with:

╔════════════════════════════════════════════════════════════════╗
║           Connect Claude Code to CC-Trace Session              ║
╚════════════════════════════════════════════════════════════════╝

✓ mitmweb is running (PID: 24007)

[Three connection options displayed in boxes]

📊 SESSION INFO
   • Web Interface: http://127.0.0.1:8081
   • Password: cc-trace
   • Proxy Port: 8080
   • Flow File: ~/claude-flows-20251114-160545.mitm

[Additional status information]

Important: When copying commands, copy ONLY the actual command text, not the box-drawing characters (│, ┐, ┘, etc.). For Option 1, copy just:

bash ~/.claude/plugins/marketplaces/grey-haven-plugins/grey-haven-plugins/cc-trace/scripts/proxy-claude.sh

Error Handling

mitmweb Not Running

✗ mitmweb is not running

To start a capture session:
1. Run /cc-trace-start
2. Then run /cc-trace-connect

Certificate Not Found

⚠️  Warning: mitmproxy certificate not found

Run /cc-trace-setup to generate and trust the certificate

Port Conflicts

⚠️  Port 8080 is in use but mitmweb is not running

Check what's using the port:
  lsof -i :8080

Kill the conflicting process or use different ports

Use Cases

1. After Starting mitmweb

You've just run /cc-trace-start and need to know how to connect:

/cc-trace-connect

Get the exact commands to run in a new terminal.

2. Forgot Connection Details

You started mitmweb earlier and can't remember the password or commands:

/cc-trace-connect

See all connection info and session details.

3. Sharing Setup with Team

Need to show someone how to connect to an active session:

/cc-trace-connect

Share the output with ready-to-use commands.

Quick Reference

# Start capture session
/cc-trace-start

# Get connection instructions
/cc-trace-connect

# In new terminal, use one of the provided commands
# Then use Claude Code normally

Related Commands

• /cc-trace-setup - Initial setup for cc-trace
• /cc-trace-start - Start a capture session
• Use cc-trace agent for interactive troubleshooting

Tips

1. Use Option 1 - The proxy script is the easiest, just one command to copy
2. Keep this terminal open - It shows you the connection commands
3. Open a new terminal - Don't close this one, open another
4. Copy the ENTIRE command - Don't include the box characters (│)
5. Check the browser - Make sure http://127.0.0.1:8081 is accessible
6. Use the password - Enter cc-trace when prompted

Common Workflow

# Terminal 1 (this one)
/cc-trace-start        # Start mitmweb
/cc-trace-connect      # Get connection commands

# Terminal 2 (new)
# Copy-paste one of the commands from /cc-trace-connect output
# Use Claude Code normally
# Exit when done

# Browser
# Open http://127.0.0.1:8081
# Enter password: cc-trace
# Watch traffic in real-time

What You'll See

After connecting and using Claude Code in the proxied terminal:

In Browser (http://127.0.0.1:8081):

• List of all API requests
• System prompts sent to Claude
• Tool definitions and parameters
• User messages and file contents
• Tool call results
• Token usage per request
• Streaming response events

In Proxied Terminal:

• Normal Claude Code interface
• No visible difference in functionality
• All features work as expected

In This Terminal:

• Status updates
• Flow file size growing
• Request count (if monitoring enabled)

---

Note: You cannot run the proxy commands in this terminal. This is an active Claude session. You need a separate terminal to start a new Claude instance through the proxy.