Pocket AI Integration

Transcribe, index, and semantically search all voice recordings, extracting action items and meeting insights for comprehensive conversation intelligence.

Pocket AI Skill

Voice recording transcription, semantic search, and meeting intelligence across all conversations.

Pocket AI captures your meetings, calls, and thoughts via a wearable device, then transcribes and indexes everything for semantic search.

Quick Reference

What	Value
API Base	https://public.heypocketai.com/api/v1
API Key	~/.config/pocket-ai/api_key
Auth	Bearer token
Docs	https://docs.heypocketai.com/docs/api

Core Capabilities

1. Semantic Search (Most Powerful)

Search across ALL recordings by meaning, not just keywords.

bash

curl -s -X POST \
  -H "Authorization: Bearer $(cat ~/.config/pocket-ai/api_key)" \
  -H "Content-Type: application/json" \
  -d '{"query": "your company manufacturing decisions"}' \
  "https://public.heypocketai.com/api/v1/public/search"

Returns:

• userProfile.dynamicContext[] — AI-built insights from all recordings
• relevantMemories[] — Matching transcripts, action items, meeting sections
• Speaker identification, timestamps, relevance scores

2. Action Item Extraction

Pocket AI auto-extracts action items from meetings. Search for them:

bash

curl -s -X POST \
  -H "Authorization: Bearer $(cat ~/.config/pocket-ai/api_key)" \
  -H "Content-Type: application/json" \
  -d '{"query": "action items tasks follow up"}' \
  "https://public.heypocketai.com/api/v1/public/search"

3. List Tags

bash

curl -s -H "Authorization: Bearer $(cat ~/.config/pocket-ai/api_key)" \
  "https://public.heypocketai.com/api/v1/public/tags"

4. List Recordings

bash

curl -s -H "Authorization: Bearer $(cat ~/.config/pocket-ai/api_key)" \
  "https://public.heypocketai.com/api/v1/public/recordings"

5. Get Recording Details

bash

curl -s -H "Authorization: Bearer $(cat ~/.config/pocket-ai/api_key)" \
  "https://public.heypocketai.com/api/v1/public/recordings/{recording_id}"

6. Download Audio

bash

curl -s -H "Authorization: Bearer $(cat ~/.config/pocket-ai/api_key)" \
  "https://public.heypocketai.com/api/v1/public/recordings/{recording_id}/audio"

---

High-Value Query Patterns

Contact Context

"What has been discussed with [person]?"

json

{"query": "conversations with Dylan Acquisition.com"}
{"query": "Adrienne intercompany invoices discussion"}
{"query": "meetings with Charlene"}

Business Decisions

"What decisions were made about [topic]?"

json

{"query": "your company manufacturing team restructuring decisions"}
{"query": "entity streamlining strategy"}
{"query": "trading system rules discussed"}

Action Items & Follow-ups

"What needs to be done?"

json

{"query": "action items tasks todo follow up"}
{"query": "scheduled meetings upcoming"}
{"query": "things to review or approve"}

Personal Insights

"What have I said about [topic]?"

json

{"query": "trading psychology patience discipline"}
{"query": "family financial planning kids college"}
{"query": "team performance frustrations"}

Meeting Summaries

"What happened in [meeting type]?"

json

{"query": "your company staff meeting summary"}
{"query": "financial review discussion"}
{"query": "geopolitical analysis conversation"}

---

Response Structure

Search Response

json

{
  "success": true,
  "data": {
    "userProfile": {
      "dynamicContext": [
        "AI-built insight from recordings...",
        "Another pattern detected..."
      ],
      "staticFacts": []
    },
    "relevantMemories": [
      {
        "content": "Transcript segment or action item...",
        "metadata": {"source": "turbopuffer", "sources": ["transcript_segment", "action_item"]},
        "recordingDate": "2026-01-28 01:16:14",
        "recordingId": "uuid",
        "recordingTitle": "Untitled Recording",
        "relevanceScore": 8.19,
        "speakers": "SPEAKER_00, SPEAKER_01",
        "transcriptionId": "uuid"
      }
    ],
    "total": 8,
    "timing": 490
  }
}

Memory Content Types

• Transcript segment: [timestamp] SPEAKER_XX: actual words spoken
• Action item: Action item: Do the thing
• Meeting section: (start-end) Section Title - Summary of what was discussed

---

Integration Points

Athena (Family Agent)

• Query meeting context to understand your bandwidth
• "Am I free?" → Check if recent recordings show heavy commitments
• Feed meeting insights into scheduling decisions

Daily Briefings

• Pull action items from yesterday's meetings
• Summarize key decisions made
• Flag urgent follow-ups

Task Management

• Auto-surface action items as potential tasks
• Cross-reference with existing todo lists
• Track what's been mentioned but not yet acted on

Operations Channel

• Post important decisions to #operations
• Alert on critical discussions (team changes, financial decisions)

---

Tags (Your Categories)

Current tags: ai, business, call, economy, finance, game, geopolitics, hockey, outlook, personal, sales, summary, test, victory, weather, work

Use tags to filter or categorize queries.

---

Heartbeat Integration

During heartbeats, optionally check for new action items:

python

# Check for recent action items (last 24h)
query = "action items from today"
# Parse response for new follow-ups
# Surface anything urgent

---

Privacy & Security

• All recordings encrypted end-to-end
• Stored on US servers
• API key should remain in ~/.config/pocket-ai/api_key
• Never log full transcripts to public channels

---

Troubleshooting

Empty recordings list?

• Recordings may need device sync before API access
• Use search endpoint instead (works with synced transcripts)

Auth errors?

• Check Bearer token format: Authorization: Bearer pk_xxx
• Verify key in ~/.config/pocket-ai/api_key

Search returns nothing?

• Try broader query terms
• Check if recordings have been synced recently

---

Helper Scripts

search.sh

bash

#!/bin/bash
# Usage: ./search.sh "your query"
API_KEY=$(cat ~/.config/pocket-ai/api_key)
curl -s -X POST \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"query\": \"$1\"}" \
  "https://public.heypocketai.com/api/v1/public/search"

Python Helper

See pocket_api.py for full Python integration.