User Interface Guide
Understanding the shellA interface and how to navigate it
User Interface
Documentation
The shellA interface is designed to be intuitive and easy to use. This guide will help you understand the different components of the interface and how to navigate them effectively.
Interface Overview
The shellA interface consists of three main components:

The shellA interface with the File Explorer (left), Workflow Builder (Chat) Panel (center), and Workflow Panel (right).
File Explorer Panel (Left): Shows a preview of your changes and allows you to add and navigate directories.
Workflow Builder (Chat) Panel (Center): Displays the results of your commands before execution.
Workflow Panel (Right): Where you can manage and run your workflows
File Explorer Panel
The File Explorer panel shows your directories and allows you to add and navigate through folders. It also lets you preview and approve a mock up of the transformations the workflow will perform when it is executed.

The File Explorer panel showing folders and files with various icons and indicators.
Navigation
- Browsing: Click on folders to navigate into them
- Breadcrumbs: Use the path at the top to navigate up the folder hierarchy
- Back/Forward: Use the arrow buttons to move through your navigation history
- Home: Click the home icon to return to your home directory
- File Selection: Click on files to select them
- Search: Use search bar to help you find files or folders in the directory
Command Input
The Workflow Builder (Chat) Panel is where you type your natural language commands to interact with shellA.

The Workflow Builder (Chat) Panel with an example command and suggestions.
Entering Commands
- Natural Language: Type commands in everyday language
- Iterate: Contine to converse with shellA to iterate on the desired ouput
Command Examples
"Find all PDFs modified last week"
"Move images to the Photos folder and rename them by date"
"Create a zip archive of the Documents folder"
Command Feedback
- Suggestions: shellA offers suggestions to improve your command
- Clarifications: If your command is ambiguous, shellA will ask for clarification
- Errors: If a command can't be executed, shellA explains why
Workflow Panel
The Workflow Panel shows you your existing workflows and allows you to run, edit, delete, or duplicate them.

The Workflow Panel showing examples of a workflow library
Workflow Operations
- Edit: Allows you to modify the requirements or add a new directory to run the workflow against.
- Run: Executes the workflow on the provided directory
- Duplicate: Allows you to iterate on an existing workflow without modifying the original
- Delete: Removes a workflow from your library
Interaction
- Confirmation: Click "Run" to perform the operation
- Modification: Click "..." and edit
- Delete: Click "..." and delete
File Preview
- Text Files: View transformed content
- Images: See previews
- Documents: Preview PDFs, Office files, etc.
- Media: Play audio and video files