Skip to content
/ codeme Public

Private coding activity tracker, backend for codeme.nvim

License

Notifications You must be signed in to change notification settings

tduyng/codeme

Repository files navigation

CodeMe

Private coding activity tracker that just works

Track your coding sessions automatically. No account, no cloud, no config, just insights.

Install

Homebrew (macOS / Linux)

brew install tduyng/tap/codeme

Go install

Requires Go 1.25+:

go install github.com/tduyng/codeme@latest

Download prebuilt binary

No dependencies needed.

  1. Download the latest release for your platform:

GitHub Releases

Platform File
macOS (ARM) codeme_<version>_darwin_arm64.tar.gz
macOS (Intel) codeme_<version>_darwin_amd64.tar.gz
Linux (x86_64) codeme_<version>_linux_amd64.tar.gz
Linux (ARM64) codeme_<version>_linux_arm64.tar.gz
  1. Extract the archive:
tar -xzf codeme_<version>_<platform>.tar.gz
  1. Move the binary to your PATH:
# User local bin (recommended)
mv codeme ~/.local/bin/codeme

# Or system-wide (requires sudo)
sudo mv codeme /usr/local/bin/codeme

Build from source

Requires Go 1.25+:

git clone https://github.com/tduyng/codeme
cd codeme && just install

Quick Start

codeme stats      # View your coding stats
codeme today      # Today's activity
codeme projects   # Project breakdown
codeme api        # JSON output for integrations

Neovim Plugin

Install codeme.nvim for automatic tracking and a beautiful dashboard:

{ "tduyng/codeme.nvim" }

The plugin tracks automatically when you:

  • Open and save files
  • Switch back to Neovim
  • Work across different projects

No manual tracking needed.

This tracks:

  • Sessions - 15min idle timeout groups your work
  • Projects - Auto-detected from git repos
  • Languages - Detected from file extensions
  • Streaks - Keep your momentum going
  • Branches - Know what you worked on

Your Data

Everything stays on your machine:

~/.local/share/codeme/codeme.db

No telemetry. No accounts. No cloud sync. Just you and your code.

Manual Tracking

Mostly used by editor integrations, but you can track manually:

codeme track --file main.go --lines 50
codeme track --file script.py --lang python --lines 100

Development

just test       # Run tests
just install    # Build and install
go run . stats  # Run locally

License

MIT

About

Private coding activity tracker, backend for codeme.nvim

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •