Skip to content

docs(integrations/openmanus): update to v0.6.0 — bourdon CLI, commit_to_federation, PATH gotcha#60

Merged
ryandavispro1-cmyk merged 1 commit into
mainfrom
docs/openmanus-update-to-v0.6.0
May 13, 2026
Merged

docs(integrations/openmanus): update to v0.6.0 — bourdon CLI, commit_to_federation, PATH gotcha#60
ryandavispro1-cmyk merged 1 commit into
mainfrom
docs/openmanus-update-to-v0.6.0

Conversation

@ryandavispro1-cmyk
Copy link
Copy Markdown
Contributor

@ryandavispro1-cmyk ryandavispro1-cmyk commented May 13, 2026

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:

  1. Stale command. This doc still uses `python -m core.l6_server` everywhere. Every other published integration doc (`claude-desktop.md`, `claude-code.md`, `cursor.md`) uses `bourdon serve --quiet` — the `bourdon` CLI shipped in v0.5.0 and is the canonical pattern. This doc was the odd one out.
  2. Missing `commit_to_federation`. v0.6.0 shipped the write-side tool 2026-05-11. The tool table here only lists the six read-side tools from v0.5.0. OpenManus is exactly the kind of cloud-only agent that benefits from the write-side path (no adapter code needed; the agent contributes via MCP directly).
  3. No PATH gotcha. MCP subprocesses inherit a minimal PATH, so `"command": "bourdon"` silently fails when Bourdon lives in a venv. Both `claude-desktop.md` and `claude-code.md` document this; this doc didn't.

Changes

  • Tool table gains a `commit_to_federation` row marked `(v0.6.0+)`.
  • Prerequisites step 1: `pip install bourdon (currently 0.3.0)` → `pip install 'bourdon[server]'` (no version pin — drifts less). Drops the dual `bourdon` + `python -m core.l6_server` requirement in favor of just the CLI.
  • Prerequisites step 3 verification command: `python -m core.l6_server --library ~/agent-library` → `bourdon serve --quiet`.
  • Three config blocks updated (default stdio, stdio with `--library`, HTTP/sse fallback). All now use `bourdon serve [--quiet]`.
  • Troubleshooting bullet about Python paths replaced with a pointer to the new PATH gotcha section.
  • New PATH gotcha section at the end mirroring the 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.

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

  • All three config-block JSON snippets validate
  • PATH gotcha section content matches `claude-desktop.md` and `claude-code.md` for consistency
  • No links broken (`docs/agent-integration-status.md`, `docs/integrations/claude-code.md` exist after PR docs: add Claude Code MCP integration guide #58)
  • CI green

🤖 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 --quiet CLI (including install instructions and all stdio/--library/HTTP examples) instead of python -m core.l6_server.

Adds the new commit_to_federation tool 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.

…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.
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

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.

@ryandavispro1-cmyk ryandavispro1-cmyk merged commit 259de2b into main May 13, 2026
18 checks passed
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.

1 participant