Trace Mesh CLI — AI skill for Claude Code

Tracemesh

**AI-agent-aware task management for Git workflows.**

Tracemesh (`tm`) is a low-friction CLI that tracks work tasks in Git branches and automatically injects context protocols into AI coding agent instruction files. It ensures your AI assistant always knows what task you're working on.

Features

• Git-native task tracking — Tasks are tied to branches, with automatic sync on checkout
• AI agent integration — Injects context protocols into Cursor, Claude, Windsurf, Copilot, Cline, OpenCode, and Antigravity instruction files
• Post-checkout hook — Automatically synchronizes active task when switching branches
• Task lifecycle — Start, finish, switch, and archive tasks with simple commands
• Implementation logging — Timestamped notes for tracking decisions and changes
• Config file locking — Prevents corruption from concurrent operations
• Resource limits — Protected against excessively large files

Installation

No Go toolchain is needed to use `tm`. Pick one of the options below.

Install script (recommended)

Installs the latest pre-built binary for your OS/architecture, verifies its SHA256 checksum, and places it on your `PATH`:

curl -fsSL https://raw.githubusercontent.com/Varun136/trace-mesh-cli/master/install.sh | bash

Install a specific version or directory:

curl -fsSL https://raw.githubusercontent.com/Varun136/trace-mesh-cli/master/install.sh | bash -s -- --version v0.1.0 --prefix ~/.local/bin

Pre-built binaries (manual)

Download the archive for your platform from the [Releases](https://github.com/Varun136/trace-mesh-cli/releases) page, verify it against `checksums.txt`, extract it, and move the `tm` binary somewhere on your `PATH` (e.g. `/usr/local/bin`).

From source (requires Go)

git clone https://github.com/Varun136/trace-mesh-cli.git
cd trace-mesh-cli
make install

Requirements

• Git 2.20 or later
• Go 1.23 or later — only needed to build from source