Skip to content

Local-first 🧠 memory for Hermes Agent that lives in your Obsidian vault and remembers project context. Nightly 😴 dream passes turn repeat corrections into confirmed preferences with measurable confidence. Adapters ship for Claude Code, Codex, and OpenClaw, with an MCP server for anything else.

TypeScript

docs: drop literal quoted-args anti-example, bump to v0.4.2

Sol Aitkenee294a6a2119
diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
index 467d20cf..2e46e333 100644
--- a/.claude-plugin/plugin.json
+++ b/.claude-plugin/plugin.json
@@ -1,6 +1,6 @@
{
"name": "open-second-brain",
- "version": "0.4.1",
+ "version": "0.4.2",
"description": "Plugin-first second brain package for AI agents and humans.",
"author": "Open Second Brain contributors",
"license": "MIT",
diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json
index c7586d56..430fafe8 100644
--- a/.codex-plugin/plugin.json
+++ b/.codex-plugin/plugin.json
@@ -1,6 +1,6 @@
{
"name": "open-second-brain",
- "version": "0.4.1",
+ "version": "0.4.2",
"description": "Plugin-first second brain package for Codex, Hermes, Claude Code, and other agent runtimes.",
"skills": "./skills",
"keywords": ["second-brain", "obsidian", "agents", "skills", "event-log", "mcp"]
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 533a234d..5c05ba1c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,6 +7,19 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
## [Unreleased]
+## [0.4.2] - 2026-05-06
+
+### Changed
+
+- Reworded the `--args` guidance in `after-install.md` and `docs/mcp.md` so
+ the docs no longer contain a literal copyable quoted-args anti-example.
+ The corrected `hermes mcp add open-second-brain --command o2b --args mcp
+ --vault /path/to/vault` example stays; the negative case is now described
+ in prose ("do not wrap all of those arguments into one quoted shell
+ string and do not repeat `--args` per token") so a careless copy/paste
+ cannot pick up the wrong form.
+- Bumped package, plugin, and Claude/Codex manifest versions to 0.4.2.
+
## [0.4.1] - 2026-05-06
### Added
@@ -92,7 +105,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
- Sandbox vault and plugin manifest fixtures for tests.
- GitHub release workflow for tag-based and manually dispatched releases.
-[unreleased]: https://github.com/itechmeat/open-second-brain/compare/v0.4.1...HEAD
+[unreleased]: https://github.com/itechmeat/open-second-brain/compare/v0.4.2...HEAD
+[0.4.2]: https://github.com/itechmeat/open-second-brain/compare/v0.4.1...v0.4.2
[0.4.1]: https://github.com/itechmeat/open-second-brain/compare/v0.4.0...v0.4.1
[0.4.0]: https://github.com/itechmeat/open-second-brain/compare/v0.3.1...v0.4.0
[0.3.1]: https://github.com/itechmeat/open-second-brain/compare/v0.3.0...v0.3.1
diff --git a/after-install.md b/after-install.md
index ac49d471..22ba9842 100644
--- a/after-install.md
+++ b/after-install.md
@@ -27,9 +27,10 @@ hermes gateway restart
`--args` is a single flag whose value is the remaining tokens on the line
(here: `mcp --vault /path/to/vault`). Hermes hands those tokens to the MCP
-server's command line as-is — do not wrap them in one quoted string like
-`--args 'mcp --vault /path/to/vault'`, and do not repeat `--args` per token.
-Edit `~/.hermes/config.yaml` instead if you prefer YAML.
+server's command line as-is. Do not wrap all of those arguments into one
+quoted shell string, and do not repeat `--args` per token — both forms make
+Hermes pass a single concatenated argument to the MCP server. Edit
+`~/.hermes/config.yaml` instead if you prefer YAML.
The CLI works on its own; the MCP server is opt-in. See `docs/mcp.md` for
tool schemas, per-tool arguments, and Claude Code / Codex notes.
diff --git a/docs/mcp.md b/docs/mcp.md
index cfc7b920..d02bca5c 100644
--- a/docs/mcp.md
+++ b/docs/mcp.md
@@ -63,9 +63,9 @@ hermes mcp add open-second-brain --command o2b --args mcp --vault /path/to/vault
`--args` is a single flag; everything after it on the line (here
`mcp --vault /path/to/vault`) is collected as the argument list and forwarded
-to the MCP server's command line. Do not wrap those tokens in a single
-quoted string like `--args 'mcp --vault /path'` (Hermes would treat the whole
-thing as one argument), and do not repeat `--args` per token.
+to the MCP server's command line. Do not wrap all of those arguments into one
+quoted shell string and do not repeat `--args` per token — both forms make
+Hermes pass a single concatenated argument to the MCP server.
You can also edit `~/.hermes/config.yaml` by hand:
diff --git a/plugin.yaml b/plugin.yaml
index 3d090152..d6398c54 100644
--- a/plugin.yaml
+++ b/plugin.yaml
@@ -1,5 +1,5 @@
name: open-second-brain
-version: "0.4.1"
+version: "0.4.2"
description: "Hermes plugin entrypoint for OpenSecondBrain vault health checks and the optional MCP tool server."
author: "OpenSecondBrain contributors"
kind: standalone
diff --git a/plugins/hermes/plugin.yaml b/plugins/hermes/plugin.yaml
index 96e2afa2..62d834fb 100644
--- a/plugins/hermes/plugin.yaml
+++ b/plugins/hermes/plugin.yaml
@@ -1,5 +1,5 @@
name: open-second-brain
-version: "0.4.1"
+version: "0.4.2"
description: "Hermes adapter for OpenSecondBrain vault health checks and optional MCP tool server."
author: "OpenSecondBrain contributors"
kind: standalone
diff --git a/pyproject.toml b/pyproject.toml
index 0081bcef..24ca8517 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
[project]
name = "open-second-brain"
-version = "0.4.1"
+version = "0.4.2"
description = "Hermes-first second brain package for Obsidian-compatible Markdown vaults."
readme = "README.md"
requires-python = ">=3.11"
diff --git a/src/open_second_brain/__init__.py b/src/open_second_brain/__init__.py
index 1023395c..482ab77c 100644
--- a/src/open_second_brain/__init__.py
+++ b/src/open_second_brain/__init__.py
@@ -1,3 +1,3 @@
"""Open Second Brain core package."""
-__version__ = "0.4.1"
+__version__ = "0.4.2"
diff --git a/src/open_second_brain/mcp.py b/src/open_second_brain/mcp.py
index 173b6422..d6d83c41 100644
--- a/src/open_second_brain/mcp.py
+++ b/src/open_second_brain/mcp.py
@@ -29,7 +29,7 @@ from open_second_brain.vault import list_vault_pages, parse_frontmatter, write_f
PROTOCOL_VERSION = "2025-06-18"
SERVER_NAME = "open-second-brain"
-SERVER_VERSION = "0.4.1"
+SERVER_VERSION = "0.4.2"
JSONRPC_VERSION = "2.0"
# JSON-RPC 2.0 error codes used by the MCP server.