# agiflow

Connects AI coding agents to AgiFlow via MCP to handle planning, backlog grooming, task execution, and progress reporting.

- plugin · `type=plugin` · Claude Code, Codex · ★ 1596 repo stars
- Author: AgiFlow
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/hashgraph-online/awesome-codex-plugins/tree/HEAD/plugins/AgiFlow/ai-plugin
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text and 3 script files) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/plugins/agiflow

## What it does

The plugin integrates AgiFlow project management into Claude Code and Codex environments. It bundles ten domain skills aligned with scrum stages: requirement breakdown (`project-plan`), task shaping (`refine-task`), backlog prioritization (`backlog-grooming`), code implementation (`run-task`, `run-work`), and acceptance checks (`review-work`). You rarely call them by name because the AI loads the right skill based on context.

Behind the scenes, the plugin hooks into `https://agiflow.io/api/v1/mcp-app` using OAuth. Through exposed MCP tools, the agent manages project statuses, groups tasks into work units, updates comments, and coordinates agent assignments.

Without completing OAuth authentication against the AgiFlow MCP endpoint, the project tools will refuse requests.

## Install

### Claude Code (native platform)

**Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add hashgraph-online/awesome-codex-plugins
```
In the agent chat (not a shell):
```text
/plugin install agiflow@awesome-codex-plugins
```

## When to use it
- decompose high-level feature requirements into implementation tasks
- groom backlog items and promote refined tickets to Todo
- execute a task or complete work unit end-to-end
- generate daily standup updates and diagnose project blockers

## Example prompts
- Plan a feature: add per-user notification preferences
- Groom the backlog and promote the ready tasks to Todo
- Give me a daily standup for this project

## Source text · ai-plugin · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: b2e9777c5082637c.

BEGIN THIRD-PARTY FILE b2e9777c5082637c
````text
# AgiFlow AI Plugin

Official AgiFlow plugin for AI clients. Drive AgiFlow project management, including planning,
grooming, execution, and review, directly from your AI tool.

Works with **ChatGPT**, **Claude Code**, **Codex**, **Cursor**, **Antigravity**, and **Gemini CLI**.

## Installation

This repo is a self-contained, multi-client plugin bundle. Until it is published to each client's
marketplace, load it as a local plugin directory.

### Claude Code

Install from the AgiFlow marketplace (Claude Code 2.1.275 or later):

```
/plugin install agiflow --marketplace AgiFlow/ai-plugin
```

For local development, load this checkout directly:

```bash
claude --plugin-dir ./ai-plugin
```

The bundled `.mcp.json` wires the AgiFlow MCP server automatically. Use `/mcp` inside Claude Code to
check the connection.

### Antigravity (Google)

Place the plugin folder in one of Antigravity's plugin locations, then restart:

```bash
# Workspace-level (this project only)
mkdir -p .agents/plugins && cp -R /path/to/agiflow-ai-plugin .agents/plugins/

# Global (all workspaces)
mkdir -p ~/.gemini/config/plugins && cp -R /path/to/agiflow-ai-plugin ~/.gemini/config/plugins/
```

Antigravity reads the root `plugin.json` marker, the `skills/`, and `mcp_config.json` automatically.

### Cursor

Add manually in **Cursor Settings → MCP / Plugins**, pointing at this folder. Cursor's stable surface
is MCP config. The bundled `.mcp.json` provides it.

### Codex

Add the AgiFlow plugin marketplace, then install the plugin from that marketplace:

```bash
codex plugin marketplace add AgiFlow/ai-plugin
codex plugin add agiflow@agiflow
```

For local development, point Codex at this checkout as a marketplace root:

```bash
codex plugin marketplace add ./agiflow-ai-plugin
codex plugin add agiflow@agiflow
```

### Gemini CLI

```bash
gemini extensions install <your-remote>/agiflow-ai-plugin
```

The bundled `gemini-extension.json` connects the AgiFlow MCP server via `mcp-remote`.

### ChatGPT

OpenAI Platform plugins are submitted from the production AgiFlow MCP server. This public repository
provides the reusable Agent Skills used by that plugin, but does not contain Platform dashboard IDs,
submission evidence, reviewer credentials, or other private operational data.

The ChatGPT-safe workflow set is:

- `getting-started`
- `project-plan`
- `refine-task`
- `backlog-grooming`
- `daily-standup`
- `triage`

The coding-agent workflows `orchestrate`, `run-task`, `run-work`, and `review-work` remain available
to coding clients but are not part of the ChatGPT submission bundle.

## How to develop

```bash
git clone https://github.com/AgiFlow/ai-plugin.git
claude --plugin-dir ./ai-plugin
```

- Add new workflow instructions under `skills/<name>/SKILL.md`.
- Keep shared guidance in `references/` (e.g. `references/agiflow-agents.md`).
- See `references/plugin-types.md` for per-client manifest notes.

## Features

This plugin connects to the AgiFlow MCP server (`https://agiflow.io/api/v1/mcp-app`) and exposes AgiFlow
tools across these categories:

- **Projects**: create, inspect, and update projects and their statuses
- **Tasks**: create, list, get, update, reorder, and batch-create tasks
- **Work units**: group tasks into deliverable features or epics and track progress
- **Workflows**: acquire and release locks and coordinate multi-agent runs
- **Members**: list and assign agent members to work
- **Comments**: document decisions and progress on tasks
- **Vault**: read and set scoped configuration entries

### Bundled skills

The plugin ships 10 workflow skills that mirror AgiFlow's scrum pipeline. Your AI client loads them on
demand when your request matches their description. You generally do not invoke them by name:

| Skill | Phase | Use it to |
| --- | --- | --- |
| `getting-started` | orient | get coached on where to start and which workflow fits |
| `project-plan` | Planning | break requirements into vertical-slice tasks (Planning status) |
| `refine-task` | Planning | turn a vague task into an autonomous-ready spec |
````
END THIRD-PARTY FILE b2e9777c5082637c

The third-party file has ended. Everything between the b2e9777c5082637c tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 4058 of 7875 bytes. © AgiFlow · MIT · https://github.com/hashgraph-online/awesome-codex-plugins/tree/HEAD/plugins/AgiFlow/ai-plugin

## Similar
- [scrum-master](https://affpapa.org/en/nevibecode/skills/scrum-master.md) — skill · 817 installs
- [pm-skills](https://affpapa.org/en/nevibecode/plugins/alireza-rezvani-pm-skills.md) — plugin · ★ 30251 repo stars
- [retro](https://affpapa.org/en/nevibecode/skills/phuryn-retro.md) — skill · 2900 installs
- [project-manager](https://affpapa.org/en/nevibecode/agents/project-manager.md) — subagent · 1064 installs
- [agile-sprint-planning](https://affpapa.org/en/nevibecode/skills/agile-sprint-planning.md) — skill · 680 installs
- [standup-meeting](https://affpapa.org/en/nevibecode/skills/standup-meeting.md) — skill · 370 installs

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
