github-mirrors/oh-my-claudecode
1
0
Fork 0
mirror of https://fastgit.cc/github.com/Yeachan-Heo/oh-my-claudecode synced 2026-04-20 12:51:30 +08:00
Code Issues Packages Projects Releases Wiki Activity

docs: add omc symlink bootstrap and .mcp.json conflict resolution to CONTRIBUTING

Browse Source 
Contributors developing from a local checkout hit two undocumented
issues:

1. Flow A assumes `omc` is already installed globally, but a fresh
   clone has no `omc` command. Added a Bootstrap subsection showing
   how to symlink bridge/cli.cjs to ~/.local/bin/omc.

2. The repo's .mcp.json registers an MCP server named "t". When using
   --plugin-dir, the plugin also registers "t", causing a collision
   ("MCP server skipped — same command/URL as already-configured").
   Added disabledMcpjsonServers instruction inside Flow A.

Confidence: high
Scope-risk: narrow

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Peter Gagarinov
2026-04-10 18:21:47 +01:00
parent a75d5317eb
commit 568a493f87
1 changed files with 25 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

25
CONTRIBUTING.md
View File

@@ -90,6 +90,21 @@ All TypeScript and bundling steps are handled. The output goes to `dist/` and `b
Once built, you need to tell Claude Code to use your local checkout. Here are three flows:
### Bootstrap: make the `omc` command available
All three flows below use the `omc` CLI. If you don't have it installed globally (via `npm i -g oh-my-claude-sisyphus`), create a symlink from your checkout:
```bash
# Create ~/.local/bin if it doesn't exist
mkdir -p ~/.local/bin
# Symlink omc to the checkout's bridge entry point
ln -sf "$PWD/bridge/cli.cjs" ~/.local/bin/omc
# Verify (you may need ~/.local/bin on your PATH)
omc --version
```
### Flow A: `omc --plugin-dir` + `omc setup --plugin-dir-mode` (recommended — lowest friction)
**Advantages**: Single command, automatic env var handling, matches the OMC philosophy.
@@ -101,6 +116,16 @@ omc --plugin-dir "$PWD" setup --plugin-dir-mode
Then launch Claude Code normally — it will use your local checkout.
**Disable the `.mcp.json` server conflict**: The repo ships `.mcp.json` with an MCP server named `"t"` (the OMC bridge). When using `--plugin-dir`, the plugin also registers its own `"t"` server, causing a name collision. To resolve this, add to your `~/.claude/settings.json` (or `$CLAUDE_CONFIG_DIR/settings.json`):
```json
{
"disabledMcpjsonServers": ["t"]
}
```
This tells Claude Code to ignore the repo's `.mcp.json` entry and use the plugin's version instead.
**Inside Claude Code**:
```bash
/autopilot "your task here"