Skip to content

Document agent marketplace installs #22

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
roshanjonah merged 1 commit into from
Jul 9, 2026
Merged

Document agent marketplace installs #22

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
54 changes: 41 additions & 13 deletions guides/agent-skills.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,9 +25,41 @@ Sendmux Agent Skills teach AI coding tools how to send email, read mailboxes, ma
`identity_assertion` or pre-claim token until the owner invite returns `202`.
</Info>

## Install
## Install from a marketplace

Install the full pack with the `skills` CLI.
Use the marketplace path when your AI tool supports plugins. It installs the full Sendmux pack and keeps marketplace updates separate from your project files.

<AccordionGroup>
<Accordion title="Claude app, Claude Desktop, and Cowork">
1. Open **Customize**.
2. Go to **Plugins**.
3. In **Personal plugins**, click **+** and choose **Add marketplace**.
4. Choose **Add from a repository**.
5. Enter `Sendmux/skills`, then install the **Sendmux** plugin.
</Accordion>

<Accordion title="Claude Code">
```text
/plugin marketplace add Sendmux/skills

@chatgpt-codex-connector chatgpt-codex-connector Bot Jul 9, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Point marketplace installs at an actual marketplace

This marketplace source does not contain the catalog files the clients require, so the new recommended install path fails before users can install the plugin. I checked the public Sendmux/skills tree and the direct .claude-plugin/marketplace.json and .agents/plugins/marketplace.json paths return 404; Claude Code docs require a .claude-plugin/marketplace.json catalog, and Codex docs read repo marketplaces from $REPO_ROOT/.agents/plugins/marketplace.json or the legacy .claude-plugin/marketplace.json. Until that repo publishes a real marketplace catalog, the Claude/Codex instructions here and in the supported-targets table send users to a non-installable source.

Useful? React with 👍 / 👎.

/plugin install sendmux@sendmux
/reload-plugins
```
</Accordion>

<Accordion title="Codex">
Add the marketplace first.

```bash
codex plugin marketplace add Sendmux/skills
```

Then open **Plugins** in the Codex app or `/plugins` in Codex CLI and install **Sendmux** from the Sendmux marketplace.
</Accordion>
</AccordionGroup>

## Install with Agent Skills

Use `skills add` when your agent supports raw Agent Skills rather than plugin marketplaces.

```bash
npx skills add Sendmux/skills
Expand All @@ -45,19 +77,15 @@ Update installed skills later.
npx skills update
```

Claude.ai and Claude Desktop do not use `skills add`. Upload a zipped individual skill folder through **Settings -> Capabilities/Features**.

## Supported targets

| Agent target | Project path | Global path |
| --- | --- | --- |
| Claude Code | `.claude/skills/` | `~/.claude/skills/` |
| Cursor | `.agents/skills/` | `~/.cursor/skills/` |
| Codex | `.agents/skills/` | `~/.codex/skills/` |
| GitHub Copilot / VS Code | `.agents/skills/` | `~/.copilot/skills/` |
| Windsurf | `.windsurf/skills/` | `~/.codeium/windsurf/skills/` |
| Gemini CLI | `.agents/skills/` | `~/.gemini/skills/` |
| Cline | `.agents/skills/` | `~/.agents/skills/` |
| Target | Recommended install |
| --- | --- |
| Claude app, Claude Desktop, Cowork | Add marketplace from repository `Sendmux/skills`, then install **Sendmux**. |
| Claude Code | `/plugin marketplace add Sendmux/skills`, then `/plugin install sendmux@sendmux`. |
| Codex app and Codex CLI | `codex plugin marketplace add Sendmux/skills`, then install **Sendmux** from **Plugins** or `/plugins`. |
| Agent Skills clients | `npx skills add Sendmux/skills`. |
| Single-skill installs | `npx skills add Sendmux/skills --skill <skill-name>`. |

## What the pack teaches

Expand Down
5 changes: 5 additions & 0 deletions guides/mcp-clients.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,11 @@ Use this page to connect Sendmux MCP to your AI client. Prefer hosted OAuth when
`smx_root_`, `smx_mbx_`, or private HTTP bearer tokens to version control.
</Warning>

<Info>
This page connects live Sendmux MCP tools. To install the Sendmux skills or
plugin marketplace first, use [Agent skills](/guides/agent-skills).
</Info>

## Choose a setup

<CardGroup cols={3}>
Expand Down