Limitless CLI Skill Skill

Limitless CLI Skill

A comprehensive CLI tool for interacting with Limitless.ai Pendant data, featuring FalkorDBLite semantic graph with vector embeddings, content extraction, and DAG pipelines.

When to Use

User wants semantic search across lifelogs, chats, persons, or topics
User wants to query lifelogs or personal memory data
User wants to extract entities (speakers, topics) from conversations
User wants to sync lifelogs to a graph database
User wants to run extraction or analysis pipelines
User mentions "Limitless", "pendant", "lifelog", or "personal memory"
User needs domain-specific extraction (medical, technical, business)

Quick Start

Semantic Search (Recommended)

# Semantic search across lifelogs (vector-based similarity)
limitless semantic-search "ICU critical care discussion" --types Lifelog --scores

# Search multiple node types
limitless semantic-search "family doctor" --types Lifelog,Chat,Person --limit 10

# Hybrid search (semantic + full-text)
limitless search "medical exam" --mode hybrid

# Check index status (embeddings, node counts)
limitless index status

Graph Queries

# Cypher query on semantic graph
limitless graph query "MATCH (p:Person)-[:SPOKE_IN]->(l:Lifelog) RETURN p.name, count(l) ORDER BY count(l) DESC LIMIT 10"

# Graph statistics
limitless graph stats

Basic Operations

# List recent lifelogs
limitless lifelogs list --limit 10

# Search for topic (full-text)
limitless lifelogs search "topic"

# Get specific lifelog
limitless lifelogs get <id> --format json

Architecture

FalkorDBLite Semantic Graph

The CLI uses an embedded FalkorDBLite graph database (no Docker required) with vector embeddings for semantic search.

| Component | Details | |-----------|---------| | Database | FalkorDBLite via Python service | | Socket | ~/.limitless/falkordb.sock (Unix domain) | | Embeddings | BGE-small-en-v1.5 (384-dim, FastEmbed) | | Vector Indexes | Lifelog, Chat, Person, Topic |

Graph Statistics (as of 2026-01-11):

95,021 nodes (8,777 Lifelogs, 2,608 Chats, 1,549 Persons, 33,024 Topics, 47,027 Speakers)
81,356 relationships (SPOKE_IN, HAS_TOPIC, HAS_CONTACT)
100% embedding coverage on searchable nodes

Core Commands

| Command | Purpose | |---------|---------| | semantic-search <query> | Vector similarity search | | search <query> --mode hybrid | Combined semantic + full-text | | index status | Show node counts, embeddings | | graph query <cypher> | Execute Cypher queries | | lifelogs list/search/get | Basic lifelog operations |

References (Load on Demand)

API Reference: Rate limiting (180 req/min), retry logic
Database Schema: Node types, relationships, vector indexes
Extraction Rules: Rule-based and LLM extraction patterns
Pipeline DSL: YAML syntax, node types, templates

Command Reference

Semantic Search (Primary)

# Vector-based semantic search
semantic-search <query> [--types Lifelog,Chat,Person,Topic] [--limit N] [--threshold 0.15] [--scores] [--json]

# Hybrid search (semantic + full-text)
search <query> [--mode semantic|fulltext|hybrid] [--types ...] [--limit N] [--json]

# Index management
index status                    # Show node counts, embeddings, vector indexes
index build --export-path <path> # Build from Limitless export

Graph Database

graph query <cypher> [--json]   # Execute Cypher query
graph stats                     # Show database statistics
graph traverse <label> <id>     # Traverse from node

Lifelogs

lifelogs list [--date YYYY-MM-DD] [--starred] [--limit N] [--json]
lifelogs get <id> [--json]
lifelogs search <query> [--limit N] [--json]

Pipelines

pipeline run <template|file> [--var key=value]
pipeline list       # List available templates

Available templates:

daily-digest.yaml - Daily lifelog summary
weekly-review.yaml - Comprehensive weekly analysis
hierarchical-extraction.yaml - Full entity extraction
session-extraction.yaml - Session detection
extract-actions.yaml - Action item extraction
memory-query.yaml - Context-augmented response
research.yaml - Lifelog + web synthesis

Workflows

workflow daily <date>    # Complete day snapshot
workflow search <query>  # Cross-source search
workflow recent          # Recent activity summary

Domain Extraction Pattern

For domain-specific extraction, use this configurable pattern:

// Define domain patterns
const patterns = [
  { pattern: /ondansetron/gi, category: '5HT3 antagonist', displayName: 'Ondansetron' },
  { pattern: /droperidol/gi, category: 'Dopamine antagonist', displayName: 'Droperidol' },
];

// Filter lifelogs by domain keywords
const filtered = lifelogs.filter(l =>
  patterns.some(p => p.pattern.test(l.markdown))
);

// Extract using rule-based extraction
const results = extractFromLifelog(lifelog);

// Sync to graph with graceful degradation
try {
  await dbClient.connect();
  await lifelogRepo.upsert(lifelog);
} catch (error) {
  console.log(`⚠️ Graph sync skipped: ${error.message}`);
}

See references/extraction-rules.md for the full pattern library.

Environment Variables

LIMITLESS_API_KEY       # Required - API authentication
ANTHROPIC_API_KEY       # Optional - For LLM extraction
FALKORDB_HOST          # Default: localhost
FALKORDB_PORT          # Default: 6379

Graceful Degradation

The CLI handles missing dependencies gracefully:

| Dependency | If Missing | |------------|------------| | FalkorDB | Continues without graph sync, warns user | | Anthropic API | Falls back to rule-based extraction | | Docker | Uses remote FalkorDB if configured |

Troubleshooting

"FalkorDBLite service not running"

The Python service auto-starts on first use
Manual start: cd ~/Projects/limitless-cli/python && uv run python -m limitless_graph.server
Check socket: ls ~/.limitless/falkordb.sock

"No results from semantic search"

Lower threshold: --threshold 0.1 (BGE scores are typically 0.15-0.35)
Check embeddings: limitless index status
Try different node types: --types Lifelog,Chat,Person,Topic

"Rate limited (429)"

Wait for rate limit window (180 req/min, refills 3/sec)
Check: config show for current settings

Integration with Other Skills

This skill integrates with:

context-orchestrator: Use /limitless command for personal memory context
error-recovery: Graceful degradation patterns applied
deep-research: Combine with web research for synthesis pipelines

Project Location

~/Projects/limitless-cli/
├── src/
│   ├── api/           # Rate-limited API client (180 req/min)
│   ├── db/            # FalkorDB repositories (9 repos)
│   ├── dag/           # Pipeline engine (YAML DSL)
│   ├── extraction/    # Rule + LLM extraction
│   ├── agent/         # Claude Agent SDK harness
│   └── cli/           # Commander.js commands
├── templates/         # 7 pipeline templates
└── scripts/           # Demo and utility scripts

Agent Skills: Limitless CLI Skill

Install this agent skill to your local

Skill Files