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

# talkvalue path overview

> Dashboard summary stats for the active workspace: people, channels, events, and growth signals.

Print the dashboard summary numbers you see on the TalkValue home screen (people, channels, events, companies, plus diversification, growth, and retention signals) for the active workspace. Use `--tag-id` to scope the snapshot to a single tag.

## Synopsis

```bash theme={null}
talkvalue path overview [--tag-id <id>] [--timezone <tz>]
```

## Options

| Flag              | Type    | Description                                                                                          |
| ----------------- | ------- | ---------------------------------------------------------------------------------------------------- |
| `--tag-id <id>`   | integer | Filter the overview to a single tag. Tag IDs come from `talkvalue path tag create` or the dashboard. |
| `--timezone <tz>` | string  | IANA timezone override (for example, `America/Los_Angeles`). Defaults to the workspace timezone.     |

A `stats` subcommand returns a slightly different shape with top channels and the latest trend. Run `talkvalue path overview stats --help` for its options.

## Examples

### 1. Snapshot in the terminal

```bash theme={null}
talkvalue path overview
```

Prints the workspace totals as a table: people, channels, events, companies, new people this month, plus growth and retention deltas.

### 2. Pull totals into a script

```bash theme={null}
talkvalue path overview --json | jq '.data | {peopleCount, eventCount, newPeopleThisMonth}'
```

Returns just the headline counts. Drop the `jq` filter for the full envelope.

### 3. Filter by tag

```bash theme={null}
talkvalue path overview --tag-id 42 --json
```

Scopes every number to people, channels, and events tagged with `42`. Combine with [`talkvalue path tag attach`](/cli/commands/path/tag/attach) to maintain tag-scoped reports.

## Response

```jsonc theme={null}
{
  "data": {
    "eventCount": 18,
    "peopleCount": 4321,
    "channelCount": 12,
    "newPeopleThisMonth": 187,
    "totalCompanies": 642,
    "diversification": { /* … */ },
    "growth": { /* … */ },
    "retention": { /* … */ }
  }
}
```

`diversification`, `growth`, and `retention` are nested objects that match the dashboard's overview cards: channel mix, registration trend, and return-visit signals. Inspect each subtree to compose richer reports.

## See also

* [`talkvalue path person list`](/cli/commands/path/person/list). Drill into the people behind `peopleCount`.
* [`talkvalue path event list`](/cli/commands/path/event/list). List the events behind `eventCount`.
* [`talkvalue path analysis channel-attribution`](/cli/commands/path/analysis/channel-attribution). Channel-level revenue and reach.
* [Registration trend](/path/analytics/registration-trend). The dashboard surface this command mirrors.