CLAUDE.md

Uncompact — Claude Instructions

Pull Requests

When asked to implement something and raise a PR, always create the PR using gh pr create. Never substitute a "Create PR →" compare link. The command to use:

gh pr create \
  --repo supermodeltools/Uncompact \
  --title "..." \
  --body "..." \
  --base main \
  --head <branch>

Always run this as the final step. The PR must exist before marking the task complete.

Issues

When creating a GitHub issue, always include @claude at the end of the body so the workflow auto-triggers. Example closing line:

@claude please implement this

Development

• Language: Go 1.22
• Build: go build ./...
• Lint: go vet ./...
• No test suite yet — at minimum verify go build ./... passes before committing

Testing NPM Distribution Locally

To test the one-command installation flow without releasing:

1. Build the latest binary into the npm directory:

   mkdir -p npm/bin && go build -o npm/bin/uncompact .

2. Package and install locally:

   npm pack
   # Replace 0.0.0 with the version in package.json if different
   npm install -g ./uncompact-0.0.0.tgz --foreground-scripts

   Note: --foreground-scripts is required to see the output of the post-install hook.

3. Verify installation:

   uncompact verify-install
   uncompact status

4. Total Cleanup (to reset your environment):

   uncompact uninstall --total
   npm uninstall -g uncompact

Commits

Always include both co-authors in every commit message:

Co-Authored-By: Grey Newell <greyshipscode@gmail.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Branch naming

claude/issue-{number}-{YYYYMMDD}-{HHMM}