DocsGuidesUpdates & Troubleshooting
Back to Docs
Guides

Updates & Troubleshooting

Update YeePilot safely and resolve common provider, auth, sandbox, and vault issues.

Last updated: March 1, 2026

Updating

Check availability:

bash
yeepilot update --check

Install latest:

bash
yeepilot update

Force reinstall:

bash
yeepilot update --force

Rollback previous binary:

bash
yeepilot update --rollback

Authentication Issues

If commands fail due to platform auth/session state:

bash
yeepilot setup --auth
yeepilot status

Use setup --auth instead of legacy login commands.

Provider / Model Errors

  1. Confirm provider-model match.
  2. Check API key validity.
  3. Retry with explicit override:
bash
yeepilot exec --provider openai --model gpt-4o "health check"

Config Reset Path

If config drift is severe:

bash
yeepilot setup --reset

Then re-run setup.

Sandbox Problems

If sandboxed commands fail unexpectedly:

  • inspect current mode in TUI via /sandbox status
  • temporarily test net vs nonet
  • adjust sandbox limits in config if workload legitimately needs more CPU/memory/processes

Vault Problems

Check state:

bash
yeepilot vault status

Unlock test:

bash
yeepilot vault unlock --method password

If recovery key rotation is required:

bash
yeepilot vault rotate-recovery --unlock-method password

Common Recovery Steps

  1. yeepilot status
  2. yeepilot setup --auth
  3. verify provider/model config
  4. run a minimal yeepilot exec sanity task
  5. relaunch TUI and inspect /status, /autonomy status, /sandbox status

Uninstall Options

bash
yeepilot uninstall --all
yeepilot uninstall --keep-config
yeepilot uninstall --binary-only