swamp-club/swamp-codex-plugin
Watch
6
0
Fork
You've already forked swamp-codex-plugin
 0
Code Pull requests Activity Actions
Swamp CLI plugin for codex/ChatGPT — skills, commands, and bootstrap tooling for driving swamp from natural language. Connects to a central swamp serve instance or runs locally
1 commit 1 branch 0 tags 276 KiB
  • Shell 100%
Find a file
Exact
Repository files (latest commit first)
Filename Latest commit message Latest commit date
stack72 119f4b0069
 Initial Codex plugin for swamp 
Port of the Claude Code swamp plugin to the OpenAI Codex plugin format.
Skills copied verbatim, slash commands converted to skills, manifests
rewritten for the Codex plugin system.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-08-05 00:31:51 +01:00
.agents/plugins Initial Codex plugin for swamp 2026-08-05 00:31:51 +01:00
.codex-plugin Initial Codex plugin for swamp 2026-08-05 00:31:51 +01:00
skills Initial Codex plugin for swamp 2026-08-05 00:31:51 +01:00
CONTRIBUTING.md Initial Codex plugin for swamp 2026-08-05 00:31:51 +01:00
LICENSE Initial Codex plugin for swamp 2026-08-05 00:31:51 +01:00
README.md Initial Codex plugin for swamp 2026-08-05 00:31:51 +01:00

README.md

Swamp Plugin for Codex

Swamp CLI skills for OpenAI Codex — create and run models, build workflows, manage vaults and data, develop extensions, and connect to swamp serve instances.

Install

Add the swamp-club marketplace, then install the plugin:

codex plugin marketplace add https://git.swamp-club.com/swamp-club/swamp-codex-plugin.git
codex plugin add swamp@swamp-club

Skills

All skills are invoked with $skill-name or triggered automatically when your prompt matches the skill's description.

Skill Description
$swamp Main skill — models, workflows, data, vaults, extensions, repos, reports, issues, troubleshooting
$swamp-getting-started Interactive walkthrough for new swamp users
$swamp-setup Install the swamp binary (idempotent)
$swamp-login Authenticate with swamp-club for the extension registry
$swamp-central-login Authenticate with a swamp serve instance
$swamp-init Initialize the current directory as a swamp repository
$swamp-update Update swamp to the latest version

Connecting to a Server

If you use a central swamp serve instance, set the SWAMP_SERVE_URL environment variable so all commands route through the server automatically:

export SWAMP_SERVE_URL="wss://swamp.example.com"

Add this to your shell profile (~/.zshrc, ~/.bashrc) or .envrc for persistence.

To authenticate with the server, run $swamp-central-login.

License

Apache-2.0 — see LICENSE.