report-issue

Report Issue to CodeMie Code

Help the user file a well-structured bug report or feature request to codemie-ai/codemie-code on GitHub.

The goal is to create a rich issue that gives maintainers everything they need to triage and reproduce the problem — without requiring the user to manually gather technical details.

---

Step 1: Pre-flight and Diagnostic Collection

1a. Check gh CLI first — do this before anything else

if ! command -v gh &>/dev/null; then
  echo "GH_NOT_INSTALLED"
else
  gh auth status 2>&1 || echo "GH_NOT_AUTHENTICATED"
fi

If GH_NOT_INSTALLED: Stop immediately and tell the user:

"gh (GitHub CLI) is not installed. It is required to create issues from the terminal.

Install it with one of:

• macOS: brew install gh
• Linux (apt): sudo apt install gh
• Linux (dnf): sudo dnf install gh
• Windows: winget install --id GitHub.cli
• Or download from: https://cli.github.com

After installing, run gh auth login to connect your GitHub account, then try this skill again."

If GH_NOT_AUTHENTICATED: Stop and tell the user:

"gh is installed but not authenticated. Run gh auth login to connect to your GitHub account, then try again."

Do not proceed past this point until gh is installed and authenticated.

1b. Gather diagnostic context

Run the following and capture results. Don't display raw output yet.

# OS + platform
uname -srm 2>/dev/null || echo "unknown"

# Node.js version
node --version 2>/dev/null || echo "not found"

# npm version
npm --version 2>/dev/null || echo "not found"

# CodeMie CLI version
codemie --version 2>/dev/null || echo "not found"

# Installed agents and versions
codemie list --installed 2>/dev/null || echo "unavailable"

# Full doctor output (profile, provider, dependency health, agent versions)
codemie doctor 2>/dev/null || echo "unavailable"

# Shell + terminal environment
echo "Shell: $SHELL"
echo "Terminal: ${TERM_PROGRAM:-unknown}"

# Extract ERROR and WARN lines from the two most recent log files.
# Log format: [TIMESTAMP] [LEVEL] [agent] [session-id] [profile] [component] message
# Files: ~/.codemie/logs/debug-YYYY-MM-DD.log (one per day, can be several MB)
LOG_DIR="$HOME/.codemie/logs"
RECENT_LOGS=$(ls -t "$LOG_DIR"/debug-*.log 2>/dev/null | head -2)
if [ -n "$RECENT_LOGS" ]; then
  echo "=== ERROR and WARN entries from recent logs ==="
  # Print filename headers and filter by level; limit to last 100 matches to keep size reasonable
  for f in $RECENT_LOGS; do
    echo "--- $f ---"
    grep -E '\[(ERROR|WARN)\]' "$f" | tail -50
  done
  echo "=== Full log files ==="
  for f in $RECENT_LOGS; do
    echo "$f"
  done
else
  echo "No debug logs found"
fi