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

# Temporal Cognify

> Run the temporal cognify variant to extract events and timestamps, then query them with the TEMPORAL search type or recall.

## What it does

Runs the temporal variant of the cognify pipeline: instead of (or in addition
to) standard entity/relationship extraction, it extracts **events and
timestamps** so the knowledge graph supports temporal reasoning. Mirrors
Python's `temporal_cognify=True`.

## When to use it

* Your corpus is event-driven (logs, meeting notes, news, changelogs) and you
  want to ask "what happened when?" / "what came before X?".
* You plan to query with temporal recall (see below).

## CLI

```bash theme={null}
cognee-cli cognify -d my_dataset --temporal-cognify
```

The flag is `--temporal-cognify`
([`crates/cli/src/cli.rs`](https://github.com/topoteretes/cognee-rs/blob/main/crates/cli/src/cli.rs), `CognifyArgs`). It maps
to `CognifyConfig.temporal_cognify`.

## Programmatic

```rust theme={null}
use cognee_cognify::CognifyConfig;

let config = CognifyConfig::default()
    .with_temporal_cognify(true);
// also: .with_data_per_batch(n) tunes the temporal batch size (default 20)
```

See [`CognifyConfig`](https://github.com/topoteretes/cognee-rs/blob/main/crates/cognify/src/config.rs) (`temporal_cognify`,
`with_temporal_cognify`, `data_per_batch`).

## Querying temporal memory

Retrieve with the `TEMPORAL` search type:

```bash theme={null}
cognee-cli search "what happened before the launch?" -t TEMPORAL -d my_dataset
# or let recall auto-route to a temporal strategy:
cognee-cli recall "timeline of the project"
```

This uses `SearchType::Temporal` and the temporal retriever
([`crates/search/src/`](https://github.com/topoteretes/cognee-rs/blob/main/crates/search/src/)). The recall router can
auto-select the temporal strategy from the query
([`crates/search/src/query_router.rs`](https://github.com/topoteretes/cognee-rs/blob/main/crates/search/src/query_router.rs)).

## Pointers

* [`CognifyConfig`](https://github.com/topoteretes/cognee-rs/blob/main/crates/cognify/src/config.rs) — `temporal_cognify`.
* [`crates/cli/src/cli.rs`](https://github.com/topoteretes/cognee-rs/blob/main/crates/cli/src/cli.rs) — `--temporal-cognify`, `-t TEMPORAL`.
* [Operations](/rust/operations) — cognify and search stages.
