Skip to content

docs(readme): Give Grok its mark, and say why two rows have none - #1022

Merged
omesser merged 2 commits into
mainfrom
docs/harness-brand-marks
Sep 26, 2026
Merged

omesser merged 2 commits into
mainfrom
docs/harness-brand-marks

Conversation

@omesser

@omesser omesser commented Sep 25, 2026 •

Copy link
Copy Markdown
Owner

Why

Six of nine named Harness rows carry a brand mark and three do not, so the table
reads as though someone forgot codex, grok and goose.

Nobody forgot. Simple Icons has a mark for none of the three, measured against
its full index of 3461 entries: no OpenAI, no xAI or Grok, no Block or Goose.
The nearest entries are OpenAI Gym, ngrok and Mongoose, all the wrong
product. Self-hosting is the only route, and that makes it a licensing question
rather than a design one.

I checked each vendor rather than assume. One of the three grants permission.

What changed

grok gets its mark. xAI's brand guidelines
say: "Use our Marks only to accurately refer to us or our services." A
comparison table naming Grok is exactly that. The same page requires the logo be
used "exactly as provided at the download link below, without any alteration or
adjustment."

So both official files ship unchanged from SpaceXAI_Grok_Assets.zip, and
<picture> picks between them by colour scheme. Their dark file is #0A0A0A
and their light file is white; either one alone would vanish on half of
GitHub's readers, and recolouring one would break the condition.

codex and goose stay bare, and the README does not say why. OpenAI's
design guidelines list under Don't: "Use the logo
without permission or outside OpenAI's terms", with permission requests routed to
partnercomms@openai.com. Block ships Goose under Apache 2.0, whose section 6
withholds trademark rights except for describing the origin of the work, and
neither the Goose repository nor block.xyz publishes a brand grant. Neither
clears "clearly permits". #1021 holds the detail; an earlier draft argued it in
the README and that paragraph is gone.

Attribution, including for what was already here. docs/readme/nous.svg has
been in the tree since #683 with no record of where it came from. That was a gap
before this pull request and it would have been a worse one after adding three
more marks, so the Prior Art and Attribution section now covers every mark: the
Grok files and their revocable permission, the Nous mark and the fact that its
source was not recorded, and Simple Icons for the rest.

How to verify

node --test tests/ passes 342. pre-commit run --files over the three touched
paths passes. Documentation and two SVGs, no product code.

Render check: the grok row shows a dark mark on GitHub's light theme and a white
one on dark.

Notes

This conflicts with #1017 on purpose-adjacent lines. That pull request
reorders the same tables; this one edits the grok row and the paragraph above
the launch table. Whichever lands second will need a small manual resolution. I
kept the diff to three hunks to make that cheap.

The permission xAI grants is revocable at their discretion, which the attribution
says rather than implying a settled right.

Closes #1021

🤖 Generated with Claude Code

— Claude Code agent, on @omesser's behalf.

Three Harness rows had no brand mark and the table read as an oversight.
Simple Icons carries no OpenAI, xAI or Block mark, measured against its full
3461-entry index, so the only route is self-hosting.

Only xAI grants one. Its brand guidelines permit using the marks "to
accurately refer to us or our services", on the condition that the logo is
used "exactly as provided" and unaltered, so both official files ship
unchanged and `<picture>` picks by theme rather than recolouring either.

OpenAI's guidelines say not to use the logo without permission, and Block
ships Goose under Apache 2.0, whose section 6 withholds trademark rights.
Neither clears the bar, so the README says so instead of leaving a reader to
wonder.

Attribution was missing for the one mark already self-hosted. `nous.svg` was
added in #683 with no record of where it came from; that gap is now written
down rather than quietly inherited.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@omesser
omesser force-pushed the docs/harness-brand-marks branch from 861988d to ccd079e Compare September 26, 2026 00:13
Comment thread README.md Outdated
`codex` and `goose` carry no mark. Simple Icons has neither, and neither vendor
grants one: OpenAI's guidelines say not to use the logo without permission, and
Block ships Goose under Apache 2.0, whose section 6 withholds trademark rights.
#1021 tracks it.

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

remove this. not interesting for README

Comment thread README.md Outdated
Harness brand marks identify each Harness and belong to their owners. The Grok
logomark is xAI's own file from [their brand guidelines](https://x.ai/legal/brand-guidelines),
used unaltered to refer to Grok, which those guidelines permit and may revoke.
The Nous Research mark (`docs/readme/nous.svg`) identifies the Hermes Harness and

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
The Nous Research mark (`docs/readme/nous.svg`) identifies the Hermes Harness and
The Nous Research mark (`docs/readme/nous.svg`) identifies the Hermes Harness.

Comment thread README.md Outdated
logomark is xAI's own file from [their brand guidelines](https://x.ai/legal/brand-guidelines),
used unaltered to refer to Grok, which those guidelines permit and may revoke.
The Nous Research mark (`docs/readme/nous.svg`) identifies the Hermes Harness and
was added in #683; its source file was not recorded at the time. Every other mark

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
was added in #683; its source file was not recorded at the time. Every other mark
Every other mark

Grok had no brand mark because Simple Icons carries none, and self-hosting
one is a licensing question rather than a design one.

xAI's brand guidelines permit using the marks "to accurately refer to us or
our services", on the condition that the logo is used "exactly as provided"
and unaltered. Both official files ship unchanged and `<picture>` picks by
theme, so neither is recoloured.

`codex` and `goose` stay bare. OpenAI's guidelines say not to use the logo
without permission, and Block ships Goose under Apache 2.0, whose section 6
withholds trademark rights. #1021 holds the detail; the README does not need
to carry the argument.

The Attribution section now covers every mark, including the Nous one that
was already here without a line.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@omesser

omesser commented Sep 26, 2026

Copy link
Copy Markdown
Owner Author

All three applied in adbe1485.

One thing I did beyond the suggestions: applying them left Every other mark on a line of its own, so I reflowed that paragraph. No wording changed.

The commit message also lost the three-paragraph defence and now says what the change is.

node --test tests/ 343 pass, pre-commit clean.

— Claude Code agent, on @omesser's behalf.

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.

docs(readme): Three Harness rows have no brand mark, and Simple Icons has none to give

1 participant