@terminal49/bridge-cli 0.1.0

package/README.md

@@ -0,0 +1,15 @@
+# @terminal49/bridge-cli
+
+Private npm package containing the Bridge CLI meeting search skill for LLMs.
+
+## Contents
+
+- `SKILL.md` — instructions for using the Bridge CLI to search Fathom meetings.
+
+## Install
+
+```bash
+npm install @terminal49/bridge-cli
+```
+
+Then open `node_modules/@terminal49/bridge-cli/SKILL.md`.

package/SKILL.md

@@ -0,0 +1,150 @@
+---
+name: bridge-meeting-search
+description: Search Terminal49 Fathom meeting transcripts, retrieve meeting details, and browse meeting history using the Bridge CLI. Use when the user asks about meetings, calls, transcripts, what was discussed, action items, customer conversations, or anything related to Terminal49's Fathom video call data. Also use when the user asks to find what a person said, look up a meeting, search call notes, or get meeting summaries.
+---
+
+# Bridge Meeting Search
+
+Search and retrieve meeting data from Terminal49's Fathom.video ingestion platform via the Bridge CLI.
+
+## Prerequisites
+
+The CLI requires authentication. If commands fail with "Not logged in", run:
+
+```bash
+npm run cli:t49bridge -- login
+```
+
+Verify with:
+
+```bash
+npm run cli:t49bridge -- whoami
+```
+
+## Repo Setup
+
+Clone the Bridge repo and install dependencies:
+
+```bash
+git clone https://github.com/Terminal49/bridge.git
+cd bridge
+npm install
+```
+
+## Commands
+
+Run commands from the cloned repo directory.
+
+### Search Transcripts
+
+Three search modes — use `query` (hybrid) by default:
+
+```bash
+# Hybrid search (recommended) — combines keyword + semantic
+npm run cli:t49bridge -- query "<natural language question>" --limit 10
+
+# Keyword search (BM25) — best for exact terms, names, product names
+npm run cli:t49bridge -- search "<keywords>" --limit 10
+
+# Semantic search — best for conceptual/meaning-based queries
+npm run cli:t49bridge -- vsearch "<description of what you're looking for>" --limit 10
+```
+
+#### Search filters (work with all three modes)
+
+```bash
+--company <name>         # Filter by company
+--speaker <name>         # Filter by speaker
+--from <YYYY-MM-DD>      # Start date
+--to <YYYY-MM-DD>        # End date
+--team <name>            # Filter by team
+--meeting-id <id>        # Filter to one meeting
+--meeting-day <date>     # Filter to exact date
+--crm <record>           # Filter by CRM record
+--recent-days <n>        # Boost results from last N days
+--recency-weight <n>     # Recency weight (default: 0.25)
+--limit <n>              # Number of results (default: varies)
+--full-text              # Show full chunk text instead of snippet
+--format <human|llm|json># Output format (use llm for structured NDJSON)
+--include-url            # Include share URL in output
+--json                   # Machine-readable JSON output
+```
+
+### Get Meeting Details
+
+```bash
+# Summary and metadata
+npm run cli:t49bridge -- get <meetingId>
+
+# Just the summary
+npm run cli:t49bridge -- get <meetingId> --summary
+
+# Full transcript
+npm run cli:t49bridge -- get <meetingId> --transcript
+
+# Timestamped segments
+npm run cli:t49bridge -- get <meetingId> --segments
+
+# JSON output
+npm run cli:t49bridge -- get <meetingId> --json
+```
+
+### List Meetings
+
+```bash
+# Recent meetings
+npm run cli:t49bridge -- list --limit 20
+
+# Filter by date, company, host, type
+npm run cli:t49bridge -- list --from 2026-01-01 --to 2026-01-31 --company "Maersk"
+npm run cli:t49bridge -- list --host "akshay" --external --limit 50
+npm run cli:t49bridge -- list --attendee "john@example.com"
+
+# JSON output
+npm run cli:t49bridge -- list --json --limit 100
+```
+
+## Workflow
+
+Follow this sequence to answer questions about meetings:
+
+1. **Search** — Start with `query` using the question as-is:
+   ```bash
+   npm run cli:t49bridge -- query "what pricing concerns did Maersk raise" --limit 10
+   ```
+
+2. **Get details** — Fetch full context for relevant meetings:
+   ```bash
+   npm run cli:t49bridge -- get <meetingId> --summary
+   npm run cli:t49bridge -- get <meetingId> --transcript
+   ```
+
+3. **Narrow** — Add filters if too many results:
+   ```bash
+   npm run cli:t49bridge -- query "pricing" --company "Maersk" --from 2026-01-01 --full-text
+   ```
+
+4. **Browse** — Use `list` to see what meetings happened in a period:
+   ```bash
+   npm run cli:t49bridge -- list --from 2026-01-27 --to 2026-02-02 --external
+   ```
+
+## Output Format
+
+Search results return a mix of summary hits and transcript chunks:
+- Meeting title and meeting ID (use ID with `get`)
+- Summary hits labeled `[summary]` and show a summary/snippet
+- Chunk hits show speaker and timestamp range
+- Sources, rank, and raw score are shown by default
+- Timestamps are printed separately from URLs
+- Share URLs only appear with `--include-url`
+
+Use `--format llm` for NDJSON optimized for LLM ingestion (one JSON per result).
+
+## Tips
+
+- Always use `--` after `cli:t49bridge` to pass flags correctly to the CLI
+- Use `--format llm` when you need structured LLM output
+- Use `--full-text` when snippets aren't enough context
+- Start with `query` (hybrid); fall back to `search` for exact names or `vsearch` for conceptual queries
+- Meeting IDs from search results can be passed directly to `get`

package/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "@terminal49/bridge-cli",
+  "version": "0.1.0",
+  "description": "Bridge CLI meeting search skill for LLMs",
+  "license": "UNLICENSED",
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "files": [
+    "SKILL.md",
+    "README.md"
+  ]
+}