# bestviber > bestviber is a free focus timer built for people and their AI agents. Agents start, pause and finish focus sessions while the user works, and answer questions like "how much did I focus this week?" with daily, weekly, monthly and yearly stats, streaks and insights. People use the same timer in the browser, solo or in real-time rooms with friends. Pricing: free. No account is needed in the browser; agents need a free account. ## Claude Code quickstart 1. `npm install -g bestviber` 2. `bestviber login`: approve the code in the browser, and say yes to automatic tracking. This also installs the agent skill. That is all. Every Claude Code session is then timed and filed under the repository you work in (quiet time counts as a pause; 10 quiet minutes end the session). Ask your agent "how was my week?" or run `bestviber week`. ## For agents - CLI: `npm install -g bestviber`, then `bestviber login` (approve a code in the browser). `bestviber today`, `week`, `month`, `insights`, `start`, `stop`. Add `--json` for machine-readable output. `bestviber tools` lists every action. - Agent skill: installed by `bestviber login` (or `bestviber skill install`) for Claude Code and other agents, or fetch [SKILL.md](https://www.bestviber.com/skill/SKILL.md) and [reference.md](https://www.bestviber.com/skill/reference.md). - Remote MCP server: `https://www.bestviber.com/api/mcp` (Streamable HTTP) with `Authorization: Bearer `; `bestviber mcp` prints the setup. - HTTP API: `GET https://www.bestviber.com/api/v1/actions` lists actions with JSON Schemas; `POST https://www.bestviber.com/api/v1/actions/` runs one. - In the browser, the same actions are WebMCP tools on every page. ### Actions - `get_active_session`: Returns the running or paused focus session (id, status, startedAt, pausedMs, pausedAt, project), or null when no session is open. If several are open (agent sessions run in parallel), the one started by hand wins. Elapsed focus = now - startedAt - pausedMs, minus (now - pausedAt) while paused. - `list_open_sessions`: Every running or paused session, newest first. Several can be open at once: one started by hand plus one per agent session (for example each Claude Code window). - `start_focus_session`: Starts a focus session now. The open session it replaces (your manual one, or with agentSession that agent session's) is finished first, with its real duration; sessions of other agent sessions keep running. Optionally attach tags (ids from list_tags), a room (id from list_rooms) and a project. - `pause_focus_session`: Pauses the running focus session. Paused time does not count as focus. - `resume_focus_session`: Resumes the paused focus session. - `finish_focus_session`: Finishes the open focus session and records it. Returns its focused duration in milliseconds. - `list_sessions`: Lists finished focus sessions, newest first, for one day (date) or an inclusive date range (from/to), in the given time zone. Each has startedAt, endedAt, durationMs, notes and roomId. - `get_focus_totals`: Focused milliseconds today, over the last 7 days (including today), this calendar month, and lifetime. The quickest answer to "how much have I focused". - `get_stats`: Full report for a calendar period (day, week starting Monday, month, year) or a custom from/to range: total, session count, average and longest session, active days, best day, totals by day, by hour of day, by weekday, by tag and by project, and the change against the previous period. totalMs is focused time on the clock, counting overlapping sessions once; sessionTimeMs adds up the time of every session, parallelMs is how long two or more sessions ran at once (for example two Claude Code windows), and maxParallel the most at once. byProject and byTag count the time of each session. Use this for "how was my week/month". - `get_streaks`: Current and longest streak of consecutive days with focus time, and whether today already counts. The current streak stays alive until today ends. - `get_insights`: Plain-language findings to relay to the user: peak focus hours, strongest weekday, this week vs last, session length trend, today vs a typical day, streak status, top tag. Based on the last 4 weeks. - `get_daily_totals`: Focused milliseconds per day for the last N days (default 84, the 12-week heatmap). Days with no focus are omitted. - `list_tags`: Lists the user's session tags (id, name). - `create_tag`: Creates a session tag. A user can have up to 10. - `delete_tag`: Deletes a session tag and removes it from every session that had it. - `list_rooms`: Lists the focus rooms the user belongs to (id, name, slug, endsAt), newest first. - `get_room`: Returns one room and whether the user is a member of it. - `create_room`: Creates a focus room owned by the user. Friends join it to share a live leaderboard. - `join_room`: Joins a focus room by id so the user appears on its leaderboard. Joining twice is harmless. - `get_room_leaderboard`: Ranks a room's members by focused milliseconds since the room was created, counting running sessions live. Only members can see it; join_room first. - `add_session_to_room`: Moves a focus session into a room so it counts on that leaderboard, joining the room if needed. The timer keeps running. - `list_room_invites`: Lists pending room invites for the user, with room and sender. - `respond_to_room_invite`: Accepts or declines a pending invite. Accepting joins the room. - `invite_to_room`: Invites another bestviber user to a room by their account email. They see it in their invites. ## App - [Focus timer, solo or with friends](https://www.bestviber.com/) ## Timers - [Timers by length](https://www.bestviber.com/timer) - [Pomodoro timer](https://www.bestviber.com/pomodoro-timer) - [Focus timer](https://www.bestviber.com/focus-timer) - [Deep work timer](https://www.bestviber.com/deep-work-timer) - [5 minute timer](https://www.bestviber.com/timer/5-minutes) - [10 minute timer](https://www.bestviber.com/timer/10-minutes) - [15 minute timer](https://www.bestviber.com/timer/15-minutes) - [20 minute timer](https://www.bestviber.com/timer/20-minutes) - [25 minute timer](https://www.bestviber.com/timer/25-minutes) - [30 minute timer](https://www.bestviber.com/timer/30-minutes) - [45 minute timer](https://www.bestviber.com/timer/45-minutes) - [50 minute timer](https://www.bestviber.com/timer/50-minutes) - [60 minute timer](https://www.bestviber.com/timer/60-minutes) - [90 minute timer](https://www.bestviber.com/timer/90-minutes) - [25/5 Pomodoro timer](https://www.bestviber.com/timer/25-5) - [50/10 focus timer](https://www.bestviber.com/timer/50-10) - [90/20 deep work timer](https://www.bestviber.com/timer/90-20) ## Comparisons - [bestviber compared](https://www.bestviber.com/vs) - [bestviber vs Forest: which focus timer to use](https://www.bestviber.com/vs/forest) - [bestviber vs Toggl Track: focus timer or timesheet](https://www.bestviber.com/vs/toggl-track) - [bestviber vs Rize: automatic tracking or deliberate sessions](https://www.bestviber.com/vs/rize) - [bestviber vs RescueTime: focus timer or activity monitor](https://www.bestviber.com/vs/rescuetime) - [bestviber vs Session: Pomodoro on Mac or in the browser](https://www.bestviber.com/vs/session) ## Blog - [Blog](https://www.bestviber.com/blog) - [How long should a coding session be?](https://www.bestviber.com/blog/how-long-should-a-coding-session-be) - [The 23-minute interruption number is softer than you think](https://www.bestviber.com/blog/the-23-minute-interruption-number) - [Hours tracked is the wrong metric](https://www.bestviber.com/blog/hours-tracked-is-the-wrong-metric) - [The 90-minute rule is borrowed from sleep research](https://www.bestviber.com/blog/the-90-minute-rule-comes-from-sleep-research) - [Why working next to someone works](https://www.bestviber.com/blog/why-working-next-to-someone-works)