Nex Life Logger

AI-powered local activity tracker. Your agent remembers everything you did on your computer. All activity data stays on your machine. LLM features require explicit configuration.

When to Use

Use this skill when the user asks about:

• Their browsing history, what websites they visited
• What they were working on yesterday, last week, this month
• Their computer activity or screen time
• Time spent on specific topics, websites, or applications
• YouTube videos they watched and what was discussed in them
• Their productivity patterns or how they spent their time
• Searching their personal history for anything (tools, topics, projects)
• Generating summaries of their activity (daily, weekly, monthly)
• Keywords, topics, or tools they've been using
• Exporting their activity data

Trigger phrases: "what was I doing", "browsing history", "computer activity", "what did I work on", "time spent", "YouTube watch history", "productivity", "what I did yesterday", "last week", "search my history"

Quick Setup

If the database does not exist yet, run the setup script:

bash setup.sh

This creates the data directory, installs dependencies in a virtual environment, initializes the database, and starts the background collector service.

Available Commands

The CLI tool is nex-life-logger. All commands output plain text.

Search

FTS5-powered full-text search across all tracked data with filters and relevance ranking:

nex-life-logger search "docker containers"
nex-life-logger search "machine learning" --since 2026-03-01 --until 2026-04-01
nex-life-logger search "react" --kind url --source chrome --limit 50
nex-life-logger search "python" --kind app_focus
nex-life-logger search "kubernetes" --category tool
nex-life-logger search "AI agents" --output json

Search filters:

• --kind: Filter activities by type (url, search, youtube, app_focus)
• --source: Filter activities by browser/source (chrome, edge, brave, firefox, window)
• --category: Filter keywords by category (topic, tool, language, project, domain, search)
• --limit: Max results per section (default: 30)
• --since / --until: Date range (ISO format)
• --output json: Machine-readable JSON output for programmatic use

Summaries

View AI-generated summaries:

nex-life-logger summary daily
nex-life-logger summary daily --date 2026-04-03
nex-life-logger summary weekly
nex-life-logger summary monthly
nex-life-logger summary yearly

Activities

View recent raw activities:

nex-life-logger activities --last 2h
nex-life-logger activities --last 1d
nex-life-logger activities --since 2026-04-03 --until 2026-04-04
nex-life-logger activities --kind youtube
nex-life-logger activities --kind search
nex-life-logger activities --kind app_focus

Keywords

View extracted keywords and topics:

nex-life-logger keywords --top 20
nex-life-logger keywords --category tool
nex-life-logger keywords --since 2026-04-01

Transcripts

View YouTube video transcripts:

nex-life-logger transcript <video_id>
nex-life-logger transcripts --last 7d

Statistics

nex-life-logger stats
nex-life-logger stats --date 2026-04-03

Generate Summaries

Generate AI summaries on demand (requires LLM configuration):

nex-life-logger generate daily
nex-life-logger generate weekly
nex-life-logger generate monthly --date 2026-03-01

Export

nex-life-logger export json --output export.json
nex-life-logger export csv --output activities.csv
nex-life-logger export html --output report.html

Service Management

nex-life-logger service status
nex-life-logger service start
nex-life-logger service stop
nex-life-logger service logs

Configuration

nex-life-logger config show
nex-life-logger config set-api-key
nex-life-logger config set-provider openai
nex-life-logger config set-model gpt-4o
nex-life-logger config set-api-base https://api.openai.com/v1
nex-life-logger config set-poll-interval 60
nex-life-logger config rebuild-fts

The rebuild-fts command rebuilds the FTS5 search indexes from scratch. Run this after importing data, syncing the database from another machine, or if search results seem incomplete.

Example Interactions

User: "What was I working on yesterday afternoon?"

Agent runs: nex-life-logger activities --last 1d --kind url and nex-life-logger activities --last 1d --kind app_focus

Agent: Presents the activities naturally, grouping by topic.

User: "How much time did I spend on YouTube this week?"

Agent runs: nex-life-logger activities --last 7d --kind youtube

Agent: Counts the YouTube entries and presents a summary.

User: "Show me my productivity summary for last week"

Agent runs: nex-life-logger summary weekly

Agent: Presents the weekly summary if it exists, or runs nex-life-logger generate weekly first.

User: "What were the main topics I researched in March?"

Agent runs: nex-life-logger keywords --since 2026-03-01 --top 20

Agent: Lists the top keywords and topics.

User: "Search my history for anything related to Docker"

Agent runs: nex-life-logger search "docker"

Agent: Presents matching activities, summaries, and transcripts ranked by relevance.

User: "What Docker stuff did I look at in Chrome specifically?"

Agent runs: nex-life-logger search "docker" --kind url --source chrome

Agent: Shows only Chrome browsing results related to Docker.

User: "What YouTube videos did I watch about machine learning?"

Agent runs: nex-life-logger search "machine learning" --kind youtube

Agent: Lists the videos and summarizes what was discussed based on transcript snippets.

User: "Give me a JSON dump of all Python-related activity from last week"

Agent runs: nex-life-logger search "python" --since 2026-03-29 --output json

Agent: Returns structured JSON for further processing.

User: "Generate a daily summary for today"

Agent runs: nex-life-logger generate daily

Agent: Shows the generated summary.

User: "Give me overall stats about my tracked data"

Agent runs: nex-life-logger stats

Agent: Presents the statistics in a readable format.

User: "What tools and languages have I been using the most?"

Agent runs: nex-life-logger keywords --category tool --top 15 and nex-life-logger keywords --category language --top 10

Agent: Combines the results into a clear overview.

User: "Export all my data to JSON"

Agent runs: nex-life-logger export json --output ~/life-logger-backup.json

Agent: Confirms the export location.

Output Parsing

All CLI output is plain text, structured for easy parsing:

• Section headers followed by --- separators
• List items prefixed with -
• Timestamps in ISO-8601 format
• Every command output ends with [Nex Life Logger by Nex AI | nex-ai.be]

When presenting output to the user, strip the footer line and present the information naturally. Do not show raw database paths or internal details.

Important Notes

• All activity data is stored locally at ~/.life-logger/. No telemetry, no analytics.
• No external API calls are made unless the user has explicitly configured an LLM provider. There are no default API endpoints.
• The background collector must be running for new data to be collected. If the user asks about tracking and the collector is not running, suggest nex-life-logger service start.
• LLM configuration is required for AI-powered features (summary generation). The activities, keywords, stats, search, and transcripts commands work without LLM.
• The collector fetches YouTube transcripts from YouTube (network access) when productive videos are detected.
• The collector tracks: browser history (Chrome, Edge, Brave, Firefox), active window focus, and YouTube transcripts.
• Chat/messaging apps and sensitive windows (password managers, banking) are automatically filtered out.
• Only productive content is tracked (AI, programming, design, building, learning). Entertainment, politics, and news are filtered.

Troubleshooting

• "Search returns no results but data exists": Run nex-life-logger config rebuild-fts to rebuild the search indexes.
• "Database not found": Run nex-life-logger service start or bash setup.sh to initialize.
• "LLM not configured": Run nex-life-logger config set-api-key then nex-life-logger config set-provider .
• No recent data: Check if the collector is running with nex-life-logger service status. Start it with nex-life-logger service start.
• Empty search results: The collector may not have been running during that time period. Check nex-life-logger stats to see the data range.

Credits

Built by Nex AI (https://nex-ai.be) - Digital transformation for Belgian SMEs.

Author: Kevin Blancaflor