debug

Installation
SKILL.md

Debug

Goals

  • Find why a run is stuck, retrying, or failing.
  • Correlate Linear issue identity to a Codex session quickly.
  • Read the right logs in the right order to isolate root cause.

Log Sources

  • Primary runtime log: log/symphony.log
    • Default comes from SymphonyElixir.LogFile (log/symphony.log).
    • Includes orchestrator, agent runner, and Codex app-server lifecycle logs.
  • Rotated runtime logs: log/symphony.log*
    • Check these when the relevant run is older.

Correlation Keys

  • issue_identifier: human ticket key (example: MT-625)
Related skills
Installs
31
Repository
openai/symphony
GitHub Stars
23.2K
First Seen
Mar 12, 2026