Troubleshooting

Isolate a dev instance

VIBE_HOME=/tmp/vibe-dev vibe

Useful paths:

~/.vibe/vibe.db
~/.vibe/auth.json
~/.vibe/server.cookie
~/.vibe/server.out
~/.vibe/sessions/<id>.log
~/.vibe/skills

Auth

vibe --login codex

In eval:

Vibe.Auth.ensure_fresh("openai-codex")
Vibe.Auth.usage("openai-codex")

Server/session state

vibe server status
vibe server restart
vibe sessions --live

Storage

vibe storage status
vibe storage migrate
vibe storage fts status

In eval:

Vibe.Storage.status()
Vibe.Telemetry.summary()
Vibe.Session.list()

Debug traces

Trace capture is opt-in and intended for development/debugging. Avoid recording raw prompts, file contents, tool outputs, secrets, or OAuth tokens in telemetry metadata.

For stream-ordering investigations, use VIBE_STREAM_TRACE_DIR only in disposable/debug sessions.

For visual TUI artifacts, record the actual terminal byte stream with a TTYCast recording:

VIBE_TUI_CAST=/tmp/vibe-session.ttycast mix vibe

The recording contains conversation output and terminal control bytes. Input bytes are redacted by default; set VIBE_TUI_CAST_INPUT=1 only in disposable sessions if raw input is needed. Inspect recordings from eval or mix run:

TTYCast.info("/tmp/vibe-session.ttycast")
TTYCast.snapshot!("/tmp/vibe-session.ttycast", time_ms: 1_000)
TTYCast.export("/tmp/vibe-session.ttycast", :asciinema, "/tmp/vibe-session.cast")