audiencemeter 0.1.0

package/README.md

@@ -0,0 +1,202 @@
+# AudienceMeter CLI
+
+**Speaker feedback, beautifully managed** -- from your terminal.
+
+A full-featured terminal UI for [AudienceMeter](https://audiencemeter.pro) that lets you create, manage, and analyze speaker feedback sessions without leaving the command line.
+
+![AudienceMeter Dashboard](images/dashboard_with_tabs.png)
+
+## Install
+
+```bash
+npm install -g audiencemeter
+```
+
+Or run directly with npx:
+
+```bash
+npx audiencemeter
+```
+
+Requires Node.js 20+.
+
+## Quick Start
+
+```bash
+# 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
+```
+
+![Interactive Dashboard](images/dashboard_with_tabs.png)
+
+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.
+
+```bash
+audiencemeter login
+```
+
+### `logout`
+
+Clears stored credentials.
+
+```bash
+audiencemeter logout
+```
+
+### `auth whoami`
+
+Shows your email, user ID, and API endpoint.
+
+```bash
+audiencemeter auth whoami
+```
+
+![Auth Tab](images/authentication_whoami_tab.png)
+
+### `create`
+
+Create a new feedback session. Interactive by default -- walks you through template selection, session name, date, and duration.
+
+```bash
+# Interactive
+audiencemeter create
+
+# Non-interactive
+audiencemeter create --template talk --project "DevFest 2026" --name "My Talk" --duration 45
+```
+
+![Create Session - Interactive Prompts](images/create_session_2.png)
+
+Once created, you get a PIN, join URL, and QR code to share with your audience:
+
+![Session Created with QR Code](images/create_session_3_with_qr.png)
+
+**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.
+
+![Session List](images/session_list.png)
+
+```bash
+# 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.
+
+![Session Detail](images/audiencemeter_show_command.png)
+
+```bash
+# 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.
+
+```bash
+audiencemeter delete <session-id>
+audiencemeter delete <session-id> --force
+```
+
+## JSON Mode
+
+Every command that produces output supports `--json` for scripting and piping:
+
+```bash
+# 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](https://github.com/sindresorhus/conf). Config location follows OS conventions:
+
+- **Linux:** `~/.config/audiencemeter/config.json`
+- **macOS:** `~/Library/Preferences/audiencemeter/config.json`
+- **Windows:** `%APPDATA%/audiencemeter/config.json`
+
+## Links
+
+- [AudienceMeter](https://audiencemeter.pro) -- Home page
+- [app.audiencemeter.pro](https://app.audiencemeter.pro) -- Web Dashboard (Speakers)
+
+## License
+
+MIT

package/bin/audiencemeter.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../dist/index.js';