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

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:

bash

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:

bash

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:

bash

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:

bash

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:

bash

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

Statistics#

bash

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

Generate Summaries#

Generate AI summaries on demand (requires LLM configuration):

bash

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

Export#

bash

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#

bash

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

Configuration#

bash

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 <name>.
• 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