The interactive shell¶

Run sx with no command, and you get a prompt instead of a single answer:

/ ❯ cd /docs
/docs ❯ ls

The shell keeps one live session, so cd persists between commands. That is the whole reason it exists: a one-shot sx cd /docs would change directory and then exit, which is not a useful thing to do.

The prompt is only the cwd. Who you are connected to and what wraps the session are stable facts, so the banner states them once and whereami reprints them on demand, rather than prefixing every line with a label that grows with each layer.

sx --interactive (or -i, or sx shell) does the same thing explicitly, which is what you want when you also pass connection flags:

sx -p azure --cache -i

Tab completion¶

Tab completes command names and remote paths. Directories complete with a trailing slash, so you can walk straight down a tree without a ls between each step.

Completion sources a live listing, so an active cache layer makes repeats instant. On a cloud backend that is the difference between a prompt that feels local and one that pauses on every Tab.

Built-ins¶

Five names are handled by the shell itself rather than dispatched to a storage command:

Knowing what you are connected to¶

The banner names what the session opened, including the profile and stage when one is selected:

storix shell
connected to AzureBackend as media (stage: prod)
cache ls/stat/du/cat via InMemoryCacheStore · type refresh to clear
type 'help' for commands, 'whereami' for this session, 'exit' to quit

whereami reprints it at any point, with more detail:

/ ❯ whereami
backend:  AzureBackend
profile:  media (stage: prod)
root uri: abfss://[email protected]/
cwd:      /
home:     /
layers:   cache ls/stat/du/cat via InMemoryCacheStore

Aliases at the prompt¶

Aliases work in the shell exactly as they do one-shot, and completion lists them alongside the real commands with their target as the description. They are configured once in a config file; see Preferences and layers.

sx --cache            # this session

[tool.storix.cli]
layers = [{ name = "cache", ttl = 300 }]   # every session