https://github.com/agumbe-ai/codex-plugin
Build, deploy, and operate Agumbe full-stack applications from Codex.
https://github.com/agumbe-ai/codex-plugin
ai-app-builder codex codex-plugin developer-tools mcp
Last synced: 14 days ago
JSON representation
Build, deploy, and operate Agumbe full-stack applications from Codex.
- Host: GitHub
- URL: https://github.com/agumbe-ai/codex-plugin
- Owner: agumbe-ai
- License: apache-2.0
- Created: 2026-06-15T06:47:31.000Z (30 days ago)
- Default Branch: main
- Last Pushed: 2026-06-15T08:13:41.000Z (30 days ago)
- Last Synced: 2026-06-15T08:23:30.106Z (30 days ago)
- Topics: ai-app-builder, codex, codex-plugin, developer-tools, mcp
- Homepage: https://agumbe.dev
- Size: 88.9 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Security: SECURITY.md
- Roadmap: ROADMAP.md
Awesome Lists containing this project
README
# Agumbe Codex Plugin
Build, deploy, and operate production-ready Agumbe full-stack applications from
Codex.
This repository is the public Git marketplace source for the Agumbe Codex
plugin. The plugin bundles focused workflow skills and connects Codex to the
OAuth-protected remote MCP server at `https://mcp.agumbe.dev/mcp`.
## Install
Add the Agumbe marketplace and install the plugin:
```bash
codex plugin marketplace add agumbe-ai/codex-plugin --ref main
codex plugin add agumbe@agumbe
```
Start a fresh Codex thread after installation. Codex will prompt you to
authorize Agumbe when a tool first needs access.
For a deterministic first-time setup:
```bash
codex mcp logout agumbe
codex mcp login agumbe --scopes workspaces:read,workspaces:write
codex mcp get agumbe --json
```
After authorization, exit the current Codex process and start a fresh one.
Plugin-provided MCP tools are loaded when a Codex session starts. If OAuth
fails during startup, the Agumbe skills remain visible but the Agumbe tools are
not exposed to that session.
Agumbe skills must never replace a failed Agumbe MCP operation by scaffolding a
local application.
## Try It
```text
Create a TypeScript and Next.js Agumbe workspace named support-desk for
triaging customer support tickets with assignment, SLA tracking, and
escalation. Poll provisioning until it succeeds or fails.
```
## Repository Layout
```text
.agents/plugins/marketplace.json Git marketplace catalog
plugins/agumbe/ Installable Agumbe plugin
plugins/agumbe/.mcp.json Remote MCP connection
plugins/agumbe/skills/ Agumbe workflows for Codex
```
## Validate
Use Codex's bundled plugin validator:
```bash
python3 /path/to/plugin-creator/scripts/validate_plugin.py plugins/agumbe
```
The plugin contains no Kubernetes credentials, cloud credentials, GitHub
installation tokens, session cookies, or application access tokens.
## License
Apache-2.0