Amp CLI WakaTime

WakaTime plugin for the Amp CLI.

The plugin installs wakatime-cli into ~/.wakatime/, checks GitHub Releases for updates when an Amp thread session starts, and syncs AI heartbeats after user prompts and successful file-edit tools.

It works on Windows, macOS, and Linux. It has no package dependencies and does not invoke Node.js, a shell, curl, PowerShell, or an archive utility. Amp runs the TypeScript plugin with its bundled Bun runtime; the only child process started by the plugin is the downloaded wakatime-cli executable.

Install

Choose one of these installation methods.

macOS and Linux

mkdir -p ~/.config/amp/plugins && curl -fsSL https://raw.githubusercontent.com/wakatime/amp-cli-wakatime/main/amp-cli-wakatime.ts -o ~/.config/amp/plugins/amp-cli-wakatime.ts

Windows PowerShell

New-Item -ItemType Directory -Force "$HOME\.config\amp\plugins" | Out-Null; Invoke-WebRequest https://raw.githubusercontent.com/wakatime/amp-cli-wakatime/main/amp-cli-wakatime.ts -OutFile "$HOME\.config\amp\plugins\amp-cli-wakatime.ts"

Manual download

Download amp-cli-wakatime.ts from GitHub and save it as amp-cli-wakatime.ts in Amp's system plugin directory:

• macOS and Linux: ~/.config/amp/plugins/
• Windows: %USERPROFILE%\.config\amp\plugins\

For one project only, copy it into <project>/.amp/plugins/ instead.

Restart Amp after installing. When updating an existing copy while Amp is running, open the command palette with Ctrl+O and run plugins: reload.

Configuration

The plugin reads standard WakaTime settings from ~/.wakatime.cfg:

[settings]
api_key = waka_123
debug = true
proxy = https://user:pass@example.com:8080

Set no_ssl_verify = true only when required by a trusted network with a custom TLS setup. WAKATIME_HOME can override the home directory containing .wakatime.cfg and .wakatime/.

Plugin logs are written to ~/.wakatime/amp-cli.log. The downloaded executable is also available through the standard ~/.wakatime/wakatime-cli path (wakatime-cli.exe on Windows).

Supported targets are Intel and Apple Silicon macOS, x86/AMD64/ARM/ARM64 Linux, and x86/AMD64/ARM64 Windows.