# Chalk CLI Reference: Offline Queries
source: https://docs.chalk.ai/cli#offline-queries

Submit and manage [offline queries](https://docs.chalk.ai/docs/training-client) for batch feature computation. Offline queries process historical data and can be used to generate training datasets.

## `chalk offline-queries list`
source: https://docs.chalk.ai/cli?command=offline_queries_list

```bash
chalk offline-queries list
```

List recent offline query executions with optional filtering

**Flags**

- `--id <id>` (string)
  Filter by offline query ID (partial match).
- `--branch <branch>` (string)
  Filter by branch name.
- `--agent-id <agent-id>` (string)
  Filter by agent ID.
- `--status <status>` (string)
  Filter by status (e.g., COMPLETED, FAILED, WORKING, QUEUED, CANCELED).
- `--kind <kind>` (string)
  Filter by query kind (e.g., OFFLINE_QUERY, ASYNC_OFFLINE_QUERY, CRON_OFFLINE_QUERY, DATASET_INGESTION, AGGREGATION_BACKFILL, TRAINING_JOB).
- `--query-name <query-name>` (string)
  Filter by query name.
- `--query-name-version <query-name-version>` (string)
  Filter by query name version.
- `--duration <duration>` (string, default `24h`)
  Time window to search (e.g., 1h, 24h, 7d).
- `--limit <limit>` (int, default `100`)
  Maximum number of results to return.

## `chalk offline-queries get`
source: https://docs.chalk.ai/cli?command=offline_queries_get

```bash
chalk offline-queries get [offline-query-id]
```

Retrieve detailed information about a specific offline query by its ID

**Arguments**

- `offline-query-id` (string)
  The ID of the offline query to retrieve

## `chalk offline-queries cancel`
source: https://docs.chalk.ai/cli?command=offline_queries_cancel

```bash
chalk offline-queries cancel [offline-query-id]
```

Cancel an in-progress async offline query by its ID

**Arguments**

- `offline-query-id` (string)
  The ID of the offline query to cancel

## `chalk offline-queries performance_summary`
source: https://docs.chalk.ai/cli?command=offline_queries_performance_summary

```bash
chalk offline-queries performance-summary [offline-query-id]
```

Retrieve shard-level performance summaries for a specific offline query

**Arguments**

- `offline-query-id` (string)
  The ID of the offline query to retrieve performance summaries for

## `chalk offline-queries retry`
source: https://docs.chalk.ai/cli?command=offline_queries_retry

```bash
chalk offline-queries retry [offline-query-id]
```

Download the request body for a specific offline query and re-execute it verbatim by submitting to the remote endpoint

**Arguments**

- `offline-query-id` (string)
  The ID of the offline query to retry

## `chalk offline-queries stage_retry`
source: https://docs.chalk.ai/cli?command=offline_queries_stage_retry

```bash
chalk offline-queries stage-retry [offline-query-id]
```

Download and save the request body for a specific offline query to a JSON file for inspection or later submission

**Arguments**

- `offline-query-id` (string)
  The ID of the offline query to download

**Flags**

- `--output <output>` (string, default `offline_query_request.json`)
  Output file path for the downloaded request.
