Documentation

Control protocol

Understand the local control endpoint used by status, restart, and logs.

Runtime file

When vectron start succeeds, runtime information is written to .vectron/runtime.json.

That file records:

  • the Vectron process ID
  • the workspace root
  • the config path
  • the log directory
  • the local control socket path or named pipe address

Requests

Minimal text protocol requests include:

  • status
  • restart <process|process#n>
  • logs [<process|process#n>] [json] [once|no-follow]

Status response

status returns tab-separated rows with columns:

  • PROCESS
  • INSTANCE
  • PID
  • PORT
  • STATE
  • LOG_MODE

Logs response

Text logs use:

  • handshake line
  • connection header
  • streaming output lines

JSON logs are returned as JSONL.

Scope

This control endpoint is local workspace infrastructure. It is not a public remote API.