{
  "markdown": "# AIWFF Claude Plugin\n\n**Fleet-aware worker dispatch helpers for Claude Code.**\n\nThis 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.\n\n---\n\n## Requirements\n\n- [Claude Code](https://code.claude.com) CLI (any version that supports `/plugin` and `--plugin-url`)\n- Windows host with PowerShell 7+\n- AIWFF runtime installed locally, with the `AIWF_ROOT` environment variable pointing at the install directory and `brain\\scripts\\aiwf.psm1` importable\n\n---\n\n## Install\n\n### Option 1 — One-line install from URL (Claude Code Opus 4.7+)\n\nRun Claude Code with the plugin pulled from a released ZIP:\n\n```bash\nclaude --plugin-url https://github.com/zaxardery8011-design/aiwff-claude-plugin/releases/latest/download/aiwff-claude-plugin.zip\n```\n\nTo 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.\n\n### Option 2 — Local development\n\n```bash\ngit clone https://github.com/zaxardery8011-design/aiwff-claude-plugin.git\nclaude --plugin-dir ./aiwff-claude-plugin\n```\n\nAfter installation, run `/reload-plugins` inside Claude Code if you've made local edits.\n\n> **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.\n\n---\n\n## Slash commands\n\nAll commands are namespaced under `/aiwff:` to avoid collisions with other plugins.\n\n| Command                              | Purpose                                                                          |\n| :----------------------------------- | :------------------------------------------------------------------------------- |\n| `/aiwff:tasks [status]`              | List tasks. Optional status filter (`todo`, `running`, `done`, `failed`).        |\n| `/aiwff:task <id>`                   | Show details for one task.                                                       |\n| `/aiwff:workers [refresh]`           | List active workers. Pass `refresh` to prune dead entries first.                 |\n| `/aiwff:new-task <title> \\| <instruction> [\\| <workingDir>]` | Queue a new task without spawning a worker.       |\n| `/aiwff:start-worker <task-id>`      | Spawn a worker for an existing task.                                             |\n| `/aiwff:stop-worker <id> [hard\\|soft]` | Stop one worker. Default is `soft`.                                            |\n| `/aiwff:stop-all`                    | Stop every active worker. Destructive — confirm first.                           |\n| `/aiwff:worker-status <id>`          | Snapshot a worker's recent progress.                                             |\n\nEach 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.\n\n---\n\n## Examples\n\n```text\n> /aiwff:tasks running\n> /aiwff:new-task tidy-readme | Polish the README and remove stale links | C:\\projects\\myrepo\n> /aiwff:start-worker t-7a2b\n> /aiwff:worker-status w-12\n> /aiwff:stop-worker w-12 hard\n```\n\n---\n\n## Troubleshooting\n\n- **`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.\n- **`/aiwff:*` commands not showing up** — run `/reload-plugins`, or check `/plugin list` to confirm the plugin loaded.\n- **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.\n\n---\n\n## License\n\nMIT — see [LICENSE](./LICENSE).\n\n---\n\n## Contributing\n\nIssues 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.\n",
  "bytes": 4188,
  "sha": "d89450e25cfe4db45d741e950d0b83e72bfd03ef1b6d7d3330bb06abd5a9437e",
  "repo_slug": "zaxardery8011-design/aiwff-claude-plugin",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_zaxardery8011_design_aiwff_claude_plugin_179a993e/readme"
}