# knotless agent plugins

Plugins for coding agents working on [knotless](https://knotless.dev), git
stored in your atproto account. The catalog is in Claude Code's format, so
the same repository installs into omp and Claude Code.

## knotless

- **MCP server**: `knotless-mcp`, one tool per `knotless` command:
  repositories, files with no clone, pulls, issues, reviews, runs and the
  merge queue.
- **Skill** `knotless`: how to name repositories and pulls, read without a
  clone, open a pull, read its checks, answer reviews and land it through
  the merge queue.

### Before installing

```sh
curl -fsSL https://knotless.dev/install.sh | sh   # knotless, knotless-mcp, git-remote-knotless
knotless login you.bsky.social
```

The MCP server acts as the account `knotless login` stored last. Set
`KNOTLESS_IDENTIFIER` in its environment to pin another.

### omp

```
/marketplace add https://knotless.dev/chadtmiller.com/agent-plugins.git
/marketplace install knotless@knotless
/reload-plugins
```

or `omp plugin marketplace add …` and `omp plugin install knotless@knotless`.

### Claude Code

```
/plugin marketplace add https://knotless.dev/chadtmiller.com/agent-plugins.git
/plugin install knotless@knotless
```

Keep the `.git`: without it Claude Code fetches the URL as a catalog file
rather than cloning it.

## Layout

```
.claude-plugin/marketplace.json        the catalog
plugins/knotless/
  .claude-plugin/plugin.json           name, version
  .mcp.json                            the knotless-mcp server
  skills/knotless/SKILL.md             the skill
```

A change to a plugin bumps `version` in its `plugin.json`; installs pick it
up with `/marketplace update knotless` then `/marketplace upgrade`.