Skip to content

armgit / agtx

Public Imported from GitHub
0

πŸ„πŸΌβ€β™‚οΈ The blackboard for coding agents - agentic development environment for claude code, codex, cursor, opencode, grok and more.

feat: add codex plugin for marketplace distribution

fynnfluegge3caeba75b770
diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.json
new file mode 100644
index 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.json
new file mode 100644
index 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.md
index ea29f3f..5657728 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -46,7 +46,7 @@ See [CLAUDE.md](CLAUDE.md) for the full architecture reference including common
If 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.md
index 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.md
index f4e5d60..a4217a8 100644
--- a/README.md
+++ b/README.md
@@ -497,30 +497,51 @@ The orchestrator communicates with agtx through the [Model Context Protocol (MCP
6. Escalated tasks show a `⚠` badge on the kanban board; opening the task popup shows the reason and dismisses the flag
7. 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):
```bash
claude 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:
```bash
agtx mcp-serve # global mode β€” works from any directory
diff --git a/skills/brainstorm/SKILL.md b/skills/brainstorm/SKILL.md
new file mode 100644
index 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.md
similarity index 99%
rename from skills/agtx/sweep/SKILL.md
rename to skills/sweep/SKILL.md
index 74af856..31f24c6 100644
--- a/skills/agtx/sweep/SKILL.md
+++ b/skills/sweep/SKILL.md
@@ -1,6 +1,7 @@
---
-name: sweep
+name: agtx-sweep
description: "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