ππΌββοΈ The blackboard for coding agents - agentic development environment for claude code, codex, cursor, opencode, grok and more.
Rust adeai-agentsclaudeclaude-codecodexcursorgeminigrokopencodespec-driven-developmentvibe-codingvim
feat: add codex plugin for marketplace distribution
fynnfluegge3caeba75b770
diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.jsonnew file mode 100644index 0000000..9f09388--- /dev/null+++ b/.codex-plugin/plugin.json@@ -0,0 +1,26 @@+{+ "name": "agtx",+ "version": "0.1.0",+ "description": "Manage and decompose work into feature-level tasks on the agtx kanban board",+ "author": {+ "name": "fynnfluegge",+ "url": "https://github.com/fynnfluegge/agtx"+ },+ "homepage": "https://github.com/fynnfluegge/agtx",+ "repository": "https://github.com/fynnfluegge/agtx",+ "license": "MIT",+ "keywords": ["kanban", "agents", "worktrees", "tasks", "orchestration"],+ "skills": "./skills/",+ "mcpServers": "./.mcp.json",+ "interface": {+ "displayName": "agtx",+ "shortDescription": "Terminal kanban for coding agents",+ "longDescription": "agtx is a terminal kanban board for managing parallel coding agent sessions. Each task gets its own git worktree, branch, tmux window, and agent session β producing one reviewable PR per task.",+ "developerName": "fynnfluegge",+ "category": "Productivity",+ "defaultPrompt": [+ "Use @agtx:brainstorm to explore a feature idea",+ "Use @agtx:sweep to push this conversation to the agtx board as tasks"+ ]+ }+}diff --git a/.mcp.json b/.mcp.jsonnew file mode 100644index 0000000..dac57dd--- /dev/null+++ b/.mcp.json@@ -0,0 +1,7 @@+{+ "agtx": {+ "type": "stdio",+ "command": "agtx",+ "args": ["mcp-serve"]+ }+}diff --git a/AGENTS.md b/AGENTS.mdindex ea29f3f..5657728 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -46,7 +46,7 @@ See [CLAUDE.md](CLAUDE.md) for the full architecture reference including commonIf you want to sweep this conversation into agtx tasks, use the sweep skill:```-@skills/agtx/sweep/SKILL.md+@skills/sweep/SKILL.md```Follow the Sweep workflow in that file.diff --git a/CLAUDE.md b/CLAUDE.mdindex f9124ab..f2a3058 100644--- a/CLAUDE.md+++ b/CLAUDE.md@@ -53,12 +53,18 @@ src/βββ config/βββ mod.rs # GlobalConfig, ProjectConfig, ThemeConfig, WorkflowPlugin-skills/ # Built-in skill files (embedded at compile time)-βββ plan.md # Planning phase instructions-βββ execute.md # Execution phase instructions-βββ review.md # Review phase instructions-βββ research.md # Research phase instructions-βββ agtx/sweep/SKILL.md # Sweep skill β push any conversation to the agtx board (/agtx:sweep)+skills/ # Plugin skill files β auto-discovered as /agtx:* (Claude) or @agtx:* (Codex)+βββ sweep/SKILL.md # Sweep skill β push any conversation to the board (/agtx:sweep)+βββ brainstorm/SKILL.md # Brainstorm skill β free-form exploration (/agtx:brainstorm)++.claude-plugin/ # Claude Code plugin manifest+βββ plugin.json # Plugin metadata + MCP server registration+βββ marketplace.json # Makes repo discoverable via /plugin marketplace add++.codex-plugin/ # Codex plugin manifest+βββ plugin.json # Plugin metadata (skills + MCP via .mcp.json)++.mcp.json # Shared MCP server config (used by Codex plugin)plugins/ # Bundled plugin configs (embedded at compile time)βββ agtx/diff --git a/README.md b/README.mdindex f4e5d60..a4217a8 100644--- a/README.md+++ b/README.md@@ -497,30 +497,51 @@ The orchestrator communicates with agtx through the [Model Context Protocol (MCP6. Escalated tasks show a `β ` badge on the kanban board; opening the task popup shows the reason and dismisses the flag7. MCP registration is cleaned up when the orchestrator is stopped-## Sweep β Push Any Conversation to the Board+## Brainstorm & Sweep-Running a brainstorm or research session in any coding agent? Sweep the conversation into agtx tasks with a single command β `/agtx:sweep`.+Two companion skills for capturing ideas and turning them into tasks.-The agent extracts every actionable work item from the conversation, presents a proposed task list for your confirmation, and pushes confirmed tasks directly to the agtx board.+| Skill | Command | When to use |+|-------|---------|-------------|+| **Brainstorm** | `/agtx:brainstorm` | Explore a feature idea β discussion only, no planning or implementation |+| **Sweep** | `/agtx:sweep` | Push conversation outcomes to the agtx board as tasks |++**Typical flow:**+```+/agtx:brainstorm β explore the idea freely+ β+/agtx:sweep β extract tasks, confirm, push to board+ β+agtx board β tasks appear in Backlog, ready to plan+```++The brainstorm skill keeps the agent in discussion mode β asking questions, surfacing trade-offs, no code or plans. When the conversation feels complete, run `/agtx:sweep` to decompose outcomes into feature-level tasks and push them to the board with a single confirmation step.### Install<details><summary><b>Claude Code (recommended)</b></summary>-**Marketplace install:**+**Install via plugin marketplace** (two steps β adds the marketplace, then installs):```-/plugin install fynnfluegge/agtx+/plugin marketplace add fynnfluegge/agtx+/plugin install agtx@agtx-marketplace```-**Manual install:**+This registers the MCP server automatically. Then in any Claude Code session:+```+/agtx:sweep+```++**Manual install** (if you prefer):```bashclaude mcp add agtx -- agtx mcp-serve```-Then in any Claude Code session:-```-/agtx:sweep+Then copy the skill to Claude's command discovery path:+```bash+mkdir -p ~/.claude/commands/agtx+cp skills/sweep/SKILL.md ~/.claude/commands/agtx/sweep.md```</details>@@ -530,7 +551,7 @@ Then in any Claude Code session:Add the skill to your `GEMINI.md` for persistent context:```bash-echo "@~/skills/agtx/sweep/SKILL.md" >> ~/GEMINI.md+echo "@~/skills/sweep/SKILL.md" >> ~/GEMINI.md```Register the global MCP server in your Gemini config:@@ -550,7 +571,7 @@ Then in any Gemini session:Copy the skill into your Cursor rules:```bash-cp skills/agtx/sweep/SKILL.md ~/.cursor/rules/agtx-sweep.md+cp skills/sweep/SKILL.md ~/.cursor/rules/agtx-sweep.md```Register the MCP server in Cursor's MCP settings (`~/.cursor/mcp.json`):@@ -570,27 +591,31 @@ Register the MCP server in Cursor's MCP settings (`~/.cursor/mcp.json`):<details><summary><b>Codex</b></summary>-Copy the skill to Codex's skill discovery path:-```bash-mkdir -p .codex/skills/agtx-sweep-cp skills/agtx/sweep/SKILL.md .codex/skills/agtx-sweep/SKILL.md-```--Register the MCP server in `.codex/config.json`:+**Install via repo marketplace** β add to your project's `.agents/plugins/marketplace.json`:```json{- "mcp": {- "agtx": {- "command": "agtx",- "args": ["mcp-serve"]+ "name": "local-repo",+ "plugins": [+ {+ "name": "agtx",+ "source": {+ "source": "local",+ "path": "./plugins/agtx"+ },+ "policy": {+ "installation": "AVAILABLE",+ "authentication": "ON_INSTALL"+ },+ "category": "Productivity"}- }+ ]}```Then in any Codex session:```-$agtx-sweep+@agtx:sweep+@agtx:brainstorm```</details>@@ -598,7 +623,7 @@ $agtx-sweep<details><summary><b>Other agents</b></summary>-Skills are plain Markdown β they work with any agent that accepts instruction files. Copy `skills/agtx/sweep/SKILL.md` into your agent's context and register the MCP server:+Skills are plain Markdown β they work with any agent that accepts instruction files. Copy `skills/sweep/SKILL.md` into your agent's context and register the MCP server:```bashagtx mcp-serve # global mode β works from any directorydiff --git a/skills/brainstorm/SKILL.md b/skills/brainstorm/SKILL.mdnew file mode 100644index 0000000..4d95340--- /dev/null+++ b/skills/brainstorm/SKILL.md@@ -0,0 +1,50 @@+---+name: agtx-brainstorm+description: "Enter brainstorm mode to explore a feature or enhancement idea. Stays in discussion mode only β no planning, no implementation. Use /agtx:sweep when ready to push outcomes to the board."+disable-model-invocation: true+---++# Brainstorm Mode++You are in **brainstorm mode**. Your role is to help the user think through an idea β a potential feature, enhancement, refactor, or direction.++**You must not plan or implement anything.** No task lists, no step-by-step approaches, no code. This session is purely exploratory. Planning and implementation are handled separately via the agtx board.++## Your Role++- Ask questions that surface what the user actually wants+- Explore trade-offs, edge cases, and unknowns+- Challenge assumptions gently+- Help the user articulate the problem clearly before any solution is considered+- Keep the conversation focused but open-ended++## Good Questions to Ask++- What problem does this solve? Who experiences it?+- What does success look like?+- What's the simplest version of this that would be useful?+- What are you uncertain about?+- Are there existing patterns in the codebase this should follow (or avoid)?+- What could go wrong?+- Is there anything you've already ruled out, and why?++## What to Avoid++- Proposing concrete implementation steps+- Suggesting specific code, libraries, or architecture decisions+- Breaking work into tasks or subtasks+- Saying things like "here's how we could implement this..."+- Moving into execution mode prematurely++## When the Conversation Feels Complete++When the idea is well-explored and the user seems ready to move forward, prompt them:++> The brainstorm looks solid. Run `/agtx:sweep` to extract the actionable outcomes and push them to the agtx board as tasks.++If the user isn't sure whether they're done, ask:+> Is there anything still fuzzy or unresolved, or does this feel ready to hand off?++---++**Start now:** Ask the user what they'd like to explore.diff --git a/skills/agtx/sweep/SKILL.md b/skills/sweep/SKILL.mdsimilarity index 99%rename from skills/agtx/sweep/SKILL.mdrename to skills/sweep/SKILL.mdindex 74af856..31f24c6 100644--- a/skills/agtx/sweep/SKILL.md+++ b/skills/sweep/SKILL.md@@ -1,6 +1,7 @@----name: sweep+name: agtx-sweepdescription: "Sweep this conversation into agtx tasks and push them to the kanban board. Use when the user wants to capture, decompose, or hand off conversation results to the agtx board."+disable-model-invocation: true---# agtx β Terminal Kanban for Coding Agents