Utilities & Meta

Utility commands for configuration, aliases, contexts, and system information.

alias set

Set a command alias. Aliases expand the first argument before parsing.

strait alias set st stats

alias list

List all configured aliases.

strait alias list

alias delete

Delete a command alias.

strait alias delete st

context create

Create or update a named context for connecting to different servers or projects.

Flag	Type	Description
--server	string	Server URL
--project	string	Default project
--format	string	Output format
--api-key	string	API key (stored securely in keychain)

strait context create production --server https://strait.dev --project main

context use

Set the active context.

strait context use production

context list

List all available contexts.

strait context list

context current

Show the settings of the currently active context.

strait context current

profile

Capture a pprof profile from the running server.

Flag	Type	Default	Description
--output, -o	string		Output file path
--duration	duration	30s	Profile duration
--type	string	cpu	Profile type (cpu, heap, goroutine, allocs, block, mutex, threadcreate)

strait profile --type heap --output heap.prof

api

Call raw API endpoints directly.

Flag	Type	Default	Description
--header	string[]		Custom HTTP headers
--field	string[]		Request body fields

strait api POST /v1/runs --field project=default --field job=my-job

run

Run a command with strait context environment variables injected.

strait run -- env | grep STRAIT

Injected variables include STRAIT_SERVER, STRAIT_API_KEY, and others from the active context.

send

Send a raw event payload to the server.

Flag	Type	Default	Description
--data	json		Event payload data

strait send my-event --data '{"key": "value"}'

wait run

Wait for a specific run to reach a certain condition.

Flag	Type	Default	Description
--for	string	status=completed	Condition to wait for
--timeout	duration	5m	Maximum wait time
--interval	duration	2s	Check interval

strait wait run <run_id> --for status=failed

wait queue

Wait for the queue to reach a specific state.

Flag	Type	Default	Description
--empty	bool	false	Wait for the queue to be empty
--timeout	duration	10m	Maximum wait time
--interval	duration	2s	Check interval

strait wait queue --empty

version

Print version information.

Flag	Type	Default	Description
--short	bool	false	Print only the version number
--json	bool	false	Output in JSON format
--check-server	bool	false	Check server version
--check-update	bool	false	Check for CLI updates

strait version --check-server

completion

Generate shell completion scripts.

strait completion zsh > ~/.zshrc.d/_strait

Supported shells: bash, zsh, fish, powershell.

docs

Generate CLI documentation.

Flag	Type	Default	Description
--man	bool	false	Generate man pages
--markdown	bool	false	Generate Markdown documentation

strait docs --markdown

upgrade

Upgrade the CLI to the latest version.

strait upgrade

extension list

List discovered CLI extensions.

strait extension list

extension run

Run a CLI extension.

strait extension run my-ext

Extensions are executables named strait-<name> found in your PATH.

Was this page helpful?

On this page