For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /configuration/index.md.

Configuration

eggl-cli keeps profiles, port-forwards, and directory aliases in one YAML file.

The default path is:

~/.config/eggl/config.yaml

When XDG_CONFIG_HOME is set, eggl-cli uses $XDG_CONFIG_HOME/eggl/config.yaml instead. Every configuration-aware command also accepts --config to use a different file.

eggl env --config ./eggl.yaml show
eggl pf --config ./eggl.yaml list
eggl cd --config ./eggl.yaml list

The file must contain at least one profile or directory. Port-forwards are optional.

Sections

SectionUsed byRequired fields
profileseggl envkube_context, tailscale_account
port_forwardseggl pfnamespace, resource
directorieseggl cdAlias mapped to a path

See the individual pages for examples and validation rules: