Command Mode

Command mode is opened with :. It is the main way to run tab switches, page actions, import/export operations, and commands that are easier to express as text.

Command mode keys

• : opens command mode
• Tab completes the current command
• Enter runs the current command
• Esc leaves command mode

Quoting

Commands accept quoted names and paths:

:rename "Books API v2"
:import "My Collections.json"
:mv "Target / Auth Folder"

Use quotes when names or filesystem paths contain spaces.

Completion

Command completion

Tab completes the next command token based on the current page and mode.

Path completion

Tab completes:

• filesystem paths for import PATH
• filesystem paths for export PATH
• Home move and copy destinations for mv PATH and cp PATH

Commands available on every main page

• home
• env
• history
• help
• q

help can also be written as ?.

Home commands

From Home normal mode

• new
• new collection NAME
• new folder NAME
• import PATH
• export PATH
• history
• help
• env
• q

With a request selected

• edit
• rename NAME
• cp PATH
• mv PATH
• close
• del
• send

With a folder selected

• rename NAME
• cp PATH
• mv PATH
• del

With a collection selected

• rename NAME
• cp
• del

Home command notes

• new creates a request
• cp on a collection does not take a destination path
• import PATH on Home imports collections as new copies
• export PATH exports all collections unless a collection is selected
• rename, import, export, cp, mv, and del are restricted when you are inside Home request-editing contexts

Env commands

• home
• env
• history
• new NAME
• rename NAME
• import PATH
• export PATH
• set KEY=value
• del
• del KEY
• edit
• help
• q

Env command notes

• new NAME creates a new env set
• rename NAME renames the selected env set
• set KEY=value writes a key into the current env set
• del KEY deletes an env variable by name
• del deletes the selected env set
• import PATH creates new env set(s) instead of merging into the selected set
• export PATH writes the current env pairs

History commands

• home
• env
• history
• replay
• help
• q

History command notes

• replay is only available on History
• replay uses the selected history entry

Error and usage behavior

If a command is valid but incomplete, piespector reports a usage hint such as:

• Usage: import PATH
• Usage: rename NAME
• Usage: mv PATH

If quoting is broken, command parsing reports:

• Unclosed quote in command.

If a destination cannot be resolved for mv or cp, piespector reports one of:

• Destination not found.
• Destination is ambiguous. Use a fuller path.