Documentation

Runtime state

Understand `.vectron/runtime.json`, socket location, and workspace-scoped state.

Runtime artifacts

When a workspace is running, Vectron records runtime state under .vectron/.

The most important file is .vectron/runtime.json.

What runtime state contains

The runtime state includes:

  • schema version
  • Vectron PID
  • socket path or named pipe address
  • workspace root
  • config path
  • log directory
  • start timestamp
  • Vectron version

Why this file matters

Commands such as status use runtime state to discover the active local control endpoint even when the current config file later becomes invalid.

Cleanup

The runtime file is removed when start exits cleanly.