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

https://public.heypocketai.com/api/v1

~/.config/pocket-ai/api_key

Core Capabilities

1. Semantic Search (Most Powerful)

Search across ALL recordings by meaning, not just keywords.

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:

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

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

4. List Recordings

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

5. Get Recording Details

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

6. Download Audio

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]?"

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

Business Decisions

"What decisions were made about [topic]?"

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

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

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

Meeting Summaries

"What happened in [meeting type]?"

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

Response Structure

Search Response

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

# 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

#!/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