Skill: asabovetech/pocket-ai (version 1.0.1)

# 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.


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: suspicious | SkillSpector: suspicious (CRITICAL)