Eve Troubleshooting

This is your CLI-first playbook for when Eve deploys break or jobs fail. It walks through auth loops, secret interpolation errors, deploy job failures, and the newer structured diagnostics from `eve env diagnose` that surface typed failure kinds instead of generic HTTP errors. The sentinel Slack alert section is smart: it reminds you to verify with CLI instead of trusting the ping. Nice touches on the magic-link scanner problem (those mail-security prefetchers that burn OTPs) and the SameSite cookie gotcha for custom domains. If you're running Eve in production, bookmark this. The command patterns are copy-paste ready and the triage flow matches how you'd actually debug in a terminal.

skills.sh installs: 310
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add incept5/eve-skillpacks --skill eve-troubleshooting --agent claude-code

Installs into .claude/skills of the current project.

Files

Eve Troubleshooting

Use CLI-first diagnostics. Do not assume cluster access.

Quick Triage Checklist

eve system health
eve auth status
eve job list --phase active

Common Issues and Fixes

Auth Fails or "Not authenticated"

eve auth logout
eve auth login
eve auth status

If SSH key is missing, register it with the admin or follow the CLI prompt to fetch from GitHub.

Secret Missing / Interpolation Error

eve secrets list --project proj_xxx
eve secrets set MISSING_KEY "value" --project proj_xxx

Verify .eve/dev-secrets.yaml exists for local interpolation.

Deploy Job Failed

eve job follow <job-id>
eve job diagnose <job-id>
eve job result <job-id>
eve env diagnose <project> <env>     # structured DeployFailure + cluster snapshot

Check for registry auth errors, missing secrets, or healthcheck failures.

SKILL.md on GitHub