Files
coder/docs/reference/cli/logs.md
Cian Johnston 0f446f99dd feat(cli): add logs cmd (#21430)
This PR adds a command to view the provisioner and agent logs for a
given workspace.
Note: I did investigate using the existing `cliui` methods to tail the
logs but they are tailored to a very specific use-case.

Other changes:
- Adds `Agents` to `dbfake.WorkspaceResponse`
- Adds methods to generate provisioner and agent logs in `dbgen`

---------

Co-authored-by: Steven Masley <Emyrk@users.noreply.github.com>
2026-01-08 09:58:10 +00:00

747 B
Generated

logs

View logs for a workspace

Usage

coder logs [flags] <workspace>

Description

View logs for a workspace

Options

-n, --build-number

Type int
Default 0

Only show logs for a specific build number. Defaults to 0, which maps to the most recent build (build numbers start at 1). Negative values are treated as offsets—for example, -1 refers to the previous build.

-f, --follow

Type bool
Default false

Follow logs as they are emitted.