> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blocks.team/llms.txt
> Use this file to discover all available pages before exploring further.

# bash

The `bash` module can be used to execute arbitrary bash commands in your agent's runtime environment. The `bash` module is stateless, so if you need a stateful bash session, use the [experiemental\_bash](/sdk/experimental-bash) module.

## Example Usage

<CodeGroup>
  ```python python theme={null}
  from blocks import bash

  email = "user@example.com"
  bash(f"git config --global user.email {email}")
  ```
</CodeGroup>

### Arguments

<ResponseField name="command" type="string" required>
  The bash command to execute.
</ResponseField>

<ResponseField name="suppress_exception" type="bool">
  If `true`, suppresses exceptions raised by the command.
</ResponseField>