mon

mon

Monitor what AI coding agents are actually doing to your codebase.

What is this?

mon watches your project directory in real time and tracks file changes, git commits, and dependency modifications while AI coding agents (Claude, Cursor, Copilot, etc.) work on your code. When you're done, it gives you a summary of everything that changed.

Installation

With Go:

go install github.com/cneill/mon@latest

Or grab the latest release

Usage

Run mon in your project directory before starting your AI coding session:

mon /path/to/project

Or from within the project:

cd /path/to/project
mon .

Press Ctrl+C when done to see the session summary.

What it tracks

Supported dependency files

• Go - go.mod
• Node.js - package.json
• Python - requirements.txt, pyproject.toml

Audio

You can tell mon to play sounds on certain events like new commits, packages being added, files being written, etc. with the --audio / -A flag. There are some default sounds, but you can also provide the paths to your own sounds for various events in the mon configuration file, ~/.config/mon/config.json, like so:

{
  "audio": {
    "hooks": {
      "init": "[full_path]",
      "git_commit_create": "[full_path]",
      "git_push": "[full_path]",
      "file_create": "[full_path]",
      "file_remove": "[full_path]",
      "file_write": "[full_path]",
      "package_create": "[full_path]",
      "package_remove": "[full_path]",
      "package_upgrade": "[full_path]"
    }
  }
}

Screenshots

While running:

Session summary (on exit):

Flags

--audio, -A      Play sounds based on events
--debug, -D      Write debug logs to mon_debug.log
--no-color, -C   Disable colored output
--all-files, -F  Show all file paths in final stats
--help, -h       Show help
--version, -v    Print version