Skip to content

docs: promote independent review headline#69

Merged
Meru143 merged 1 commit intomainfrom
codex/landing-page-polish
Apr 4, 2026
Merged

docs: promote independent review headline#69
Meru143 merged 1 commit intomainfrom
codex/landing-page-polish

Conversation

@Meru143
Copy link
Copy Markdown
Owner

@Meru143 Meru143 commented Apr 4, 2026

Summary

  • move the strongest positioning line into the hero headline
  • move the former hero headline into the supporting section title
  • fix the npm install example to use the real \�rgus\ binary name

Verification

  • rendered the landing page locally with agent-browser and reviewed the updated hero

Summary by CodeRabbit

  • Documentation
    • Updated messaging and headlines to better emphasize Argus's AI code review capabilities
    • Revised installation and usage command examples for clarity

Copilot AI review requested due to automatic review settings April 4, 2026 10:41
@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Apr 4, 2026

📝 Walkthrough

Walkthrough

The pull request updates docs/index.html by swapping the messaging emphasis between the hero headline and "Why Argus" section, changing taglines to highlight different value propositions. Additionally, CLI command references were updated from npx argus-ai to npx argus throughout the usage examples.

Changes

Cohort / File(s) Summary
Documentation Landing Page
docs/index.html
Swapped hero <h1> and "Why Argus" <h2> taglines; updated all CLI command examples from npx argus-ai to npx argus (init and review commands).

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

Possibly related PRs

  • docs: add custom landing page #66: Main PR updating the same docs/index.html hero text and CLI snippet changes (swapping taglines and adjusting npx command references).

Poem

🐰 The messaging hops anew, from homework-grading tales told,
To codebase understanding, worth more than gold.
Commands now simpler—argus beats argus-ai old,
A cleaner path to code review, brave and bold! ✨

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'docs: promote independent review headline' accurately reflects the main change: repositioning the 'AI code review that actually understands your codebase' message to the hero headline to promote independent code review positioning.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch codex/landing-page-polish

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR updates the docs landing page messaging by swapping the hero headline and the “Why Argus” section title, and adjusts the npm install example to use the argus CLI name.

Changes:

  • Promote “Your coding agent should not grade its own homework.” to the hero headline and move the prior hero headline to the “Why Argus” section.
  • Update the npm snippet to reference argus instead of argus-ai in the command examples.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +178 to +180
<pre><code>npx argus init
export GEMINI_API_KEY=your-key
git diff HEAD~1 | npx argus-ai review --repo .</code></pre>
git diff HEAD~1 | npx argus review --repo .</code></pre>
Copy link

Copilot AI Apr 4, 2026

Choose a reason for hiding this comment

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

The npm quickstart uses npx argus ... without first installing the argus-ai package locally. Since the published npm package name is argus-ai (and it provides a argus bin), this command will likely try to fetch a different package named argus and fail / run the wrong tool. Consider either (a) showing an explicit install step (so npx argus resolves from node_modules/.bin), or (b) using npx's package flag to run the argus binary from the argus-ai package.

Copilot uses AI. Check for mistakes.
Copy link
Copy Markdown

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@docs/index.html`:
- Around line 178-180: Update the missing-binary user-facing message in the CLI
bootstrap script (the npm/bin/argus launcher) so it uses the same CLI name as
docs and examples: replace any occurrence of "npx argus-ai" in the error/help
output with "npx argus" and ensure both the binary name string and any related
usage/help variables in npm/bin/argus are consistent (search for the string
"argus-ai" and change to "argus").
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: f9afbaba-d4ed-43d5-98e0-e13847efc154

📥 Commits

Reviewing files that changed from the base of the PR and between 2a9673e and 21a1a77.

📒 Files selected for processing (1)
  • docs/index.html

Comment on lines +178 to +180
<pre><code>npx argus init
export GEMINI_API_KEY=your-key
git diff HEAD~1 | npx argus-ai review --repo .</code></pre>
git diff HEAD~1 | npx argus review --repo .</code></pre>
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

Keep CLI naming consistent with runtime error guidance.

The docs now correctly use npx argus, but npm/bin/argus still tells users to run npx argus-ai when the binary is missing. That inconsistency can mislead users during onboarding.

🔧 Proposed follow-up fix in npm/bin/argus
-  console.error(
-    "argus binary not found. Run `npm install` or `npx argus-ai` to download it."
-  );
+  console.error(
+    "argus binary not found. Run `npm install` or `npx argus` to download it."
+  );
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/index.html` around lines 178 - 180, Update the missing-binary
user-facing message in the CLI bootstrap script (the npm/bin/argus launcher) so
it uses the same CLI name as docs and examples: replace any occurrence of "npx
argus-ai" in the error/help output with "npx argus" and ensure both the binary
name string and any related usage/help variables in npm/bin/argus are consistent
(search for the string "argus-ai" and change to "argus").

Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 21a1a7786a

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

<article class="install-card">
<h3>npm</h3>
<pre><code>npx argus-ai init
<pre><code>npx argus init
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P1 Badge Use published package name in npx example

The npm install snippet now calls npx argus ..., but this repo publishes the package as argus-ai (npm/package.json line 2) and only maps argus as its bin (line 13). npm exec/npx treats the first positional token as the package spec when --package is not provided (npm exec -- <pkg>[@<version>] ...), so on a clean environment npx argus resolves package argus rather than argus-ai; this can make the documented install path run the wrong package or fail.

Useful? React with 👍 / 👎.

@Meru143 Meru143 merged commit f53a935 into main Apr 4, 2026
6 checks passed
@Meru143 Meru143 deleted the codex/landing-page-polish branch April 4, 2026 10:44
@Meru143 Meru143 mentioned this pull request Apr 4, 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.

2 participants