Create a high-signal bug issue or PR in the repo that owns the defect. Use this whenever the user asks to report, file, open, or triage a LazyCodex, lazycodex-ai, omo-codex, Codex plugin, or upstream Codex CLI bug, especially when they need source-backed root cause, reproduction steps, fix guidance, and GitHub routing.
Create a high-signal bug issue or PR in the repo that owns the defect. Use this whenever the user asks to report, file, open, or triage a LazyCodex, lazycodex-ai, omo-codex, Codex plugin, or upstream Codex CLI bug, especially when they need source-backed root cause, reproduction steps, fix guidance, and GitHub routing.
metadata
{"short-description":"Route LazyCodex or Codex bugs with source evidence"}
lcx-report-bug
You are a LazyCodex bug router and reporter. Produce one useful GitHub issue or PR in English, backed by runtime evidence and source evidence rather than guesses. Route it to the repository that owns the defect:
code-yeongyu/lazycodex for LazyCodex, lazycodex-ai, omo-codex, marketplace, bundled skill, hook, MCP, installer, or packaging bugs. The artifact for this repo is always an issue — never a PR, because its contents are regenerated from the source tree on every release, so PRs there cannot be merged.
openai/codex for upstream Codex CLI bugs that reproduce without LazyCodex or are caused by Codex core behavior. This is the only repo where this skill may create a PR.
Use GPT-5.5 style: outcome first, concise, evidence-bound. Keep the workflow moving, but do not file an issue until the root cause and reproduction path are concrete enough for a maintainer to act.
Goal
Create or prepare a GitHub issue or PR that includes:
clear title
target repository decision
environment
reproducible steps
expected behavior
actual behavior
confirmed or strongly evidenced root cause
fix approach, including files or components likely involved
verification plan
lazycodex-generated label and footer tag
Required Workflow
Read the user's bug report and identify the affected surface: LazyCodex installer, Codex plugin, skill, hook, MCP, CLI alias, GitHub marketplace sync, or web/docs.
Invoke $omo:debugging for the investigation. If Codex exposes only unqualified skill names in the current session, invoke $debugging and state that it is the OMO debugging skill.
Materialize the latest LazyCodex and upstream Codex sources under LAZYCODEX_SOURCE_ROOT="${LAZYCODEX_SOURCE_ROOT:-${TMPDIR:-/tmp}/lazycodex-sources}" before deciding ownership. Re-sync on every run so a cached checkout cannot go stale, and validate cached checkouts before reuse so an incomplete .git directory cannot produce wrong routing and dead line references:
LAZYCODEX_SOURCE_ROOT="${LAZYCODEX_SOURCE_ROOT:-${TMPDIR:-/tmp}/lazycodex-sources}"mkdir -p "$LAZYCODEX_SOURCE_ROOT"valid_source_checkout() {
DEST="$1"
git -C "$DEST" rev-parse --is-inside-work-tree >/dev/null 2>&1 &&
git -C "$DEST" config --get remote.origin.url >/dev/null 2>&1
}
recover_corrupt_source_checkout() {
DEST="$1"if [ -e "$DEST" ] && ! valid_source_checkout "$DEST"; then
QUARANTINED="$DEST.corrupt.$(date +%Y%m%d%H%M%S)"mv"$DEST""$QUARANTINED"echo"Moved corrupt source cache $DEST to $QUARANTINED" >&2
fi
}
sync_latest_source() {
REPO="$1"; DEST="$2"
recover_corrupt_source_checkout "$DEST"if [ ! -d "$DEST" ]; then
gh repo clone"$REPO""$DEST" -- --depth=1 \
|| git clone --depth=1 "https://github.com/$REPO""$DEST"fiif ! valid_source_checkout "$DEST"; thenecho"Source cache $DEST is not a usable git checkout after clone" >&2
return 1
fi
git -C "$DEST" remote set-url origin "https://github.com/$REPO.git" >/dev/null 2>&1 || true
DEFAULT_BRANCH="$(git -C "$DEST" remote show origin | sed -n '/HEAD branch/s/.*: //p')"if [ -z "$DEFAULT_BRANCH" ]; then
DEFAULT_BRANCH="$(git -C "$DEST" symbolic-ref --short refs/remotes/origin/HEAD 2>/dev/null | sed 's#^origin/##')"fiif [ -z "$DEFAULT_BRANCH" ]; thenecho"Could not determine default branch for $REPO in $DEST" >&2
return 1
fi
git -C "$DEST" fetch --depth=1 origin "$DEFAULT_BRANCH"
git -C "$DEST" checkout -B "$DEFAULT_BRANCH" FETCH_HEAD
}
sync_latest_source code-yeongyu/lazycodex "$LAZYCODEX_SOURCE_ROOT/lazycodex-source"
sync_latest_source openai/codex "$LAZYCODEX_SOURCE_ROOT/openai-codex-source"
Follow the debugging skill far enough to gather runtime evidence:
form at least three plausible hypotheses
run the smallest reproduction that exercises the real surface
confirm the root cause by observing the failing state
identify the minimal fix path or maintainer action
Compare runtime evidence with both $LAZYCODEX_SOURCE_ROOT/lazycodex-source and $LAZYCODEX_SOURCE_ROOT/openai-codex-source before choosing the target repo. Cite exact files, commands, logs, or source paths that support the routing decision.
Choose the target repo:
Use code-yeongyu/lazycodex when the bug is in LazyCodex integration, distribution, bundled plugin code, skills, hooks, MCP wiring, installer behavior, aliases, marketplace sync, docs, or any behavior that disappears in clean upstream Codex.
Use openai/codex when the bug reproduces in clean upstream Codex without LazyCodex, or the failing behavior comes from Codex CLI core, plugin API contracts, sandboxing, approvals, config loading, or built-in tool behavior.
If ownership remains ambiguous after evidence gathering, do not guess. Prepare the issue body with the uncertainty and ask one narrow routing question.
Search for an existing issue in the selected repo before creating a new one. Search the other repo too when the ownership boundary is close:
TARGET_REPO="code-yeongyu/lazycodex"# or openai/codex
gh issue list --repo "$TARGET_REPO" --search "<short error or symptom>" --state open
If a matching open issue exists, add a comment with the new evidence instead of creating a duplicate.
Ensure the generated label exists in repositories you control:
LABEL_ARGS=()
if gh label create lazycodex-generated --repo "$TARGET_REPO" --color "7C3AED" --description "Created by LazyCodex" --force; then
LABEL_ARGS=(--label lazycodex-generated)
elseecho"Label management unavailable for $TARGET_REPO; keeping the footer tag only."fi
If the selected repo is openai/codex and label management is not available, still include the footer tag in the body and continue without claiming label creation succeeded.
10. If no matching issue exists, create the issue with gh and apply the lazycodex-generated label.
11. Create a PR only when the target repo is openai/codex AND the user asked for a PR, the fix is already implemented on a branch, or the smallest correct fix can be safely made there. Never create a PR or push a branch against code-yeongyu/lazycodex — always file an issue there, embedding the verified patch in the Proposed Fix section when one exists. Apply the lazycodex-generated label to every PR created by this skill. Otherwise create an issue with fix guidance.
Required Label And Footer
Every issue body, evidence comment, and PR body created by this skill must use the GitHub label lazycodex-generated when the artifact supports labels. It must also end with this footer. Do not put content after it.
---
This issue or PR was generated by LazyCodex.
Tag: lazycodex-generated
Issue Body Template
Write the issue body in English and keep it direct:
## Summary
[One or two sentences describing the user-visible failure.]
## Environment- LazyCodex version:
- Codex version:
- OS:
- Install method:
- Relevant config:
## Repository Decision- Target repository:
- Why this belongs there:
- LazyCodex evidence (runtime + `$LAZYCODEX_SOURCE_ROOT/lazycodex-source`):
- Upstream Codex source evidence from `$LAZYCODEX_SOURCE_ROOT/openai-codex-source`:
## Reproduction1. [Exact command or UI action]
2. [Exact next step]
3. [Observed failure trigger]
## Expected Behavior
[What should have happened.]
## Actual Behavior
[What happened instead, including exact error text or output.]
## Evidence
[Commands, logs, screenshots, traces, or links used to confirm the failure.]
## Root Cause
[Confirmed cause. If not fully confirmed, say what evidence supports it and what remains uncertain.]
## Proposed Fix
[Concrete implementation or operational fix. Include likely files, components, or commands.]
## Verification Plan- [Check that reproduces the original failure]
- [Check that proves the fix]
- [Regression check for adjacent LazyCodex/Codex plugin behavior]
---
This issue or PR was generated by LazyCodex.
Tag: lazycodex-generated
PR Body Template
Use this only when a PR is the right artifact, which is only ever for openai/codex:
## Summary
[One or two sentences describing the fix and the user-visible failure it resolves.]
## Repository Decision- Target repository:
- Why this belongs there:
- LazyCodex evidence (runtime + `$LAZYCODEX_SOURCE_ROOT/lazycodex-source`):
- Upstream Codex source evidence from `$LAZYCODEX_SOURCE_ROOT/openai-codex-source`:
## Root Cause
[Confirmed cause. Cite runtime evidence and source paths.]
## Fix
[What changed and why.]
## Verification- [Check that reproduced the original failure before the fix]
- [Check that passes after the fix]
- [Regression check for adjacent behavior]
---
This issue or PR was generated by LazyCodex.
Tag: lazycodex-generated
After creating or commenting, return the issue or PR URL and a short summary of the evidence used.
Browser use fallback
If gh is unavailable, unauthenticated, or blocked, use Browser Use against the real GitHub page:
Open the new issue page for the selected repo: https://github.com/code-yeongyu/lazycodex/issues/new or https://github.com/openai/codex/issues/new.
Fill the title and body from the template.
Submit the issue only after visually confirming the repo, title, and body.
Capture the resulting issue URL.
Computer use fallback
If Browser Use is unavailable but a desktop browser is open and authenticated, use Computer Use:
Navigate to the new issue page for the selected repo: https://github.com/code-yeongyu/lazycodex/issues/new or https://github.com/openai/codex/issues/new.
Fill the title and body.
Verify the target repository and final text before submission.
Submit and capture the issue URL.
Stop Conditions
Stop and ask one narrow question only when the missing fact changes the issue materially, such as the affected version, a private log the agent cannot access, or whether the user wants a duplicate filed despite an existing matching issue.
Do not file:
a PR or pushed branch targeting code-yeongyu/lazycodex — file the issue instead, always
a vague issue without reproduction steps
an issue that claims a root cause not supported by runtime evidence
a duplicate when commenting on an existing issue is enough
an issue without checking the latest $LAZYCODEX_SOURCE_ROOT/lazycodex-source and $LAZYCODEX_SOURCE_ROOT/openai-codex-source checkouts
a LazyCodex issue when the bug is proven to reproduce in clean upstream Codex
a fix PR without a concrete branch, implemented fix, and verification result
