things-app

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 by Gaelic Ghost.

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. Socket is a shared catalog for focused Codex plugins, hooks, skills, and MCP-backed workflows.

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.

Hermes Agent

Socket publishes an explicit Hermes compatibility surface for portable skills and translated MCP configuration:

hermes skills tap add gaelic-ghost/socket
hermes skills install gaelic-ghost/socket/hermes-agent-compatibility

Codex plugin bundles remain host-specific. See the Hermes compatibility guide for the available skill tap, MCP translations, and the cases that need a native Hermes plugin.

Claude Code and Cowork

Socket also publishes a Claude marketplace. In Claude Code, add it with:

claude plugin marketplace add gaelic-ghost/socket

Then install the individual Socket plugins you want. Cowork users can add the same GitHub marketplace from Customize → Plugins. Socket skills work in both hosts; local Mac integrations such as Xcode, Cardhop, and Things are Claude Code-only. Speak Swiftly remains unavailable in this catalog until its standalone payload has a Claude-native hook boundary. See the Claude compatibility guide for the full support boundary and update flow.

Xcode 27 Beta

For Xcode 27 beta, add Socket through Xcode's official Plug-ins UI:

1. Open Xcode Settings.
2. Select Intelligence.
3. Open Plug-ins.
4. Choose Add Plug-in.
5. Choose Add from URL.
6. Enter:

https://github.com/gaelic-ghost/socket.git

Xcode should enumerate the Socket child plug-ins from the public repository and let you import only the plug-ins you trust and need.

The Import from Codex path is still under evaluation for Xcode 27 beta. In current local testing, Xcode can see Codex-installed plug-ins, but it may select stale standalone or local-cache payloads when the same plug-in also exists outside the current Socket marketplace install. Prefer Add from URL for Socket until that beta behavior is better understood.

Zed

For Zed's Codex external agent, install and update Socket through the normal Codex marketplace flow. Current local testing shows Zed's bundled codex-acp path inherits the user's normal Codex home by default, so Codex-in-Zed sees the same global ~/.codex config, Socket marketplace cache, installed plug-ins, skills, and MCP servers as the regular Codex CLI and GUI unless Zed or the adapter is launched with an explicit CODEX_HOME.

Zed's own first-party Agent uses Zed-native skills and MCP configuration. Treat that as a separate compatibility surface from Codex running inside Zed through ACP.

Usage

Use socket when you want one Codex catalog for focused agent workflow plugins.

Currently available from the catalog:

• agent-portability-skills
• android-dev-skills
• apple-creator-studio-skills
• apple-dev-skills
• cardhop-app
• cloud-deployment-skills
• cloud-inference-skills
• cybersecurity-skills
• messaging-collaboration-skills
• model-lab-skills
• agentdeck
• dotnet-skills
• game-dev-skills
• network-protocol-skills
• productivity-skills
• python-skills
• reverse-engineering-skills
• server-side-jvm
• server-side-swift
• swift-lang
• rust-skills
• speak-swiftly
• swiftasb-skills
• things-app
• web-dev-skills

Plugin Status

Apple Dev Skills is Socket-owned under plugins/apple-dev-skills and keeps its public README because existing users can still arrive through the standalone compatibility marketplace. Other child planning now lives in ROADMAP.md.

Current Socket catalog shape: