TaskForge for OpenCode

Adaptive development workflow with quality gates, multi-agent execution, and real-time progress tracking.

Standalone — no Claude Code required.

Installation

npx @task-forge/opencode

That's it. Installs to ~/.config/opencode/.

Options

npx @task-forge/opencode --opencode          # OpenCode (default)
npx @task-forge/opencode --claude            # Claude Code (~/.claude/)
npx @task-forge/opencode --local             # Current project directory
npx @task-forge/opencode --config-dir <dir>  # Custom directory
npx @task-forge/opencode --uninstall         # Remove installed files

Usage

/tf add user authentication              # full design, single-agent
/tf --light fix the login button         # light design, quick fix
/tf --parallel refactor the API layer    # full design, multi-agent
/tf --architect redesign the pipeline    # full design + architect
/tf --prd Q3 feature roadmap            # PRD mode

Or start OpenCode with the TaskForge agent:

opencode --agent task-forge

What Gets Installed

~/.config/opencode/
├── task-forge/                        # Core workflow files
│   ├── phases/                        # init, planning, validation, bootstrap, prd
│   ├── manifest-schema.json           # Manifest schema v2
│   ├── policy.json                    # Quality profiles, gates, limits
│   ├── gates.md                       # Gate catalog
│   ├── artifact-contract.md           # Required artifacts
│   ├── hardening-checks.md            # Hardening check registry
│   └── VERSION                        # Installed version
├── agents/
│   ├── core/                          # Subagent definitions
│   │   ├── architect.md
│   │   ├── bootstrap.md
│   │   ├── compliance-agent.md
│   │   ├── implementation-agent.md
│   │   ├── reviewer.md
│   │   └── researcher.md
│   └── task-forge.md                  # Orchestrator agent
├── commands/
│   ├── tf.md                          # /tf slash command
│   └── task-forge.md                  # /task-forge alias
└── task-forge-manifest.json           # Install manifest (for upgrades)

Upgrading

Run the install command again. It detects the existing install and overwrites:

npx @task-forge/opencode

Uninstalling

npx @task-forge/opencode --uninstall