socket

The macOS Marketplace for Codex

Promo audio: Socket Codex Marketplace Promo

Table of Contents

• Overview
• Quick Start
• Usage
• Plugin Status
• Development
• Repo Structure
• Release Notes
• License

Overview

Status

socket is maintained and supported by Gale.

What This Project Is

Socket is a Marketplace of Plugins, Hooks, and MCP servers for Apple Platform Devs

Motivation

Agents are great, but to do specialized work, they need specialized tools. As I continued building skills for my workflows, I needed a place to distribute them from. Socket is that place. I hope you find these as useful as I have.

Quick Start

Add the socket marketplace to Codex with:

codex plugin marketplace add gaelic-ghost/socket

After adding socket, restart your Codex, open the plugin directory, select Socket, and then install your choice of plugins.

When the marketplace changes, refresh it with:

codex plugin marketplace upgrade socket

Newly added plugins can be installed from the same plugin directory inside Codex.

Usage

Use socket when you want one Codex catalog for Gale's agent-focused plugin set.

Currently available from the catalog:

• agent-plugin-skills
• apple-dev-skills
• cardhop-app
• productivity-skills
• python-skills
• speak-swiftly
• swiftasb-skills
• things-app

Plugin Status

Apple Dev Skills keeps its own roadmap because it is the remaining subtree-managed child with a deeper standalone release surface. Other child planning now lives in TODO.md.

Current Socket catalog shape:

• agent-plugin-skills: maintainer skills for skills-export and plugin-export repositories
• apple-dev-skills: Apple, Swift, SwiftUI, Xcode, and DocC workflows with its own roadmap
• cardhop-app: mixed skill plus bundled MCP server for Cardhop.app contact workflows
• productivity-skills: general-purpose maintainer and documentation workflow baseline
• python-skills: Python, uv, FastAPI, FastMCP, and pytest workflow plugin
• speak-swiftly: Git-backed Speak Swiftly plugin from the standalone SpeakSwiftlyServer repository
• swiftasb-skills: SwiftASB companion guidance
• things-app: mixed skill plus bundled MCP server for Things.app workflows

Placeholder directories for future plugins (not available for install):

• dotnet-skills
• rust-skills
• spotify
• web-dev-skills

Development

For setup, local workflow, validation, review, release, and maintainer expectations, see CONTRIBUTING.md. For the consolidated child backlog, see TODO.md. For agent-facing repo rules, see AGENTS.md.

Repo Structure

.
├── .agents/plugins/marketplace.json
├── docs/
│   ├── media/
│   └── maintainers/
├── plugins/
├── scripts/
├── AGENTS.md
├── CONTRIBUTING.md
├── README.md
├── TODO.md
└── ROADMAP.md

Release Notes

Use GitHub releases and Git history for root socket changes. Child plugins may carry their own release notes and maintainer docs.

License

The socket superproject, and all nested projects, are licensed under the Apache License 2.0. See LICENSE and NOTICE.