# Oh My Claudeagent

> Multi-agent orchestration plugin for Claude Code — hooks, agents, skills, and MCP servers

- **Type:** MCP server
- **Install:** `agentstack add mcp-utsavbalar1231-oh-my-claudeagent`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [UtsavBalar1231](https://agentstack.voostack.com/s/utsavbalar1231)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [UtsavBalar1231](https://github.com/UtsavBalar1231)
- **Source:** https://github.com/UtsavBalar1231/oh-my-claudeagent

## Install

```sh
agentstack add mcp-utsavbalar1231-oh-my-claudeagent
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# oh-my-claudeagent

Multi-agent system for Claude Code. Specialist agents for planning, execution, review, debugging, research — with persistence, parallel execution, and natural language activation.

## Installation

```bash
claude plugin marketplace add UtsavBalar1231/oh-my-claudeagent
claude plugin install oh-my-claudeagent@omca
```

Or from inside a Claude Code session:

```
/plugin marketplace add UtsavBalar1231/oh-my-claudeagent
/plugin install oh-my-claudeagent@omca
```

### Team Setup

Add to your project's `.claude/settings.json` so team members get the plugin automatically:

```json
{
  "extraKnownMarketplaces": {
    "omca": {
      "source": {
        "source": "github",
        "repo": "UtsavBalar1231/oh-my-claudeagent"
      }
    }
  },
  "enabledPlugins": {
    "oh-my-claudeagent@omca": true
  }
}
```

For GitHub Enterprise Server, use full git URLs in the source:

```json
{
  "extraKnownMarketplaces": {
    "omca": {
      "source": {
        "source": "git",
        "url": "git@github.example.com:org/oh-my-claudeagent.git"
      }
    }
  }
}
```

### Update

```bash
/plugin marketplace update omca
```

### Local cache rebuild

Rebuild the locally-installed plugin cache from your dev tree:

```bash
bash scripts/package-plugin.sh ~/.claude/plugins/cache/omca/oh-my-claudeagent/$(jq -r .version .claude-plugin/plugin.json)/
```

Use `--dry-run` first to preview the file list. The script excludes dev artifacts (`.omca/`, `.mypy_cache/`, `UPGRADE.md`, `tests/`, etc.) that should not ship.

### Uninstall

```bash
/plugin uninstall oh-my-claudeagent@omca
```

## Quick Start

Run `/oh-my-claudeagent:omca-setup` to configure and verify dependencies. Then:

- "create plan for [your task]" — planning pipeline
- `/oh-my-claudeagent:start-work` — execute a ready plan
- `/loop 10m /oh-my-claudeagent:start-work` — re-run on a timer via native `/loop` (lightweight, not a verified persistence loop)

## What You Get

Specialist agents, skills via slash commands or keyword triggers, bundled MCP servers
(omca: structural search + state, grep.app: public code search, context7: library docs),
hooks for persistence, context injection, and auto-approval.

### Heads-up — `worktree.baseRef` and unpushed commits

Worktree-isolated agents can silently miss your unpushed local commits. See
[Known Issues](docs/reference/known-issues.md#worktreebaseref-hides-unpushed-commits-by-default)
for the trap and the one-setting workaround.

## Requirements

- Claude Code CLI
- `jq`
- `uv`
- `python3` 3.10+
- `ast-grep` CLI (`ast-grep` or `sg`)

### For LLM agents

If you're an agent installing this plugin on someone's behalf, paste this after
install:

```
Run /oh-my-claudeagent:omca-setup, then verify: (1) it reports dependencies OK
(jq, uv, python3, ast-grep all found), (2) it confirms ~/.claude/settings.json
was updated with the orchestration block, (3) it prints a final summary with no
FAIL lines. If any check fails, run it again with --doctor and report the output.
```

## Documentation

- `OMCA.md` — Complete guide: agents, skills, workflows, MCP tools, runtime state, troubleshooting
- `CLAUDE.md` — Contributor internals: hook map, cross-file patterns, adding components
- [`docs/reference/known-issues.md`](docs/reference/known-issues.md): live limitations and workarounds
- [`docs/reference/configuration.md`](docs/reference/configuration.md): every user-facing setting, env var, and settings.json block

## Acknowledgments

Based on [oh-my-openagent](https://github.com/code-yeongyu/oh-my-openagent) by [@code-yeongyu](https://github.com/code-yeongyu).

## License

MIT

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [UtsavBalar1231](https://github.com/UtsavBalar1231)
- **Source:** [UtsavBalar1231/oh-my-claudeagent](https://github.com/UtsavBalar1231/oh-my-claudeagent)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-utsavbalar1231-oh-my-claudeagent
- Seller: https://agentstack.voostack.com/s/utsavbalar1231
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.
