About this project

gkill is a local-first, self-hosted life logging application. Its purpose is to record daily events in small fragments and review them chronologically. Record types are diverse, including text notes, time stamps (what you did from when to when), mood (rated on a 10-point scale), numbers (such as sit-up counts or weight), expenses, bookmarks, tasks, files (with support for image, video, ZIP browsing, rich Markdown display, and Mermaid diagram rendering), clipboard, location (with GPX import), and automatic collection of Git commit history. Auxiliary features include organization and search by tags, text search, customizable aggregation of numbers, expenses, counts, and moods (with trend graph display), related information display, template text buttons, AI analysis (downloading and attaching analysis data, or connecting via MCP server), and plugins (importing conversation history from ChatGPT, Claude.ai, and Claude Code). A distinctive feature is searching by "context," which uses time stamp records to dig up information like "photos taken while at a karaoke place in Tokyo with Friend A." It also enables aggregations such as "average mood while at the office." It operates standalone, and records are never transmitted externally. External communication occurs only for map display, page fetching when registering bookmarks, user-configured MCP connections, and notification delivery (Web Push). Supported platforms include Windows (exe), Android (APK), Wear OS (with a phone-side companion and a watch-side app), and a server version (Windows/Linux/Android, installable as a PWA from a browser). There is no macOS version. On first launch, an account registration screen appears, and an admin account is automatically generated. For operations, documentation covers backup and recovery procedures (snapshot-based and shutdown-based methods), the requirement for HTTPS (when connecting Wear OS), and vulnerability reporting procedures. The license is MIT License, and a list of dependency package licenses is included. For developers, design documents, reverse-engineering materials, implementation documents, and rules for AI agents (AGENTS.md) are provided.