Repository navigation
Conversation
Retires stale Caveman/Ponytail branding (now agentflare optimize output/code, built into the binary rather than separate companion plugins) and documents the full feature set shipped since — daemon, agentflare work, vent, serve dashboard, global search, flare-proxy, git-aware branch guard, auth vault, skill registry, and more. - README.md / CONTRIBUTING.md: accurate feature tables, regenerated Architecture section against the real src/ tree, corrected MIT->Apache-2.0 license mismatch - AGENTS.md: fixed false claim that caveman/ponytail still work as CLI aliases - STATUS.md: fixed stale no-daemon claim and Caveman/Ponytail wiring line - docs-site/: expanded from a single-feature (flare-docs) site into a full product reference - overview, getting started, concepts, CLI reference, MCP tools reference, guides, comparisons, with flare-docs demoted to one feature page among many - site/public/index.html: landing page copy pass to reflect the current capability set
|
Note Reviews pausedIt looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the Use the following commands to manage reviews:
Use the checkboxes below for quick actions:
No actionable comments were generated in the recent review. 🎉 ℹ️ Recent review info⚙️ Run configurationConfiguration used: Path: .coderabbit.yaml Review profile: CHILL Plan: Pro Plus Run ID: 📒 Files selected for processing (7)
🚧 Files skipped from review as they are similar to previous changes (7)
📝 WalkthroughWalkthroughDocumentation and product-facing copy now describe built-in optimization, multi-agent coordination, expanded CLI/MCP surfaces, updated installation workflows, refreshed flare-docs guidance, and Apache License 2.0 terms. ChangesProduct model and repository documentation
Documentation information architecture
Installation and workflows
Command and MCP reference
Flare-docs reference
Landing-page product copy
Estimated code review effort: 3 (Moderate) | ~25 minutes Possibly related PRs
🚥 Pre-merge checks | ✅ 5✅ Passed checks (5 passed)
✨ Finishing Touches🧪 Generate unit tests (beta)
Comment |
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
There was a problem hiding this comment.
Actionable comments posted: 5
Caution
Some comments are outside the diff and can’t be posted inline due to platform limitations.
⚠️ Outside diff range comments (1)
docs-site/src/content/docs/cli.md (1)
18-579: 📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick winAdd language identifiers to all affected documentation fences.
The same MD040 issue appears across the documentation pages:
docs-site/src/content/docs/cli.md#L18-L579: label shell, JSON, text, and other fenced examples appropriately.docs-site/src/content/docs/guides.md#L74-L103: label the three unlabelled workflow examples.docs-site/src/content/docs/mcp-tools.md#L25-L285: label the tool-call examples.docs-site/src/content/docs/flare-docs.md#L46-L46: label the raw error example astext.🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the rest with a brief reason, keep changes minimal, and validate. In `@docs-site/src/content/docs/cli.md` around lines 18 - 579, Label every affected documentation code fence with an appropriate language identifier to resolve MD040: update shell, JSON, text, and other examples in docs-site/src/content/docs/cli.md lines 18-579; label the three workflow examples in docs-site/src/content/docs/guides.md lines 74-103; label tool-call examples in docs-site/src/content/docs/mcp-tools.md lines 25-285; and mark the raw error example as text in docs-site/src/content/docs/flare-docs.md line 46.Source: Linters/SAST tools
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In `@docs-site/src/content/docs/compare.md`:
- Around line 19-25: Update the command references in the comparison text to use
the canonical `agentflare optimize output` and `agentflare optimize code`
spellings, replacing any bare optimize subcommands. Preserve the surrounding
explanation and clarify that `flare` and `opt` are backward-compatible aliases
while `caveman` and `ponytail` are not live aliases.
In `@docs-site/src/content/docs/getting-started.md`:
- Around line 22-23: Update the getting-started documentation around the
`agentflare init --agent <host>` example to reflect that initialization prompts
for confirmation by default. Either state that `-y`/`--yes` skips the prompt or
include that flag in the command example, while preserving the
one-command-per-tool guidance.
In `@README.md`:
- Around line 123-128: Update the fenced code block containing the lean-ctx,
optimize output, optimize code, and memory metrics with an appropriate language
tag such as text or console, without changing its contents.
- Around line 61-80: Update the paragraph immediately following the coordination
table to remove the stale “no daemon” claim and the implication that all
functionality is accessed through stdio MCP. Clearly distinguish the opt-in
daemon and dashboard paths from the MCP transport, while preserving the
surrounding architecture description.
In `@site/public/index.html`:
- Around line 430-433: Update the claim text in the table row for the optimize
code result to remove the unsupported “100% safe” wording; replace it with the
exact safety outcome verified by the methodology, or omit the safety claim
entirely while preserving the other metrics.
---
Outside diff comments:
In `@docs-site/src/content/docs/cli.md`:
- Around line 18-579: Label every affected documentation code fence with an
appropriate language identifier to resolve MD040: update shell, JSON, text, and
other examples in docs-site/src/content/docs/cli.md lines 18-579; label the
three workflow examples in docs-site/src/content/docs/guides.md lines 74-103;
label tool-call examples in docs-site/src/content/docs/mcp-tools.md lines
25-285; and mark the raw error example as text in
docs-site/src/content/docs/flare-docs.md line 46.
🪄 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: Path: .coderabbit.yaml
Review profile: CHILL
Plan: Pro Plus
Run ID: 3d9e8b47-ff8a-4551-a87c-f15f7388e908
📒 Files selected for processing (17)
AGENTS.mdCONTRIBUTING.mdREADME.mdSTATUS.mddocs-site/astro.config.mjsdocs-site/src/content/docs/cli.mddocs-site/src/content/docs/compare.mddocs-site/src/content/docs/concepts.mddocs-site/src/content/docs/examples.mddocs-site/src/content/docs/flare-docs.mddocs-site/src/content/docs/getting-started.mddocs-site/src/content/docs/guides.mddocs-site/src/content/docs/how-it-works.mddocs-site/src/content/docs/index.mdxdocs-site/src/content/docs/mcp-tool.mddocs-site/src/content/docs/mcp-tools.mdsite/public/index.html
💤 Files with no reviewable changes (3)
- docs-site/src/content/docs/mcp-tool.md
- docs-site/src/content/docs/how-it-works.md
- docs-site/src/content/docs/examples.md
- compare.md: use canonical agentflare optimize output/code spellings, note flare/opt aliases vs caveman/ponytail - getting-started.md: clarify -y/--yes skips secondary init prompts - README.md: correct no-daemon claim, distinguish opt-in daemon/dashboard from MCP transport; label real-usage code fence - site/public/index.html: drop unsupported 100% safe claim, state measured outcome - mcp-tools.md, guides.md, flare-docs.md: label MD040-flagged code fences
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
agentflare optimize output/agentflare optimize code, built into the binary rather than separate companion pluginsagentflare work,vent,servedashboard, globalsearch(17 sources),flare-proxy, git-aware branch guard, auth vault, skill registry, and moredocs-site/from a single-feature site (onlyflare-docs) into a full product reference: overview, getting started, concepts, CLI reference (30 commands), MCP tools reference (24 tools), guides, comparisons —flare-docsdemoted to one feature page among manysite/public/index.htmlmarketing copy to reflect the current capability setLICENSE/Cargo.tomlsay Apache-2.0)agentflare caveman/agentflare ponytailstill work as CLI aliases (onlyflare/optdo)Driven by a full feature census (CLI surface, MCP tool surface, component registry, changelog, workspace crates) read directly from source, not memory — every command/tool/flag named in the new docs was verified against
src/.Design spec: item #406.
Test plan
docs-sitebuilds cleanly (astro build— 9 pages generated, no broken links/frontmatter errors)/docs/*cross-links after merging all changesSummary by CodeRabbit