Terminal

The terminal in Kloud Workspace runs on zsh, tailored for a seamless and productive experience with sensible defaults, rich colorization, and integrated tooling.

Components

Prompt

The terminal prompt is powered by starship and blends perfectly with our color theme. Modules are shown based on the specific context of the prompt. For instance, the Python module appears only when your current working directory includes a Python-based project.

Some users find the descriptive prompt to be too noisy. To opt-out of some of the prompt modules, you can set any of the following environment variables to either 1 or true:

• WS_TERMINAL_PROMPT_HIDE_DOCKER_CONTEXT: Hides Docker context info in the prompt.
• WS_TERMINAL_PROMPT_HIDE_HOSTNAME: Hides the container hostname in the prompt.
• WS_TERMINAL_PROMPT_HIDE_KUBERNETES_CONTEXT: Hides current Kubernetes context in the prompt.
• WS_TERMINAL_PROMPT_HIDE_NODEJS_VERSION: Hides active Node.js version in the prompt.
• WS_TERMINAL_PROMPT_HIDE_PYTHON_VERSION: Hides active Python version in the prompt.
• WS_TERMINAL_PROMPT_HIDE_USER: Hides the current user in the prompt.

For example, to disable the Docker and Python modules, you could add the following lines to your deployment:

docker run \
  -e WS_TERMINAL_PROMPT_HIDE_DOCKER_CONTEXT=1 \
  -e WS_TERMINAL_PROMPT_HIDE_PYTHON_VERSION=1 \
  ghcr.io/kloudkit/workspace:v0.1.2

Colorful Output

Many CLI tools feature colorization by default (matching the color theme), enhancing your experience with improved readability.

Clipboard

The workspace provides clipboard utilities that bridge the terminal with the browser's clipboard.

Available Commands

• pbcopy
• pbpaste
• xclip
• xsel
• ws clip paste

# Copy to clipboard
echo "Hello World" | pbcopy
cat file.txt | xclip -sel c
echo "data" | xsel -b

# Paste from clipboard
pbpaste
xclip -o -sel c
xsel -b -o

# Use in pipelines
pbpaste | grep "pattern"
xclip -o | jq .

ℹ️ INFO

All clipboard commands communicate with the VS Code extension running in your browser, bridging the terminal environment with your native clipboard.

All X11 selections (primary, secondary, clipboard) map to the same browser clipboard.

ZSH

The standard shell utilized is zsh, enhanced by the oh-my-zsh framework. Tools and programming languages within the workspace that have corresponding oh-my-zsh plugins are automatically activated for each shell session.

To modify the default set of plugins, adjust the env variables listed below:

• WS_ZSH_PLUGINS: Enables built-in oh-my-zsh plugins.
• WS_ZSH_ADDITIONAL_PLUGINS: Loads additional oh-my-zsh plugins.

Override

docker run \
  -e WS_ZSH_PLUGINS="kubectl npm python pip" \
  ghcr.io/kloudkit/workspace:v0.1.2

Append

docker run \
  -e WS_ZSH_ADDITIONAL_PLUGINS="php" \
  ghcr.io/kloudkit/workspace:v0.1.2

History Search

The workspace includes an interactive history search powered by fzf. Press Ctrl+R to open a fuzzy finder over your shell history.

By default, duplicate entries are removed and event numbers are hidden for a clean, distraction-free list. The following environment variables let you customize the behavior:

• WS_ZSH_FZF_HISTORY_BIND: Key binding that triggers fzf history search.
• WS_ZSH_FZF_HISTORY_ARGS: Default arguments passed to fzf for history search.
• WS_ZSH_FZF_HISTORY_EXTRA_ARGS: Additional arguments appended to the default fzf arguments.
• WS_ZSH_FZF_HISTORY_REMOVE_DUPLICATES: Removes duplicate entries from history search results.
• WS_ZSH_FZF_HISTORY_DATES_IN_SEARCH: Includes ISO 8601 date timestamps in search results.
• WS_ZSH_FZF_HISTORY_EVENT_NUMBERS: Shows event numbers in history search results.
• WS_ZSH_FZF_HISTORY_END_OF_LINE: Moves cursor to end-of-line after selecting a history entry.
• WS_ZSH_FZF_HISTORY_QUERY_PREFIX: Prefix prepended to the fzf query when the buffer is non-empty.