TrackMyCodes Docs

Quick Start

1. Download and install the latest macOS package.
2. Open Terminal and run agentwatch install.
3. Open http://127.0.0.1:8765 or run agentwatch open.
4. Buy a license before the 14-day trial ends, then run agentwatch activate tmc_your_license_key.

Install

TrackMyCodes installs the agentwatch CLI and local Python package.

agentwatch install
agentwatch status
agentwatch open

agentwatch install writes user LaunchAgents so the local server, process watcher, input watcher, and waiting watcher can run after Terminal closes.

Activate License

The app starts a 14-day local trial on first run. A paid annual license keeps recording after the trial.

agentwatch activate tmc_your_license_key
agentwatch license

Active licenses keep working offline for a 14-day grace window after the latest successful refresh.

Dashboard

The dashboard runs locally at http://127.0.0.1:8765. It shows tracked time, inactive time, sessions, agents, projects, sources, status tracking, timeline rows, recent events, settings, updates, exports, and license controls.

What Gets Tracked

• CLI session starts, heartbeats, output activity, and session ends.
• VS Code-family extension heartbeats and editor event metadata.
• macOS process watcher heartbeats for active agent worker processes.
• Foreground input heartbeats while you type or click in supported agent apps and terminals.
• Foreground waiting time after recent Codex or Claude Code work.

What Does Not 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 And 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
agentwatch watch-waiting

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 local app checks the hosted release manifest for version, required update flag, download URL, checksum, and release notes.

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.