socket
Stuff for Agents on macOS
Promo audio: Socket Codex Marketplace Promo
Table of Contents
- Overview
- Quick Start
- Usage
- Development
- Repo Structure
- Release Notes
- License
- Plugin Status
Overview
Status
socket is maintained by Gale.
A couple things are a bit of a mess rn, I'll get it sorted at some point. Or, if you want, hit up my sponsors/Ko-Fi an this will become my top priority for a while ;)
What This Project Is
Socket is a collection of opinionated agent plugins, hooks, skills, MCPs, and workflows for Apple Platform Devs.
Experiments abound, some things will be broken at any given time, and anything I end up hating, or rarely using, will get removed unceremoniously.
Motivation
Agents are great (at some things), but to do specialized work, they need specialized tools. Socket is a catalog of my attempts to build said tools for the things I do.
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 portable skills, translated MCP configuration, and a focused
Hermes operator/developer workflow set:
hermes skills tap add gaelic-ghost/socket
hermes skills install gaelic-ghost/socket/choose-hermes-agent-workflow
The workflow router covers everyday operation, extension development, the
Hermes messaging gateway, and Nous Research services such as Portal and Tool
Gateway. It also routes Hermes-in-Zed or Hermes-in-Xcode work through the ACP
operation skills. 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 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:
- Open Xcode Settings.
- Select Intelligence.
- Open Plug-ins.
- Choose Add Plug-in.
- Choose Add from URL.
- 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.
Use agent-portability-skills:operate-zed-agent for Zed Agent, ACP External
Agent, and Terminal Thread selection. Zed's own Agent uses Zed-native skills and
MCP configuration; external agents retain their native configuration. Hermes
supports hermes acp, but it is not currently present in the canonical ACP
Registry, so verify the live registry and use Zed's official custom-agent path
until the entry is actually published.
Usage
Use socket when you want one Codex catalog for focused agent workflow plugins.
Currently available from the catalog:
agent-portability-skills
agent-engineering-skills
android-dev-skills
apple-creator-studio-skills
apple-dev-skills
cloud-deployment-skills
cloud-inference-skills
cybersecurity-skills
codebase-understanding-skills
messaging-collaboration-skills
model-lab-skills
agentdeck
dotnet-skills
game-dev-skills
network-protocol-skills
professional-skills
python-skills
repository-skills
reverse-engineering-skills
server-side-jvm
server-side-swift
swift-lang
rust-skills
speak-swiftly
web-dev-skills
Development
For setup, local workflow, validation, review, release, and maintainer expectations, see CONTRIBUTING.md. For the consolidated child backlog, see ROADMAP.md. For agent-facing repo rules, see AGENTS.md.
For Xcode 27 beta Markdown editing and repository browsing, open Socket.xcworkspace. It is a browse-only workspace for docs, plugin payloads, scripts, and marketplace metadata; it is not a root build surface.
Repo Structure
.
├── .agents/
│ └── plugins/marketplace.json
├── docs/
│ ├── agents/
│ ├── media/
│ └── maintainers/
├── plugins/
├── scripts/
├── AGENTS.md
├── CONTRIBUTING.md
├── README.md
├── Socket.xcworkspace
└── 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.
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:
agent-plugin-skills: fixed-policy Codex plugin creation and repository-wide
plugin maintenance through managed FSX assets and exactly
just plugins-check and just plugins-apply
agent-portability-skills: cross-host protocol selection, ACP operation/development, Zed native/external/terminal workflows, Hermes operator/developer/gateway/Nous Research guidance, and source-bundled maintainer roles for Socket-owned skill portability and host adapter audits
agent-engineering-skills: portable coordinator/worker, external-agent, scheduling, and worktree/thread orchestration guidance; it also owns agent automation, eval, and n8n workflow design
android-dev-skills: Android, Kotlin, Java, Gradle, Android Gradle Plugin, Compose/XML UI, testing, lint, emulator-aware validation handoff, and release-readiness workflow guidance
apple-creator-studio-skills: source-preserving Final Cut Pro editing, Motion template, Compressor delivery, Logic Pro production, MainStage concert, and GarageBand project workflows with local Help Viewer discovery, explicit Computer Use safeguards, and artifact or rehearsal verification
apple-dev-skills: Apple, Swift, SwiftPM, macOS-hosted boundary selection, custom Virtualization framework hosts, persistent Linux development guests, clean macOS development guests, imaging, Vision/Core ML, camera, spatial sensing, media/audio, SwiftUI, AppKit, Xcode, Safari, OpenAPI, and DocC workflows, plus the source-bundled swift-steward custom-agent definition with its own roadmap
cloud-deployment-skills: cloud provider deployment routing, official provider plugin selection, credential and mutation boundary checks, a reusable Dockerized-service release/deployment contract, AWS handoff to the official AWS Agent Toolkit, and Azure handoff to Microsoft's Azure Skills plugin rather than duplicated provider MCP or CLI setup
cloud-inference-skills: cloud AI inference, training, model conversion, and GPU infrastructure routing for Runpod, Hugging Face, AWS, Vast.ai, CoreWeave, and similar providers, with bundled Runpod MCP server configuration, upstream Runpod skill mirrors, and first-party Hugging Face/AWS handoffs
cybersecurity-skills: suspicious-content triage, evidence preservation, isolation selection, disposable Linux and macOS analysis-lab preparation, malware analysis, agentic security-tool controls, macOS investigation and defense, vulnerability validation, authorized testing, incident response, threat hunting, detection content, and clear non-specialist advice
codebase-understanding-skills: source-grounded code tracing and explanation, with the bounded code-slice-tracer role for evidence-first call-site, test, and documentation discovery
messaging-collaboration-skills: chat-app, bot, business-messaging, meeting-collaboration, iMessage collaboration, Communication Notifications, Push to Talk, VoIP/SIP, documented iOS/iPadOS default communication roles, and app-owned macOS client workflows for Discord, Telegram, Slack, Teams, WhatsApp Business, SMS/MMS/RCS, Google Meet, and Apple communication surfaces, with explicit Signal and Mac operator-automation boundaries
model-lab-skills: reproducible language-model experiment design, dataset preparation, fine-tuning, evaluation, checkpoint comparison, representation and steering research, refusal ablation, authorized jailbreak and tool-calling evaluation, runtime benchmarking, and current-source routing across Core AI, Core ML, MLX, ExecuTorch, and Foundation Models
agentdeck: local Codex runtime utilities, starting with hooks that prefix generated Codex thread titles with the project directory name
dotnet-skills: .NET, F#, and C# project-shape, bootstrap, implementation, local-first Semantic Kernel agent-service, test, package, diagnostics, ASP.NET Core, Giraffe, Falco, Oxpecker, interop, CI, upgrade, and tooling guidance
game-dev-skills: Apple platform game development workflows for native Metal and Metal 4 renderers, GPTK 3/4 routing, MetalFX, GPU asset streaming, experimental neural rendering, SpriteKit, SceneKit, GameplayKit simulation, Game Controller input, Core Haptics feedback, Xcode profiling, game-stack routing, and device-aware validation handoffs
network-protocol-skills: modern networking and application-protocol workflows for transport selection, HTTP/3 and QUIC planning, Media over QUIC draft-aware guidance, WebRTC signaling/media/data-channel work, and protocol diagnostics with stack-plugin handoffs
professional-skills: career and professional workflow guidance, starting with Dice job search and its bundled read-only remote MCP configuration
python-skills: focused diagnostics, packaging, tooling, CI, upgrade, and testing guidance for existing Python code
repository-skills: routed Git and GitHub collaboration, README,
CONTRIBUTING, AGENTS, ROADMAP, repository settings, protected-main release,
and Codex GUI worktree workflow guidance; its portable repository and
documentation workflows are available from the Hermes skill tap