> ## Documentation Index
> Fetch the complete documentation index at: https://docs.boxd.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# WakaTime

> WakaTime offers automatic time tracking for developers, integrating with code editors and delivering dashboards on coding activity, project progress, and productivity

WakaTime offers automatic time tracking for developers, integrating with code editors and delivering dashboards on coding activity, project progress, and productivity

`wakatime` · **17 tools** · no triggers

## Connect it

```bash theme={"theme":"github-dark"}
run auth wakatime
run auth wakatime --scope team    # shared with the organization
```

Or from the [Integrations page](https://app.boxd.sh/integrations) in the console. See [Connections](/guides/integrations/connections) for personal versus shared, and who may remove one.

## Use it

```bash theme={"theme":"github-dark"}
run wakatime          # common commands
run wakatime --all    # every command
```

```ts theme={"theme":"github-dark"}
import { wakatime } from "@boxd/run";
```

## Common tools

| Tool                      | What it does                                                                                                           |
| ------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| `get-insights`            | Tool to retrieve an insight for a user over a time range. Use when analyzing user coding metrics after authentication. |
| `get-oauth-authorize`     | Tool to generate OAuth 2.0 authorization URL. Use when redirecting users to WakaTime to grant access.                  |
| `get-user-stats`          | Tool to retrieve coding statistics for a user over the default time range.                                             |
| `get-user-stats-by-range` | Tool to retrieve comprehensive coding statistics for a user over a specific time range.                                |
| `get-user-summaries`      | Get user's coding activity for a time range as daily summaries.                                                        |

<Accordion title="All 17 tools" icon="list">
  | Tool                                | What it does                                                                                                                                            |
  | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `get-aggregate-stats`               | Tool to retrieve aggregate coding statistics across all WakaTime users for a given time range.                                                          |
  | `get-current-user-status-bar-today` | Tool to get current user's coding activity today for displaying in IDE status bars.                                                                     |
  | `get-editors`                       | Tool to list WakaTime IDE plugins with metadata. Use when you want to discover available IDE integrations and their latest versions.                    |
  | `get-goals`                         | Tool to list a user's goals with progress series and metadata.                                                                                          |
  | `get-insights`                      | Tool to retrieve an insight for a user over a time range. Use when analyzing user coding metrics after authentication.                                  |
  | `get-leaders`                       | Tool to list public leaders ranked by coding activity. Use when viewing top coders globally or filtering by language, country code, or hireable status. |
  | `get-machine-names`                 | Tool to list a user's machines including last seen time. Use when needing machine names for a specific user.                                            |
  | `get-meta`                          | Tool to retrieve WakaTime API meta information, including public IP addresses used by WakaTime servers.                                                 |
  | `get-oauth-authorize`               | Tool to generate OAuth 2.0 authorization URL. Use when redirecting users to WakaTime to grant access.                                                   |
  | `get-user`                          | Tool to get detailed profile information for a WakaTime user by user ID or username.                                                                    |
  | `get-users-all-time-since-today`    | Tool to retrieve total coding time since account creation for a user.                                                                                   |
  | `get-user-stats`                    | Tool to retrieve coding statistics for a user over the default time range.                                                                              |
  | `get-user-stats-by-range`           | Tool to retrieve comprehensive coding statistics for a user over a specific time range.                                                                 |
  | `get-user-summaries`                | Get user's coding activity for a time range as daily summaries.                                                                                         |
  | `list-program-languages`            | Tool to list all verified program languages supported by WakaTime.                                                                                      |
  | `list-user-projects`                | List WakaTime projects for a specified user. Returns project names, IDs, creation dates, and last activity times.                                       |
  | `list-user-user-agents`             | Tool to list plugins and editors which have sent data for a specified user.                                                                             |
</Accordion>

[Open WakaTime in the console →](https://app.boxd.sh/integrations/detail/wakatime)