AsyncWF

Model-Driven Parallel Agent Workflow CLI

AsyncWF empowers AI coding assistants (Claude Code, Codex, Gemini) with asynchronous multitasking capabilities. Instead of wrapping the LLM in a rigid control loop, AsyncWF injects a "Parallel Workflow Protocol" directly into the model's context.

Features

- 🤖 Multi-Agent Support - Claude, Codex, Gemini working together
- 🚀 Parallel Task Dispatch - Spawn multiple sub-agents concurrently
- 📚 Skills System - Global reusable action templates
- 🧠 Knowledge Base - Model-driven learning and context persistence

Installation

``bash
npm install -g asyncwf
`

Quick Start

`bash

Initialize for Claude (default)

asyncwf init

Initialize for multiple agents

asyncwf init -c -g -x # Claude + Gemini + Codex

Multi-agent parallel workflow

asyncwf taskmgr dispatch --job frontend --agent gemini --prompt "Create React UI..."
asyncwf taskmgr dispatch --job backend --agent claude --prompt "Build REST API..."
asyncwf taskmgr dispatch --job fullstack --agent codex --prompt "Integrate..."

Wait and fetch

asyncwf taskmgr wait --jobs frontend,backend,fullstack
asyncwf taskmgr fetch --job frontend
`

Commands

$3

| Flag | Description |
|------|-------------|
| -c, --claude | Configure for Claude Code (default) |
| -g, --gemini | Configure for Gemini CLI |
| -x, --codex | Configure for OpenAI Codex |

$3

| Command | Description |
|---------|-------------|
| dispatch --job --agent --prompt "" | Spawn sub-agent |
| list [--status ] | List tasks |
| wait --jobs | Wait for completion |
| fetch --job | Get output |
| kill --job | Terminate |

Agent types: claude, codex, gemini

$3

`bash
asyncwf skill list # List skills
asyncwf skill add --content "..." # Add skill
asyncwf kb learn --topic --content "..." # Learn
asyncwf kb search # Search
`

Multi-Agent Workflow Example

`
User: "Build a login system with React frontend and Rust backend"

Claude (Controller):
1. asyncwf taskmgr dispatch --job ui --agent gemini --prompt "React login form..."
2. asyncwf taskmgr dispatch --job api --agent claude --prompt "Rust Actix handler..."
3. asyncwf taskmgr wait --jobs ui,api
4. asyncwf taskmgr fetch --job ui
5. asyncwf taskmgr fetch --job api
`

Directory Structure

`
~/.ckb/ # Global KB (skills, knowledge, projects)
.asyncwf/ # Local state (config, tasks, logs)
claude.md # Claude protocol
GEMINI.md # Gemini protocol (if -g)
AGENTS.md # Codex protocol (if -x)
``

License

MIT