v1.1.1 — drop inline JSON-LD blob from README

v1.1.1 — Drop inline JSON-LD from README

A one-line visual fix. The v1.1.0 release added a 60-line inline
<script type="application/ld+json"> block to the README. GitHub
strips the script tag but renders the JSON as raw text — creating
a giant ugly blob right under the badge row.

The fix: remove the inline block, point to the canonical
/schema.json at the repo root. It's a real JSON
file, validated, shipped in the npm tarball, and any AI tool or
crawler that wants structured data can read it directly.

What changed

• README: 961 lines → 903 lines
• The 60-line inline <script> block replaced with a one-line pointer
• schema.json remains the canonical source (13 KB, 7 JSON-LD types)
• No product changes, no test changes

Install

npm install -g agent-rollback@1.1.1
# or one-liner with skill + MCP auto-register
curl -fsSL https://raw.githubusercontent.com/Nainish-Rai/agent-rollback/main/scripts/install.sh | bash -s -- --all

v1.1.0 — 100/100 SEO Pass

v1.1.0 — 100/100 SEO Pass

This release is mostly about discoverability — both for search engines
and for AI engines (ChatGPT, Perplexity, Gemini, AI Overviews).
The product is unchanged; the meta is sharper.

What's new

On-page SEO

• H1 rewritten to lead with the search terms: "agent-rollback:
  codex undo, revert, and rollback checkpoints"
• Definition block at the top: "agent-rollback is the undo
  button for OpenAI Codex CLI."
