https://github.com/gaelic-ghost/socket
The macOS Marketplace for Codex | Plugins & Workflows for Apple Platform Devs, Apps, & Agents
https://github.com/gaelic-ghost/socket
agent-skill apple codex codex-plugin developer-tools macos mcp monorepo plugin-repo productivity swift things-app xcode
Last synced: 22 days ago
JSON representation
The macOS Marketplace for Codex | Plugins & Workflows for Apple Platform Devs, Apps, & Agents
- Host: GitHub
- URL: https://github.com/gaelic-ghost/socket
- Owner: gaelic-ghost
- License: apache-2.0
- Created: 2026-04-09T17:38:43.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-05-10T00:10:14.000Z (about 1 month ago)
- Last Synced: 2026-05-10T03:56:36.554Z (about 1 month ago)
- Topics: agent-skill, apple, codex, codex-plugin, developer-tools, macos, mcp, monorepo, plugin-repo, productivity, swift, things-app, xcode
- Language: Python
- Homepage:
- Size: 7.4 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Roadmap: ROADMAP.md
- Notice: NOTICE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# socket
*The macOS Marketplace for Codex*
Promo audio: [Socket Codex Marketplace Promo](./docs/media/socket-codex-marketplace-promo.mp3)
## Table of Contents
- [Overview](#overview)
- [Quick Start](#quick-start)
- [Usage](#usage)
- [Plugin Status](#plugin-status)
- [Development](#development)
- [Repo Structure](#repo-structure)
- [Release Notes](#release-notes)
- [License](#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:
```bash
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:
```bash
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 focused agent workflow plugins.
Currently available from the catalog:
- `agent-plugin-skills`
- `apple-dev-skills`
- `cardhop-app`
- `dotnet-skills`
- `productivity-skills`
- `python-skills`
- `server-side-swift`
- `rust-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](./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, Swift OpenAPI client, Safari, and DocC workflows with its own roadmap
- `cardhop-app`: mixed skill plus bundled MCP server for Cardhop.app contact workflows
- `dotnet-skills`: .NET, F#, and C# project-shape, bootstrap, implementation, test, package, diagnostics, ASP.NET Core, interop, CI, upgrade, and tooling guidance
- `productivity-skills`: general-purpose maintainer and documentation workflow baseline
- `python-skills`: Python runtime and tooling workflows for Python-based projects; see the [Python skills expansion plan](./docs/maintainers/python-skills-plugin-plan.md) for maintainer details
- `server-side-swift`: server-side Swift, Vapor, Hummingbird, persistence, OpenAPI, and RPC-fit workflows with SwiftPM-first build, run, test, framework-specific migration, database, generated transport, and diagnostics guidance
- `rust-skills`: Rust, Cargo, rustup, crate, workspace, CLI, library, package, CI, test, lint, and format workflow guidance
- `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):
- `spotify`
- `web-dev-skills`
## Development
For setup, local workflow, validation, review, release, and maintainer expectations, see [CONTRIBUTING.md](./CONTRIBUTING.md). For the consolidated child backlog, see [TODO.md](./TODO.md). For agent-facing repo rules, see [AGENTS.md](./AGENTS.md).
## Repo Structure
```text
.
├── .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](./LICENSE) and [NOTICE](./NOTICE).