`coder schedule start`, `stop`, and `extend` printed the updated schedule as a fixed table with no `-o` or `-c`, while `coder schedule show` has both. All four commands now share one formatter with the same row type, default columns, `-o table|json`, and `-c`, so the output of a change and of `show` is interchangeable. **Behavior change:** Adds `-o` and `-c` to the three commands. The default table output changes slightly: the WORKSPACE column no longer includes the favorite-star prefix, matching `schedule show`. Other columns are unchanged. <details> <summary>Decisions</summary> - Previously these commands rendered `WorkspaceListRow`, which prefixes the workspace name with a favorite icon. Using `scheduleListRow` for consistency with `schedule show` drops that prefix. </details> Closes [CLI-15](https://linear.app/codercom/issue/CLI-15) _This PR was generated by Coder Agents on behalf of @nickvigilante._
54 lines
1.7 KiB
Markdown
Generated
54 lines
1.7 KiB
Markdown
Generated
---
|
|
# Code generated by make gen. DO NOT EDIT.
|
|
title: "`coder schedule start`"
|
|
description: Edit workspace start schedule
|
|
---
|
|
|
|
<!-- DO NOT EDIT | GENERATED CONTENT -->
|
|
|
|
Edit workspace start schedule
|
|
|
|
## Usage
|
|
|
|
```console
|
|
coder schedule start [flags] <workspace-name> { <start-time> [day-of-week] [location] | manual }
|
|
```
|
|
|
|
## Description
|
|
|
|
```console
|
|
Schedules a workspace to regularly start at a specific time.
|
|
Schedule format: <start-time> [day-of-week] [location].
|
|
* Start-time (required) is accepted either in 12-hour (hh:mm{am|pm}) format, or 24-hour format hh:mm.
|
|
* Day-of-week (optional) allows specifying in the cron format, e.g. 1,3,5 or Mon-Fri.
|
|
Aliases such as @daily are not supported.
|
|
Default: * (every day)
|
|
* Location (optional) must be a valid location in the IANA timezone database.
|
|
If omitted, we will fall back to either the TZ environment variable or /etc/localtime.
|
|
You can check your corresponding location by visiting https://ipinfo.io - it shows in the demo widget on the right.
|
|
|
|
- Set the workspace to start at 9:30am (in Dublin) from Monday to Friday:
|
|
|
|
$ coder schedule start my-workspace 9:30AM Mon-Fri Europe/Dublin
|
|
```
|
|
|
|
## Options
|
|
|
|
### -c, --column
|
|
|
|
| | |
|
|
|---------|---------------------------------------------------------------------------|
|
|
| Type | <code>[workspace\|starts at\|starts next\|stops after\|stops next]</code> |
|
|
| Default | <code>workspace,starts at,starts next,stops after,stops next</code> |
|
|
|
|
Columns to display in table output.
|
|
|
|
### -o, --output
|
|
|
|
| | |
|
|
|---------|--------------------------|
|
|
| Type | <code>table\|json</code> |
|
|
| Default | <code>table</code> |
|
|
|
|
Output format.
|