# set_terminal_progress

> **Function** in `deepagents_code`

📖 [View in docs](https://reference.langchain.com/python/deepagents-code/terminal_escape/set_terminal_progress)

Set the terminal's `OSC 9;4` progress indicator.

Fires unconditionally — terminals that don't recognize `OSC 9;4` silently
ignore the sequence. Set `DEEPAGENTS_CODE_NO_TERMINAL_ESCAPE=1` to opt out
entirely.

## Signature

```python
set_terminal_progress(
    progress: int | None = None,
    *,
    state: TerminalProgressState = TerminalProgressState.NORMAL,
) -> bool
```

## Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `progress` | `int \| None` | No | Percentage `0-100` for determinate states. Ignored for `INDETERMINATE` and `CLEAR`. (default: `None`) |
| `state` | `TerminalProgressState` | No | One of `TerminalProgressState`. (default: `TerminalProgressState.NORMAL`) |

## Returns

`bool`

`True` if the sequence was written.

---

[View source on GitHub](https://github.com/langchain-ai/deepagents/blob/0412009c5441bef8d75a427e1da8909e33ab5b56/libs/code/deepagents_code/terminal_escape.py#L194)