> ## Documentation Index
> Fetch the complete documentation index at: https://agno-v2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Chat History

> Retrieve an agent's stored conversation messages with get_chat_history().

Retrieve the messages from an agent's conversation with `get_chat_history()`.

## Code

```python chat_history.py theme={null}
from agno.agent import Agent
from agno.db.sqlite import SqliteDb
from agno.models.openai import OpenAIResponses

db = SqliteDb(db_file="tmp/agent.db")

agent = Agent(
    model=OpenAIResponses(id="gpt-5.2"),
    db=db,
    session_id="chat_history",
    instructions="You are a helpful assistant that can answer questions about space and oceans.",
    add_history_to_context=True,
)

agent.print_response("Tell me a new interesting fact about space", stream=True)
print(agent.get_chat_history())

agent.print_response("Tell me a new interesting fact about oceans", stream=True)
print(agent.get_chat_history())
```

## Usage

**1. Create a Python file**

Create `chat_history.py` with the code above.

<Snippet file="create-venv-step.mdx" />

**2. Install dependencies**

```bash theme={null}
uv pip install -U agno openai sqlalchemy
```

**3. Export your OpenAI API key**

```bash Mac/Linux theme={null}
export OPENAI_API_KEY="your_openai_api_key_here"
```

```bash Windows theme={null}
$Env:OPENAI_API_KEY="your_openai_api_key_here"
```

**4. Run Agent**

```bash theme={null}
python chat_history.py
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.