Skip to content

Getting Started โ€‹

Learn how to navigate the Tortal Tech Shell and perform your first tasks.


๐ŸŸข Your First Commands โ€‹

sh
help        # List all available commands
about       # Overview of the shell features
ls          # List files in the current directory

๐Ÿ“ฆ Command Structure โ€‹

Most commands follow this pattern:

sh
command [options] [arguments]

Examples:

sh
ls -l                  # Long listing
cat file.txt           # View file contents
echo "Hello" >> out    # Append text to a file

๐Ÿ“ Navigating the File System โ€‹

  • ls โ€“ List files and directories
  • cd folder โ€“ Change directory
  • pwd โ€“ Show current directory path
  • mkdir name โ€“ Create directory
  • tree โ€“ Display folder hierarchy

โœ๏ธ Creating and Editing Files โ€‹

sh
touch notes.txt                 # Create file
echo "Hello" >> notes.txt       # Append text
cat notes.txt                   # View contents
edit notes.txt                  # Open editor
cp notes.txt backup.txt         # Copy file
mv notes.txt renamed.txt        # Rename
rm renamed.txt                  # Delete file

๐Ÿงพ Running Scripts โ€‹

sh
# Create a script
echo "echo Hello, $1" > greet.sh

# Run it with an argument
run greet.sh World

Inside scripts, arguments are available as $1, $2, etc.


โŒจ๏ธ Input, History, and Autocomplete โ€‹

  • read name "Prompt" โ€“ Prompt for user input
  • Use โ†‘ / โ†“ to browse history
  • Press Tab to auto-complete file or command
  • Press Ctrl+C to cancel a running command or input

๐Ÿง  Get Help โ€‹

Type help or help command_name for usage info:

sh
help grep
help run

๐Ÿš€ Demo Project โ€‹

Use this command to generate a sample playground:

sh
template

This includes example folders and scripts.


โœ… Next Steps โ€‹

  • Try piping and chaining: cat file | grep hello && echo found
  • Explore scripting: loops, conditionals, functions
  • Customize your env: export NAME=Alice

Happy scripting!