Skip to content

docs: refresh README + AGENTS.md for 0.2.0 / 0.2.1 - #14

Merged
imsobear merged 1 commit into
mainfrom
docs/refresh-0.2.1
May 15, 2026
Merged

docs: refresh README + AGENTS.md for 0.2.0 / 0.2.1#14
imsobear merged 1 commit into
mainfrom
docs/refresh-0.2.1

Conversation

@imsobear

Copy link
Copy Markdown
Owner

Summary

The user-facing docs lagged behind the v0.2.0 and v0.2.1 releases. This
pass aligns every stale claim with the current code and bumps a few
out-of-date roadmap items into the done column.

What was wrong

  • AGENTS.md still claimed action segments were Anthropic-only and
    Codex pairing was on the v0.3 list — both shipped in v0.2.0 via
    `computeActionSegmentsResponses` (`src/server/aggregate.ts`).
  • Both files still showed `projectId = sha256(cwd)`. Since v0.2.0
    it's `sha256(cwd \0 agent).slice(0,16)`; mixed-agent legacy
    files are split per agent on first boot (`maybeReKeyByAgent` in
    `storage.ts`).
  • README privacy section claimed the only outbound traffic was
    `api.anthropic.com`. With Codex CLI we now also forward per-
    request to `api.openai.com` (Bearer `sk-…`) or
    `chatgpt.com/backend-api/codex` (Bearer `eyJ…` OAuth).
  • AGENTS.md said "No tests yet" — `pnpm smoke` now covers Codex
    capture, Anthropic regression, `(cwd, agent)` scoping, the
    legacy split-on-boot, and launcher argv/env injection.
  • Codex cwd-extraction recipe still showed the bare
    `…` regex — that anchors on AGENTS.md doc examples
    and produces garbage cwds. The real rule requires `` inside
    `<environment_context>` and scans `input[]` backwards.
  • Roadmap, file-tree, supported-agents table, and the launcher
    section updated to reflect `agentmind-cli` defaulting to Claude
    (v0.2.1) and `--no-agent` for dashboard-only mode.

Also fixed

Three stale `0.2.2` version references in source-code comments
(`storage.ts`, `scripts/smoke-codex.mjs`) — those should be
`0.2.0` since that's when the migration actually shipped.

Scope

  • No production-code changes. Just docs + comments + smoke-test
    comments.
  • `pnpm typecheck` is clean.

The docs lagged behind two releases. Most of what was wrong:

* AGENTS.md still claimed action segments were Anthropic-only and
  Codex was on the v0.3 list — both have shipped in v0.2.0
  (`computeActionSegmentsResponses` in aggregate.ts).
* Both files still printed the old `projectId = sha256(cwd)` formula.
  Since v0.2.0 it's `sha256(cwd \0 agent).slice(0,16)`; mixed-agent
  legacy files are split per agent on first boot
  (`maybeReKeyByAgent`).
* Privacy section in the README claimed the only outbound traffic was
  `api.anthropic.com`. With Codex CLI we also forward to
  `api.openai.com` (sk- keys) or `chatgpt.com/backend-api/codex` (eyJ
  OAuth) per request.
* "No tests yet" in AGENTS.md — we have `pnpm smoke` now (build +
  scripts/smoke-codex.mjs + scripts/smoke-launcher.mjs).
* Codex cwd-extraction recipe still showed the bare
  `<cwd>…</cwd>` regex, but that anchors on AGENTS.md doc examples
  and produces garbage cwds. The real rule requires the `<cwd>` to
  sit inside `<environment_context>` and scans input[] backwards.
* Roadmap, file-tree, supported-agents table, and launcher section
  updated to reflect `agentmind-cli` defaulting to Claude (v0.2.1)
  and `--no-agent` for dashboard-only mode.

Also fixed three stale "0.2.2" version references in source-code
comments (storage.ts, smoke-codex.mjs) — those should be 0.2.0.

No production-code changes. `pnpm typecheck` is clean.
@imsobear
imsobear merged commit ad0aeb9 into main May 15, 2026
2 checks passed
@imsobear
imsobear deleted the docs/refresh-0.2.1 branch May 15, 2026 06:55
@imsobear imsobear mentioned this pull request May 15, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant