overthinkos/version

ov version -- CLI Version

Overview

Displays the installed version of the ov CLI binary.

Quick Reference

| Action | Command | Description | |--------|---------|-------------| | Show version | ov version | Print ov version string |

Usage

ov version

Testing Note

ov version writes the CalVer tag to stdout via fmt.Println. Declarative tests should match stdout: — for example layers/ov/layer.yml uses:

- id: ov-version
  command: /usr/local/bin/ov version
  exit_status: 0
  stdout:
    - matches: "[0-9]{4}\\.[0-9]+"

Historical note: VersionCmd originally used Go's builtin println(version) which routes to stderr (the builtin bypasses os.Stderr and writes directly to fd 2). The move to fmt.Println landed with the MCP server work so the in-process tool-call path — which captures os.Stdout — can surface the version correctly. See /ov-build:eval Authoring Gotcha #5 and /ov-build:mcp "Capture model" for the full story.

Cross-References

• /ov-core:doctor -- Full host dependency and health check
• /ov-build:settings — runtime config where secret_backend and other settings live
• /ov-build:image — build-mode family that stamps CalVer tags matching this version
• /ov-build:eval — declarative testing framework (Gotcha #5 covers the stdout rule)
• /ov-build:mcp — MCP server section explains why the stream choice matters for the capture pipeline
• /ov-dev:go — ov/version.go CalVer computation; main.go VersionCmd.Run using fmt.Println