AudienceMeter CLI

Speaker feedback, beautifully managed -- from your terminal.

A full-featured terminal UI for AudienceMeter that lets you create, manage, and analyze speaker feedback sessions without leaving the command line.

Install

npm install -g audiencemeter

Or run directly with npx:

npx audiencemeter

Requires Node.js 20+.

Quick Start

# Log in with your AudienceMeter account
audiencemeter login

# Create a feedback session
audiencemeter create

# List your sessions
audiencemeter list

# View session details
audiencemeter show <pin>

Interactive Dashboard

Run audiencemeter with no arguments to launch a full-screen TUI dashboard:

$ audiencemeter

Navigate with Tab or number keys 1-4 between views:

| Tab | View | |-----|------| | 1 | Dashboard -- overview stats | | 2 | Sessions -- browse and drill into sessions | | 3 | Create -- create a new session | | 4 | Auth -- account info |

Press q or Ctrl+C to exit.

Commands

login

Opens your browser for Google OAuth login. Stores the token locally.

audiencemeter login

logout

Clears stored credentials.

audiencemeter logout

auth whoami

Shows your email, user ID, and API endpoint.

audiencemeter auth whoami

create

Create a new feedback session. Interactive by default -- walks you through template selection, session name, date, and duration.

# Interactive
audiencemeter create

# Non-interactive
audiencemeter create --template talk --project "DevFest 2026" --name "My Talk" --duration 45

Once created, you get a PIN, join URL, and QR code to share with your audience:

Templates: talk (45 min), workshop (120 min), lightning (10 min), panel (60 min)

Options: | Flag | Description | |------|-------------| | --template <type> | Session template (talk, workshop, lightning, panel) | | --project <name> | Project name (creates if new) | | --name <name> | Session name | | --date <iso> | Session date (defaults to now) | | --duration <min> | Duration in minutes | | --json | Output raw JSON |

list (alias: ls)

List your feedback sessions. In a TTY, launches an interactive full-screen list with keyboard navigation.

# Interactive list (TTY)
audiencemeter list

# Static table (non-TTY / piped)
audiencemeter list | cat

# JSON output
audiencemeter list --json

Options: | Flag | Description | |------|-------------| | --project <name> | Filter by project | | --limit <n> | Max sessions (default: 20) | | --json | Output raw JSON |

In the interactive list, use arrow keys or j/k to navigate and Enter to view session details. Press Esc or q to go back.

show

View detailed session info with metrics, reaction timeline, and AI analysis.

# By PIN
audiencemeter show <pin>

# By UUID
audiencemeter show <session-id>

# JSON output
audiencemeter show <pin> --json

Options: | Flag | Description | |------|-------------| | --json | Output raw JSON |

delete (alias: rm)

Delete a session. Asks for confirmation unless --force is passed.

audiencemeter delete <session-id>
audiencemeter delete <session-id> --force

JSON Mode

Every command that produces output supports --json for scripting and piping:

# Get session data as JSON
audiencemeter show <pin> --json | jq '.metrics'

# List sessions as JSON array
audiencemeter list --json | jq '.[].pin'

Configuration

Auth tokens are stored locally via conf. Config location follows OS conventions:

• Linux: ~/.config/audiencemeter/config.json
• macOS: ~/Library/Preferences/audiencemeter/config.json
• Windows: %APPDATA%/audiencemeter/config.json

Links

• AudienceMeter -- Home page
• app.audiencemeter.pro -- Web Dashboard (Speakers)

License

MIT