Skip to main content
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

talkvalue path overview [--tag-id <id>] [--timezone <tz>]

​
Options

FlagTypeDescription
--tag-id <id>integerFilter the overview to a single tag. Tag IDs come from talkvalue path tag create or the dashboard.
--timezone <tz>stringIANA 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

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

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

talkvalue path overview --tag-id 42 --json
Scopes every number to people, channels, and events tagged with 42. Combine with talkvalue path tag attach to maintain tag-scoped reports.

​
Response

{
  "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