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

# Busca em Conversas (@session)

> O agente recupera o que foi discutido em sessões salvas anteriores — busca por texto + listagem.

O tool **`@session`** deixa o agente **recuperar conversas passadas** salvas — "o que decidimos sobre o cache semana passada?". Implementado nativamente sobre o [SessionManager](/pt/features/session-management) existente. Inspirado no `session_search` do hermes-agent.

***

## Subcomandos

```text theme={"system"}
<tool_call name="@session" args='{"cmd":"search","args":{"query":"design do rate limiter"}}' />
<tool_call name="@session" args='{"cmd":"list"}' />
```

| Subcomando               | Função                                                                                                         |
| ------------------------ | -------------------------------------------------------------------------------------------------------------- |
| `search {query, limit?}` | busca textual nas sessões salvas; retorna sessões que casam + trechos (`limit` = trechos por sessão, padrão 3) |
| `list`                   | lista os nomes das sessões salvas                                                                              |

***

## Saída

```text theme={"system"}
Sessões que correspondem a "rate limiter":

• proj-acme (2 ocorrências)
    … usei um token bucket para o rate limiter
    … o limite ficou em 1000 rps por chave
```

***

## Notas

* É **read-only** e concurrency-safe.
* Busca tanto no histórico de chat quanto no de agente das sessões salvas.
* Pareie com [Gerenciamento de Sessões](/pt/features/session-management) (`/session save`) para acumular um histórico pesquisável.

<Tip>
  Use junto com `@memory` (fatos) e `@skill` (procedimentos): `@session` é a memória **episódica** ("o que conversamos"), enquanto memória e skills são o conhecimento destilado.
</Tip>