baz

Baz Plugin

The Baz plugin adds three indexed search tools to your agent — repo_search, remote_grep, and remote_file_search — and a skill that routes searches through Baz while keeping reads on gh / glab.

Designed for planning features against repositories you haven't checked out locally. Indexed search across the whole org, no clone, no rate limits.

Install

Claude Code

/plugin marketplace add baz-scm/baz-plugin
/plugin add baz
/reload-plugins

Claude Code reads .claude-plugin/marketplace.json, .claude-plugin/plugin.json, loads skills/baz-codebase-exploration/SKILL.md, and registers the Baz MCP server and hook. First time you use a Baz tool, your browser opens for OAuth (Descope) — log in with your Baz account.

OpenAI Codex CLI

codex plugin install baz-scm/baz-plugin@main

Codex reads .codex-plugin/plugin.json and wires the same skill + MCP server. OAuth flow is identical to Claude Code's.

Cursor

Cursor doesn't auto-install MCP servers. Two manual steps:

1. Add the rule. Copy .cursor/rules/baz-codebase-exploration.mdc into your project's .cursor/rules/ directory, or globally to ~/.cursor/rules/.
2. Wire the MCP server. Open Cursor Settings → MCP and add:

   {
     "mcpServers": {
       "baz": {
         "type": "http",
         "url": "https://baz.co/mcp"
       }
     }
   }
   

   Cursor will open the OAuth flow on first use.

What you get

• repo_search(keywords, domains?) — semantic search across indexed architecture summaries. Works across every repo in your org, and across the per-domain summaries of a single large monorepo. No gh equivalent.
• remote_grep(repository, pattern, path) — indexed regex grep inside one repo, scoped to a path. ~2 lines of context per match.
• remote_file_search(repository, pattern) — glob file-name search inside one repo. Useful when you have a naming hunch but not the exact path.

The baz-codebase-exploration skill teaches the agent when to use which, and to stop searching and start reading once it has a hit. It loads automatically when relevant.

Planning command

The plugin also ships a manually-invoked planning command, /baz:plan-with-baz. Run it with a short description of what you want to build:

/baz:plan-with-baz add rate limiting to the public API

It enters plan mode (where the harness supports it), explores the relevant repos with the Baz tools — including repos you haven't checked out — and writes a structured implementation plan you approve before any code is written.

Platform	How to invoke	Plan mode
Claude Code	/baz:plan-with-baz <description>	enters plan mode automatically (one-click confirm)
Cursor	/plan-with-baz <description>	prompts you to switch to Plan mode
Codex	invoke the plan-with-baz skill	runs read-only, no writes until you approve

License

MIT