kosh use

Switch the profile that every other command operates on.

kosh use [profile]

Arguments: zero or one.

Form	Behaviour
kosh use	Interactive picker — type to filter, enter to select, esc to cancel
kosh use <profile>	Switch directly, failing if the profile does not exist

Notes

• No master password is required.
• kosh use does not create profiles. Switching to a name that does not exist fails with profile does not exist — create it with kosh profile create first.
• The choice is written to ~/.kosh/config.json and persists across runs.
• The picker uses plain substring filtering, not the weighted scorer used by kosh search.

Name matching

• Case is ignored. kosh use WORK, kosh use work and kosh use Work all find a profile stored as Work.
• Surrounding whitespace is ignored — kosh use " work " works.
• The match is whole-name, not a prefix or substring. kosh use wor fails with profile does not exist.
• Whatever spelling you type, Kosh switches to the profile under the name it is stored as, and that is the name shown in kosh profile list and in the (profile) output prefix.

use does not clean up names the way create does

Only kosh profile create sanitizes a name. kosh use My-Profile! will not find the My_Profile that create produced from the same input — pass the name exactly as kosh profile list shows it.

Examples

kosh use                     # pick a profile interactively
kosh use work                # switch to an existing profile

kosh profile create work     # create a profile, then switch back
kosh use default

See also

• Profiles — the concept and why profiles are isolated