{
  "name": "bare-os-shell",
  "section": 1,
  "title": "Bare OS interactive shell builtins",
  "synopsis": [
    "# builtins only — no full POSIX sh grammar"
  ],
  "description": "The line-at-a-time shell supports aliases, simple pipelines (simulated), redirection, and the builtins below. Compound commands (if, for, while) are not available.",
  "options": [],
  "aliases": [
    "sh-builtins"
  ],
  "keywords": [
    "shell",
    "builtin",
    "cd",
    "export",
    "alias",
    "bare-os-shell",
    "sh-builtins"
  ],
  "builtins": [
    {
      "name": "alias",
      "synopsis": [
        "alias",
        "alias name=value ...",
        "unalias name ..."
      ],
      "description": "Define or list command aliases. unalias removes definitions."
    },
    {
      "name": "cd",
      "synopsis": [
        "cd [DIR]"
      ],
      "description": "Change working directory via vfs.chdir; default is HOME."
    },
    {
      "name": "export",
      "synopsis": [
        "export NAME=value ..."
      ],
      "description": "Set environment variables visible to child /bin invocations."
    },
    {
      "name": "unset",
      "synopsis": [
        "unset NAME ..."
      ],
      "description": "Remove variables; readonly names cannot be unset."
    },
    {
      "name": "readonly",
      "synopsis": [
        "readonly NAME[=value] ..."
      ],
      "description": "Mark variables read-only."
    },
    {
      "name": "umask",
      "synopsis": [
        "umask [octal]"
      ],
      "description": "Show or set shell file creation mask (stored in env UMASK)."
    },
    {
      "name": "command",
      "synopsis": [
        "command -v|-V NAME",
        "command ARGV..."
      ],
      "description": "Resolve or run a command without using shell functions (none) or aliases for -v/-V."
    },
    {
      "name": "type",
      "synopsis": [
        "type NAME"
      ],
      "description": "Report whether NAME is a builtin or a path under PATH."
    },
    {
      "name": "login / logout",
      "synopsis": [
        "login [--new] passphrase...",
        "logout [--save]"
      ],
      "description": "Identity unlock/register and session teardown; require booter hooks."
    },
    {
      "name": ":",
      "synopsis": [
        ":"
      ],
      "description": "No-op builtin."
    },
    {
      "name": "exit",
      "synopsis": [
        "exit [n]"
      ],
      "description": "Request booter exit with status n (builtin path)."
    }
  ],
  "seeAlso": [
    {
      "name": "help",
      "section": 1
    },
    {
      "name": "man",
      "section": 1
    }
  ],
  "bareOsNotes": "Pipelines do not use OS pipes; see handbook ch.4 and ch.9.",
  "examples": [
    {
      "caption": "pipeline (simulated)",
      "code": "ls -1 /bin | grep man"
    },
    {
      "caption": "redirect out",
      "code": "echo hi > ~/hello.txt"
    },
    {
      "caption": "append",
      "code": "date >> ~/log.txt"
    },
    {
      "caption": "alias + use",
      "code": "alias ll='ls -la'\nll ~"
    },
    {
      "caption": "export for children",
      "code": "export EDITOR=ed\nman ls"
    },
    {
      "caption": "temp var for one command",
      "code": "PATH=/bin man which"
    }
  ]
}