• Freshness header with version + date + Node version
• "Why this exists" section that links the OpenAI Codex
  issues where users have been requesting exactly this feature
  (#2788,
  #5082,
  #6449)
• "How to undo a Codex change in 4 commands" — a high-priority
  quotable block for AI engines
• Comparison table of agent-rollback vs the alternatives
  (pi-rollback, agentame, diffback, codex-revert, git stash, Cmd+Z)
• 4 keyword-rich H2s for SERP/AI matching
• "Mentioned in" section placeholder for third-party citation
  growth

Schema.org + AI-quotable metadata

• schema.json (13 KB) at the repo root with:
  SoftwareApplication, SoftwareSourceCode, TechArticle,
  FAQPage, HowTo, BreadcrumbList, Organization
• Inline JSON-LD in the README for direct AI extraction
• CITATION.cff for machine-readable academic citation

npm + GitHub trust signals

• package.json description rewritten to lead with the
  SERP-winning keywords (D1, 149 chars)
• 47 keywords reordered to surface agent-rollback →
  codex-* first
• Funding field added for GitHub Sponsors
• CODE_OF_CONDUCT.md (Contributor Covenant v2.1)
• CONTRIBUTING.md (commands, style, PR process)
• SECURITY.md (vulnerability disclosure + threat model)

GitHub config

• Issue templates: bug_report, feature_request, docs_or_seo
• PR template with checklist
• CI workflow: tests on Node 20 + 22, syntax check, JSON
  validation, install-script dry-run
• Dependabot: weekly npm + GitHub Actions updates

Research + audits (in marketing/)

14 audit reports and 4 research reports backed this release:

• marketing/seo-research/01-keyword-landscape.md — 12 keywords ranked
• marketing/seo-research/02-serp-analysis.md — 7 SERPs analyzed
• marketing/seo-research/03-competitor-landscape.md — 10+ competitors
• marketing/seo-research/04-geo-landscape.md — AI-citation landscape
• marketing/seo-audit/01-on-page-audit.md — scored 59/100 → 100/100
• marketing/seo-audit/02-meta-tags.md — D1/D2/D3 candidates
• marketing/seo-audit/03-schema-markup.md — 7 JSON-LD blocks
• marketing/seo-audit/04-geo-audit.md — scored 54/100
• marketing/seo-audit/05-entity-audit.md — 47-signal entity check
• marketing/seo-audit/06-technical-audit.md — GH + npm audit
• marketing/seo-audit/07-content-quality-audit.md — E-E-A-T 80-item
• marketing/seo-audit/08-competitor-analysis.md — gap matrix
• marketing/seo-audit/09-content-gap.md — editorial calendar
• marketing/seo-audit/10-internal-linking.md — link architecture
• marketing/seo-audit/11-backlink-strategy.md — 30+ targets
• marketing/seo-audit/12-domain-authority.md — CITE 40-item
• marketing/seo-audit/13-rank-baseline.md — 13 keyword baseline
• marketing/seo-content/01-undo-layer-explainer.md — long-form
• marketing/seo-content/02-codex-checkpoint-comparison.md — compare
• marketing/seo-content/03-how-to-undo-codex-changes.md — how-to

Install / upgrade

npm install -g agent-rollback@latest
# or
curl -fsSL https://raw.githubusercontent.com/Nainish-Rai/agent-rollback/main/scripts/install.sh | bash -s -- --all

v1.0.1 — strip Codex internals; promote 'arb' alias

v1.0.1

README polish: removed the low-level Codex internally: blocks from the
natural-language examples and promoted the arb short alias.

Changes

Stripped Codex internally: blocks

The chat examples in the README were showing the raw MCP protocol calls
inline:

Codex internally:
  → mcp__agent-rollback__create_checkpoint({ name: "green tests" })
  → (then proceeds with the refactor in the working tree)

That was leaking the MCP protocol to end-users. Removed all 13 of those
blocks. The natural-language examples now read as a clean conversation:

You: "make a checkpoint and refactor task service"

Codex: "Created checkpoint cp-183544-... If I make a mess, just say 'go back'."

The MCP tool reference table is preserved (it's a useful developer
reference and tells agents what tools exist), but no longer appears
inline in the chat examples.

Promoted the arb short alias

arb mentions: 11 → 25. Added to:

• Hero tagline (now mentions arb as the short alias right up top)
• 30-second start intro (agent-rollback is the full command, arb is
  the 3-char alias for when you're in a hurry)
• npm install blurb (explains both names with the pick-whichever-you-type-faster framing)
• Install script success message (now leads with arb init instead of
  agent-rollback init)
• Every CLI-equivalent block under the chat examples (e.g.
  agent-rollback list # or: arb list)

Added CLI fallbacks under every chat example

Each natural-language example now has the matching CLI command right
underneath, so the README works equally well for terminal-first users
who never use Codex chat.

Install

npm install -g agent-rollback
# or one-liner with skill + MCP auto-register
curl -fsSL https://raw.githubusercontent.com/Nainish-Rai/agent-rollback/main/scripts/install.sh | bash -s -- --all

v1.0.0 — BREAKING: short alias renamed 'ar' → 'arb'

v1.0.0

First stable release. No more 0.x churn.

⚠️ BREAKING: short alias renamed from ar to arb

The old ar short alias was being shadowed by /usr/bin/ar (the BSD/GNU
archive tool) on shells where npm's global bin comes after /usr/bin in
PATH — common in cloud shells, cron, and shells launched without nvm
initialized. Users running ar --help would see the archive tool's
usage instead of agent-rollback's.

The new short alias is arb (agent-rollback, 3 chars, no collision).

Migration

• agent-rollback has always worked and still does — no change there.
• If you were using ar, switch to arb.
• If ar still appears in your shell after this release, the system
  archive tool is now correctly visible again.

# old
ar list
ar checkpoint "before refactor"

# new
arb list
arb checkpoint "before refactor"

# full name (unchanged)
agent-rollback list

Changes

• bin/ar.js → bin/arb.js (rename, same wrapper)
• package.json#bin: ar mapping removed, arb mapping added
• scripts/install.sh: verifies arb and detects the system-ar shadow
  with a one-line note
• README.md: new "Why is the short alias arb and not ar?" FAQ
  entry, all command examples updated

Install

# one-liner (binary + skill + MCP)
curl -fsSL https://raw.githubusercontent.com/Nainish-Rai/agent-rollback/main/scripts/install.sh | bash -s -- --all

# or just npm
npm install -g agent-rollback

Verify

agent-rollback --help
arb --help

v0.1.6

What's new in 0.1.6

README: Full user-flow 30-second quickstart

Replaced the 3-bullet quickstart with a 7-step walkthrough. Each step
shows both the natural-language Codex prompt and the equivalent CLI
command, so a reader can follow along either way:

Step	What you do	Codex prompt	CLI command
0	Install	—	curl ... install.sh | bash -s -- --all
1	Initialize a repo	—	agent-rollback init
2	Discover the tool surface	"what can you do for checkpoints?"	agent-rollback --help
3	Checkpoint + do something risky	"make a checkpoint called 'green tests' and refactor the auth module"	agent-rollback checkpoint "green tests"
4	Browse checkpoints	"show me checkpoints"	agent-rollback list / tui
5	Roll back	"go to the last checkpoint"	agent-rollback revert ... --yes
6	See what changed	"what did the refactor change vs the green tests checkpoint?"	agent-rollback diff from to

The new TOC has anchor links for each step.

Install

npm install -g agent-rollback
# or one-liner with skill + MCP auto-register
curl -fsSL https://raw.githubusercontent.com/Nainish-Rai/agent-rollback/main/scripts/install.sh | bash -s -- --all

v0.1.5

What's new in 0.1.5

README: Chat with Codex MCP examples

New sub-section under MCP server with 8 realistic natural-language
flows and the MCP tool calls they'd trigger, plus a full tool reference
table for all 9 MCP tools.

Flows covered:

• "make a checkpoint and refactor task service" → create_checkpoint + run
• "show me checkpoints" → list_checkpoints
• "go to last checkpoint" → undo
• "what changed between the auth checkpoint and now?" → diff_checkpoints
• "find my checkpoint about the mongodb migration" → search_checkpoints
• "pin the v0.4 release checkpoint" → pin_checkpoint
• "dry-run restore to the auth checkpoint" → restore_checkpoint (dry-run)
• "apply it" → restore_checkpoint (apply)
• "prune old checkpoints" → prune_checkpoints

Install

npm install -g agent-rollback
# or with the agent skill + MCP auto-register
curl -fsSL https://raw.githubusercontent.com/Nainish-Rai/agent-rollback/main/scripts/install.sh | bash -s -- --all

v0.1.4

What's new in 0.1.4

SEO and discoverability pass for npm and GitHub.

npm

• 36 keywords in package.json covering codex-undo, codex-revert,
  codex-checkpoint, codex-rollback, codex-mcp, codex-safety-net,
  plus claude-code, cursor, windsurf, copilot, cline,
  gemini-cli, and more.
• Repository metadata added (homepage, repository, bugs) so the
  npm sidebar shows source links, clone commands, and an issue tracker.
• Description rewritten to lead with the search terms: "Git-like undo
  and rollback checkpoints for OpenAI Codex CLI".

README

• Tagline rewritten with the most-searched terms.
• New "Also known as" line with long-tail variants: Codex undo,
  Codex revert, Codex checkpoint, Codex rollback, Codex snapshot, Codex
  backup, Codex diff, Codex restore, Codex file history, Codex safety
  net, Codex MCP, Codex time travel.
• New FAQ section answering the most common Codex undo / revert /
  rollback questions verbatim.
• Comparison table vs git stash / git restore / git reset.
• 3 new badges: stars, Codex CLI, MCP.

Install

npm install -g agent-rollback
# or
curl -fsSL https://raw.githubusercontent.com/Nainish-Rai/agent-rollback/main/scripts/install.sh | bash

v0.1.3

What's new in 0.1.3

One-click installer + dev-friendly README.

scripts/install.sh — new

Idempotent installer with these flags:

• --all — install binary + agent skill + register MCP server in Codex
• --with-skill — install the agent skill globally via npx skills add
• --with-mcp — register the MCP server in ~/.codex/config.toml
  (auto-merged, idempotent, with backup)
• --version <X.Y.Z> — pin a specific version
• --uninstall — remove binary, MCP block, and skill
• --dry-run — preview without changing anything
• --no-color — disable ANSI

The installer checks for Node >= 20, refuses Windows without WSL with a
helpful pointer, and verifies the binary after install.

README

• Badges at the top (npm, node, license, downloads)
• New 30-second start section
• New Why section
• Install section reorganized into 3 ranked paths with a flag table
• Full Contents TOC with anchor links
• Usage split into 9 named sub-sections

package.json

• Added "scripts" to the files array so install.sh ships in the
  published tarball.

Install / upgrade

# new
npm install -g agent-rollback

# upgrade
npm update -g agent-rollback

# one-liner with skill + MCP
curl -fsSL https://raw.githubusercontent.com/Nainish-Rai/agent-rollback/main/scripts/install.sh | bash -s -- --all

v0.1.2

What's new in 0.1.2

Documentation and discoverability polish.

• npx skills add documented as the one-line install path for the
  agent skill (Codex, Claude Code, Cursor, Windsurf, etc.).
• Skills directory listing seeded once a user installs.
• Improved human-readable checkpoint IDs that encode the label and
  prompt.

Install

npm install -g agent-rollback