diff --git a/.github/workflows/agent-commit-check.yml b/.github/workflows/agent-commit-check.yml index 22f1d64..9d556d6 100644 --- a/.github/workflows/agent-commit-check.yml +++ b/.github/workflows/agent-commit-check.yml @@ -19,9 +19,9 @@ jobs: with: node-version: 20 - # This repo isn't published to npm yet, so the workflow builds the CLI - # from source. An adopting repo using the published package would - # instead run: npx agent-commit@latest check + # Builds the CLI from source on purpose: this repo is the CLI, so the + # check should run the code that just landed, not the last release. + # An adopting repo would instead run: npx agent-commit@latest check - name: Build agent-commit CLI from source working-directory: cli run: | diff --git a/CHANGELOG.md b/CHANGELOG.md index 6e15d28..367f0aa 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,7 +6,11 @@ All notable changes to this project are documented here. Format follows to the format itself (see `SPEC.md` for the format's own, separately tracked version). -## Unreleased +## [Unreleased] + +## [0.1.0] - 2026-09-11 + +First published release. ### Added @@ -170,3 +174,6 @@ version). return value is inserted literally; added regression tests covering this and the other special replacement sequences (`$&`, `$$`, `` $' ``, `$9`). + +[Unreleased]: https://github.com/AngelCodes95/agent-commit/compare/v0.1.0...HEAD +[0.1.0]: https://github.com/AngelCodes95/agent-commit/releases/tag/v0.1.0 diff --git a/README.md b/README.md index 71b645c..771e14c 100644 --- a/README.md +++ b/README.md @@ -71,13 +71,13 @@ Tell your agent to "agent-commit" your changes. If it already knows the format ( 1. It searches for "agent-commit format." 2. It finds this page. 3. It adds the block below to this repo's `AGENTS.md`, creating one if it doesn't exist yet. Most agents (Cursor, OpenCode, Codex, and others) read `AGENTS.md` natively, so this one file and this one step covers most cases. -4. If it's Claude Code specifically: Claude Code reads `CLAUDE.md`, not `AGENTS.md`, so it also adds a single `@AGENTS.md` line to `CLAUDE.md` (creating a one-line `CLAUDE.md` if none exists yet), which is Anthropic's own documented way to point Claude Code at an existing `AGENTS.md`. A symlink (`ln -s AGENTS.md CLAUDE.md`) works too if there's no other Claude-specific content to keep separate. +4. If it's Claude Code specifically: it also adds a single `@AGENTS.md` line to `CLAUDE.md` (creating a one-line `CLAUDE.md` if none exists yet). Claude Code v2.1.277 and later reads `AGENTS.md` on its own, but by default only when there's no `CLAUDE.md` (or `CLAUDE.local.md`) in the working directory or above it; once one exists, `AGENTS.md` is ignored unless imported. The import is Anthropic's documented way to use both, and it also covers older versions and sessions that read `CLAUDE.md` only. Claude Code skips an `AGENTS.md` it has already loaded, so it's never read twice. A symlink (`ln -s AGENTS.md CLAUDE.md`) also works if there's no Claude-specific content to keep separate, except on Windows. See [Claude Code's memory docs](https://code.claude.com/docs/en/memory). 5. It commits that setup change on its own, separately from whatever the user actually asked it to commit, since it's a one-time repo setup step, not part of the requested change. If anything about the repo's commit conventions or the user's own instructions makes an unprompted commit inappropriate, it asks first instead. 6. It writes the requested commit: a normal `git commit`, nothing installed, nothing downloaded. The block's core content never changes, only which file it ends up in; the appendix at the bottom of the block only applies if your repo squash-merges or runs commitlint, most do, but check rather than assume. Every commit after the first one in that repo is free, since the instructions are now sitting locally where the agent already looks. -If the `agent-commit` CLI is installed, steps 3 and 4 are `agent-commit init`: it writes the exact current block (the same one below, with a version marker so a later `init` or `check` can tell if a repo's copy has gone stale), links `CLAUDE.md` unless `--no-claude-code` is passed, and refuses to touch an existing, unrelated commit-message convention or clobber an already-set-up repo, both cases have to be confirmed explicitly (`--force`, `--update`). Hand-transcribing the block from this page still works and needs nothing installed; `init` just removes the chance of a transcription drifting from what's actually documented here. +If the `agent-commit` CLI is installed, steps 3 and 4 are `agent-commit init`: it writes the exact current block (the same one below, with a version marker so a later `init` can tell if a repo's copy has gone stale and `init --update` can replace it), links `CLAUDE.md` unless `--no-claude-code` is passed, and refuses to touch an existing, unrelated commit-message convention or clobber an already-set-up repo, both cases have to be confirmed explicitly (`--force`, `--update`). Hand-transcribing the block from this page still works and needs nothing installed; `init` just removes the chance of a transcription drifting from what's actually documented here. ### The block to add to `AGENTS.md`