Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.piebald.ai/llms.txt

Use this file to discover all available pages before exploring further.

Available in Piebald Basic (Free) Terminal commands fall into three different categories of safety:
  • read-only commands like pwd, ls, and cd
  • read-write commands like touch, sed, and commands with the redirection operator (e.g. echo abc > test.txt)
  • destructive commands like rm.
Piebald has permission modes that roughly match all three of these categories
  • The Read-only permission mode is read-only, so only read-only terminal commands should be allowed.
  • The Auto-Accept mode allows reads and file writes, so read-write commands should be allowed.
  • Of course, in YOLO mode, all commands, including destructive ones, are allowed.
Commands are automatically approved in the Read-only and Auto-Accept modes at a very fine-grained level—commands are parsed and only approved if they match the selected permission mode. Some commands—like sed—can be safe and unsafe by adding or removing command line switches. We’re planning to add a complete description of what commands get automatically approved and when they get approved in the near future.