docs(integrations/openmanus): update to v0.6.0 — bourdon CLI, commit_to_federation, PATH gotcha#60
Merged
Conversation
…to_federation, PATH gotcha Three things drift between this doc and current Bourdon state: 1. The doc still shows `python -m core.l6_server` as the canonical command. v0.5.0 shipped the `bourdon` CLI with a `serve` subcommand; every other published integration doc (Claude Desktop, Claude Code, Cursor) uses `bourdon serve --quiet`. This doc was the odd one out, and the inconsistency was caught when filing the equivalent stdio example over on FoundationAgents/OpenManus#1363 — that PR uses `bourdon serve --quiet` per the canonical pattern. 2. The tool table only lists six read-side tools. v0.6.0 (shipped 2026-05-11) added `commit_to_federation`, the write-side tool that lets cloud-only agents like OpenManus contribute to the federation directly via MCP without needing a Bourdon-side adapter. 3. No PATH-gotcha note. MCP subprocesses inherit a minimal PATH, so `"command": "bourdon"` silently fails for users whose Bourdon lives in a venv. Both `claude-desktop.md` and `claude-code.md` document this; this doc didn't. Changes: - Tool table gains a row for `commit_to_federation`. - Prerequisites step 1 swaps `pip install bourdon (currently 0.3.0)` for `pip install 'bourdon[server]'` (no version pin — drifts less) and drops the dual `bourdon` + `python -m core.l6_server` requirement in favor of just the CLI. - Prerequisites step 3 verification: `bourdon serve --quiet` instead of `python -m core.l6_server --library ~/agent-library`. - Three config blocks updated: default stdio, stdio with `--library`, and the HTTP/sse fallback command. All three now use `bourdon serve [--quiet]` instead of `python -m core.l6_server`. - Troubleshooting bullet about Python paths replaced with a pointer to the new PATH gotcha section. - New PATH gotcha section at the end mirroring the same content in `claude-desktop.md` and `claude-code.md`. Documents the absolute-venv-path fix. No content changes to the visibility model, tradeoffs, or related sections. This is a CLI-pattern + version + missing-tool update, not a rewrite. Related: FoundationAgents/OpenManus#1363 — the upstream stdio example was updated to the same `bourdon serve --quiet` command in the same cleanup pass.
| 2. **Have at least one L5 manifest.** Bourdon needs something to federate. The fastest path: enable Bourdon's Claude Code adapter via the SessionEnd hook (see [`docs/agent-integration-status.md`](../agent-integration-status.md)) so that ending a Claude Code session writes `~/agent-library/agents/claude-code.l5.yaml`. After one session, you have something to query. | ||
| 3. **Verify the L6 server starts.** Run `python -m core.l6_server --library ~/agent-library` once in a terminal. You should see `Bourdon L6 server starting -- library=...` and the process should stay attached on stdio. | ||
| 1. **Install Bourdon.** `pip install 'bourdon[server]'` (latest release; see [GitHub Releases](https://github.com/getbourdon/bourdon/releases) for the current version). The `bourdon` CLI must be on PATH for the OpenManus user — see the [PATH gotcha](#path-gotcha) note below if it isn't. | ||
| 2. **Have at least one L5 manifest.** Bourdon needs something to federate. The fastest path: enable Bourdon's Claude Code adapter via the SessionEnd hook (see [`docs/integrations/claude-code.md`](claude-code.md) or [`docs/agent-integration-status.md`](../agent-integration-status.md)) so that ending a Claude Code session writes `~/agent-library/agents/claude-code.l5.yaml`. After one session, you have something to query. |
There was a problem hiding this comment.
Bug: A Markdown link in the prerequisites points to claude-code.md, a file that does not exist, which will result in a 404 error for users.
Severity: MEDIUM
Suggested Fix
Create the missing claude-code.md file with the appropriate content. Alternatively, if the link is incorrect, update its target to the correct file. If the linked content is not supposed to exist, remove the link entirely.
Prompt for AI Agent
Review the code at the location below. A potential bug has been identified by an AI
agent. Verify if this is a real issue. If it is, propose a fix; if not, explain why it's
not valid.
Location: docs/integrations/openmanus.md#L28
Potential issue: The updated prerequisites in `docs/integrations/openmanus.md` introduce
a Markdown link `[docs/integrations/claude-code.md](claude-code.md)`. This link points
to a file, `claude-code.md`, which does not exist in the `docs/integrations/` directory.
Any user who follows the setup instructions for the Claude Code adapter and clicks this
link will encounter a 404 error, breaking the documentation flow and preventing them
from completing the setup.
Did we get this right? 👍 / 👎 to inform future reviews.
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
Brings `docs/integrations/openmanus.md` in line with current Bourdon state. Three drift issues caught while cleaning up the equivalent stdio example over on FoundationAgents/OpenManus#1363:
Changes
No content changes to the visibility model, tradeoffs, or related sections. This is a CLI-pattern + version + missing-tool update, not a rewrite.
Why this PR exists
PR #58 in this repo added `claude-code.md` using `bourdon serve --quiet` as the canonical command. PR FoundationAgents/OpenManus#1363 adds the same shape as an example in OpenManus's `mcp.example.json`. Both reference back to this doc. Without this PR, the trail of breadcrumbs leads readers to a doc that contradicts the example they just saw — exactly the kind of inconsistency that gets a downstream docs PR pushed back.
Test plan
🤖 Generated with Claude Code
Note
Low Risk
Documentation-only changes that update commands and troubleshooting guidance; no runtime or security-sensitive code paths are modified.
Overview
Updates the OpenManus integration docs to use the canonical
bourdon serve --quietCLI (including install instructions and all stdio/--library/HTTP examples) instead ofpython -m core.l6_server.Adds the new
commit_to_federationtool to the L6 tool table and introduces a PATH gotcha troubleshooting section explaining why"command": "bourdon"can fail under MCP subprocess PATHs and how to fix it with an absolute venv binary path.Reviewed by Cursor Bugbot for commit 04f65b9. Bugbot is set up for automated code reviews on this repo. Configure here.