Skip to content

docs: list gemini as a factory harness type and pair --claude-auth-secret with the claude-code alias - #699

Merged
hongyi-chen merged 3 commits into
mainfrom
docs/harness-identifiers-followup
Sep 8, 2026
Merged

hongyi-chen merged 3 commits into
mainfrom
docs/harness-identifiers-followup

Conversation

@hongyi-chen

Copy link
Copy Markdown
Collaborator

Follow-up to #689. Applies the two review suggestions from that PR that were not accepted before merge; both were verified against source.

Changes

  • platform/harnesses/index.mdx — The factory definition files bullet under "Harness identifiers" now lists the values the schema actually validates: oz, claude, codex, or gemini, plus claude-code as an alias for claude. Previously it said factories accept only the shared identifiers plus the alias, which contradicted factory-as-code.mdx (which already documents gemini). The intro sentence now also notes that the alias is fine where a surface explicitly accepts it. Source: warp-server/logic/factoryfile/schema/v1alpha1/common.schema.json (harness.type enum).
  • reference/cli/index.mdx--claude-auth-secret no longer says it is "only valid with --harness claude", since the --harness bullet directly above documents claude-code as an accepted alias. It now reads "Use with --harness claude or the --harness claude-code alias." Source: warp/crates/warp_cli/src/agent.rs defines claude-code as a clap alias for the same claude value.

Validation

  • python3 .agents/skills/style_lint/style_lint.py --changed — no new issues (the two reported findings are pre-existing and on untouched lines).
  • npm run build — passes.

Co-Authored-By: Warp agent@warp.dev

…cret with the claude-code alias

Follow-up to #689, applying the two review suggestions that were not
accepted there:

- Harness identifiers: the factory definition bullet now lists the
  values the schema actually validates (oz, claude, codex, gemini plus
  the claude-code alias) instead of implying factories accept only the
  shared identifiers, matching factory-as-code.mdx.
- CLI reference: --claude-auth-secret no longer says it is only valid
  with --harness claude, since the previous bullet documents claude-code
  as an accepted alias for the same harness.

Co-Authored-By: Warp <agent@warp.dev>
@cla-bot cla-bot Bot added the cla-signed label Sep 8, 2026
@vercel

vercel Bot commented Sep 8, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
docs Ready Ready Preview Sep 8, 2026 5:56am UTC

Request Review

Copy link
Copy Markdown
Collaborator Author

This PR was generated with Warp.

Comment @warp-agent on this PR to send it follow-up work.

View run View conversation

@warp-for-oss

warp-for-oss Bot commented Sep 8, 2026

Copy link
Copy Markdown
Contributor

@hongyi-chen

I'm starting a first review of this pull request.

You can view the conversation on Warp.

I completed the review and no human review was requested for this pull request.

Comment /warp-agent-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

@warp-for-oss warp-for-oss Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Overview

This PR narrows the harness identifier guidance in two docs reference sections: factory definition files now explicitly include gemini, and --claude-auth-secret now matches the documented claude-code alias behavior.

Concerns

  • No blocking correctness, docs quality, security, or spec-alignment concerns were found in the changed lines.

Verdict

Found: 0 critical, 0 important, 0 suggestions

Approve

Comment /warp-agent-review on this pull request to retrigger a review (up to 3 times on the same pull request).

Powered by Oz

@warp-agent-staging warp-agent-staging Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Overview

This updates the harness reference to match the factory schema and documents that --claude-auth-secret works with the CLI's claude-code alias. The implementation sources confirm both claims, and I found no material issues.

Verdict

Checks: build pass, tests n/a, CI green, visual proof n/a

Found: 0 critical, 0 important, 0 suggestions, 0 nits

Approve

Responding as wilson: Open session · View in factory

@hongyi-chen
hongyi-chen enabled auto-merge (squash) September 8, 2026 05:53
@hongyi-chen
hongyi-chen merged commit 126465e into main Sep 8, 2026
10 of 11 checks passed
@hongyi-chen
hongyi-chen deleted the docs/harness-identifiers-followup branch September 8, 2026 05:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant