Common Questions
FAQ
Straight answers about tracking, planning, and how the rules engine works.
How does Kshan track my active window time?
Kshan checks the name and window title of the foreground application on your primary screen.
Does Kshan track the same session across multiple devices?
No — each device tracks its own local timeline independently. Cloud sync (Plus and Pro) backs up and lets you view your history from your account; it does not merge simultaneous activity from two machines into a single session.
How does the categorization (rules) engine work?
Kshan matches the active app name, window title, and browser URL domain against local rules — yours and the built-in defaults — to assign a category instantly. Anything that doesn't match a rule is queued for review instead of being silently mislabeled.
Can I plan my day in Kshan, not just track it?
Yes. Kshan has a built-in calendar with day, week, month and year views. Drag tasks from the backlog onto the grid to timebox them, and each block then shows how much tracked time actually landed inside it. Connected tools like Trello, GitHub, Jira, Linear, Todoist or Notion feed their tasks straight into the same backlog.
How does the MCP server work?
Kshan runs a small local MCP (Model Context Protocol) server. AI clients such as Claude Code or Claude Desktop can use it to add backlog tasks, schedule them on the calendar, mark them done and read back today's plan. Only daily-task tools are exposed — tracking sessions, scores and settings never are.
How does Kshan keep performance light?
Kshan runs as a lightweight native background task. It uses minimal system resources and memory, ensuring zero impact on your computer's performance.
Does Kshan record my screen or keystrokes?
No. Kshan does not record your screen, video, keystrokes, or mouse clicks. It only tracks which application is active.
Which platforms are supported?
Kshan runs on macOS (Apple Silicon and Intel), Windows (x64) and Linux (x64) today.