All apps/WakaTime

WakaTime

wakatime

Command line interface used by all WakaTime text editor plugins.

Runs as wakatime-cli, wakatime|macOS, Linux, Windows|wakatime.com

Command form

ai-draft · 2 tasks · 11 fields

Log one heartbeat for a file, domain, URL or app, or print today's total. Config-file editing, extra-heartbeats on stdin and the deprecated flag spellings are left out.

Opens the form; the finished command lands at your prompt, unrun
otty gui wakatime
Send a heartbeatExample values, fixed in this page — nothing here reaches a terminal
Basic
Entity*
string
Project
string
Language
string
Triggered by a write
--write
Advanced
Plugin name and version
string
TasksEach one presets the form for one job
Send a file heartbeat
entityprojectlanguagewriteplugin
Show today's time
today
ParametersOnly these flags are editable in the form
Entity
Absolute path to a file, or a URL, domain or app when the type is not file.
string
--entity
Entity type
enum
--entity-typefiledomainurlapp
Project
Override the auto-detected project.
string
--project
Language
string
--language
Category
string
--categorycodingdebuggingbuildingcode reviewingwriting docs
Triggered by a write
boolean
--write
Plugin name and version
string
--plugin
Config file
path
--config
Disable offline queue
boolean
--disable-offline
Verbose logging
boolean
--verbose
Print today's time
boolean
--today
SourcesEvery flag above is checked against these
source
Flags (cobra names, used as --entity --entity-type --project --language --category --write --plugin --config --disable-offline --verbose --today): flags.String("alternate-project", "", "Optional alternate project name. Auto-detected project takes priority.") "category", "Category of this heartbeat activity. Can be \"coding\", \"ai coding\","+ "entity", "Abso…
helpHEAD 2026-10-27

raw.githubusercontent.com

Before it fills your prompt, Otty checks the installed wakatime-cli against its version. A form that does not match your version is not offered.