cd ~/docs

documentation

Install, activate, understand.

Everything about the local-first tracking model — what's recorded, what never leaves your machine, and the commands that run it.

Quick start

One command, then you're tracking.

  1. Buy a license. The success page hands you a ready-to-run command with your license key already in it.
  2. Paste it into Terminal. It installs and activates in one step.
  3. Open http://127.0.0.1:8765 — or run agentwatch open.

Install & activate

The command on your success page does both at once — it installs the agentwatch CLI and activates your key:

curl -fsSL https://trackmy.codes/install.sh | TRACKMYCODES_LICENSE_KEY="tmc_…" bash

Already installed? Activate from the app (Settings → License → paste key), or run:

agentwatch activate tmc_your_license_key

Once activated, it keeps working offline.

Get your license →

Dashboard

Everything lives in a local dashboard at http://127.0.0.1:8765 — your tracked time, sessions, agents, and projects, plus settings, exports, and license controls.

What gets tracked

  • When coding-agent sessions start, stay active, and end.
  • Which agent and project you're working in.
  • Whether an agent is actively running on your machine.
  • When you're actively typing or clicking in a supported agent app or terminal.

What doesn't get tracked

  • Code contents.
  • Prompt text, chat transcripts, or generated responses.
  • Screen recordings, screenshots, or window images.
  • Keystroke contents.
  • Cloud sync of local activity data by default.

Privacy & local data

Activity data is stored in ~/.trackmycodes/trackmycodes.sqlite by default. Hosted calls are limited to license activation, license refresh, billing, and release metadata — unless you explicitly export or share data yourself.

CLI usage

agentwatch codex
agentwatch claude
agentwatch track --agent custom-agent -- your-command
agentwatch watch-processes
agentwatch watch-input

If the local server is not running, wrapped commands can write directly to the same local SQLite database.

VS Code extension

The VS Code-family extension sends local events to http://127.0.0.1:8765/events. Configure the agent label when you want editor-originated events attributed to a specific coding agent.

{
  "trackmycodes.agentName": "codex"
}

Updates

The app checks for new versions automatically. To check manually:

agentwatch update check

Export / delete data

The local dashboard settings can export JSON, export CSV, or delete activity data. Deleting activity data does not cancel billing or remove your license activation.

Troubleshooting

  • Run agentwatch status to inspect local services and license state.
  • Run agentwatch restart if the dashboard is not responding.
  • Run agentwatch license to confirm the local entitlement.
  • Use Settings in the local dashboard to pause tracking, refresh licenses, or check updates.

Uninstall

agentwatch uninstall

Use agentwatch uninstall --delete-data only when you also want to remove local activity data.