codetape

Codetape

**The flight recorder for AI coding — keeps your docs in sync with your code.**

[](https://www.npmjs.com/package/codetape) [](https://github.com/888wing/codetape/blob/main/LICENSE) [](https://nodejs.org) [](https://codetape.win)

A [Claude Code skill](https://docs.anthropic.com/en/docs/claude-code/skills) that automatically maintains documentation as AI agents modify your codebase. Zero dependencies. Fully local.

The Problem

A single Claude Code session can modify 40+ files across your project. When the session ends, your README, CHANGELOG, and architecture docs remain frozen in the past. Future-you opens the project a week later and has no idea what happened. Future AI sessions hallucinate against stale docs. The gap between code reality and written documentation grows with every session.

The Solution

Codetape captures the semantic meaning of code changes — not just diffs, but *why* things changed — and keeps your documentation synchronized. It turns Claude into a code historian that records traces, detects drift, and regenerates docs on command. Everything stays local. No cloud, no accounts, no runtime dependencies.

Quick Start

npx codetape init        # Set up tracking in your project

# ... make some code changes with Claude Code ...
/trace                     # Record what changed and why
/trace-sync                # Update your docs automatically

That's it. Your README, CHANGELOG, and ARCHITECTURE.md stay in sync.

Commands

Command	Description
/trace	Record a semantic trace of recent changes
/trace-sync	Sync documentation from traces
/trace-review	Detect documentation drift
/trace-map	Generate architecture docs with dependency graphs
/trace-log [component]	Query change history
/trace-commit	Generate conventional commit message
/trace-init	Initialize tracking (in-session alternative to CLI)

...