aiwff
AIWFF Claude Plugin Fleet-aware worker dispatch helpers for Claude Code.
Open source Open in the app JSON README (API)
About
AIWFF Claude Plugin Fleet-aware worker dispatch helpers for Claude Code.
Details
- Kind
- Plugins
- Topic
- No topic detected
- Publisher
- zaxardery8011-design
- Origin
- marketplace
- Category
- ferramentas
- Last push
- 2026-05-11T01:59:02Z
- Repository state
- arquivado
- License
- MIT
- Added
- 2026-08-30 01:48:58
- Updated
- 2026-08-30 01:48:58
- Origin id
zaxardery8011-design/aiwff-claude-plugin/aiwff
README
# AIWFF Claude Plugin **Fleet-aware worker dispatch helpers for Claude Code.** This plugin adds a small set of slash commands that let you list, create, and manage AIWFF worker sessions from inside any Claude Code project. It is a thin convenience layer — the AIWFF runtime itself must already be installed on the host machine. --- ## Requirements - [Claude Code](https://code.claude.com) CLI (any version that supports `/plugin` and `--plugin-url`) - Windows host with PowerShell 7+ - AIWFF runtime installed locally, with the `AIWF_ROOT` environment variable pointing at the install directory and `brain\scripts\aiwf.psm1` importable --- ## Install ### Option 1 — One-line install from URL (Claude Code Opus 4.7+) Run Claude Code with the plugin pulled from a released ZIP: ```bash claude --plugin-url https://github.com/zaxardery8011-design/aiwff-claude-plugin/releases/latest/download/aiwff-claude-plugin.zip ``` To make the install persistent rather than per-session, add the plugin via the in-app `/plugin install` command after pointing it at the same URL. ### Option 2 — Local development ```bash git clone https://github.com/zaxardery8011-design/aiwff-claude-plugin.git claude --plugin-dir ./aiwff-claude-plugin ``` After installation, run `/reload-plugins` inside Claude Code if you've made local edits. > **TODO: verify against Anthropic plugin spec.** The `--plugin-url` flag accepts ZIP archives in Opus 4.7. The exact URL convention (release asset vs. raw ref) may change; check the [Anthropic plugins docs](https://code.claude.com/docs/en/plugins) for the current form. --- ## Slash commands All commands are namespaced under `/aiwff:` to avoid collisions with other plugins. | Command | Purpose | | :----------------------------------- | :------------------------------------------------------------------------------- | | `/aiwff:tasks [status]` | List tasks. Optional status filter (`todo`, `running`, `done`, `failed`). | | `/aiwff:task <id>` | Show details for one task. | | `/aiwff:workers [refresh]` | List active workers. Pass `refresh` to prune dead entries first. | | `/aiwff:new-task <title> \| <instruction> [\| <workingDir>]` | Queue a new task without spawning a worker. | | `/aiwff:start-worker <task-id>` | Spawn a worker for an existing task. | | `/aiwff:stop-worker <id> [hard\|soft]` | Stop one worker. Default is `soft`. | | `/aiwff:stop-all` | Stop every active worker. Destructive — confirm first. | | `/aiwff:worker-status <id>` | Snapshot a worker's recent progress. | Each command is implemented as a model-invoked skill that wraps a single PowerShell cmdlet. The plugin does not bundle the cmdlets themselves — they come from your local AIWFF install. --- ## Examples ```text > /aiwff:tasks running > /aiwff:new-task tidy-readme | Polish the README and remove stale links | C:\projects\myrepo > /aiwff:start-worker t-7a2b > /aiwff:worker-status w-12 > /aiwff:stop-worker w-12 hard ``` --- ## Troubleshooting - **`Import-Module: cannot find aiwf.psm1`** — verify `$env:AIWF_ROOT` is set in the shell Claude Code spawns, and that `brain\scripts\aiwf.psm1` exists under it. - **`/aiwff:*` commands not showing up** — run `/reload-plugins`, or check `/plugin list` to confirm the plugin loaded. - **Skills appear but the cmdlet errors** — open a regular PowerShell session, run `Import-Module $env:AIWF_ROOT\brain\scripts\aiwf.psm1 -Force` and confirm the bare cmdlets work outside Claude Code first. --- ## License MIT — see [LICENSE](./LICENSE). --- ## Contributing Issues and pull requests welcome at the repository linked in `plugin.json`. The plugin intentionally keeps the surface small; if you need cmdlets that aren't exposed here, they likely belong in the AIWFF runtime rather than this shim.