Task Tool
A tree task tool with stable T1, T1.1 ids that survive long turns and compaction.
Quick Answer & Overview
Task Tool is an open-source (MIT) OpenCode V2 plugin by @JadMadi. It resolves: Multi-step work loses its structure in long sessions, and ad hoc lists renumber or disappear when the context compacts.. Installed via opencode plugin add github:jadmadi/opencode-task-tool, it operates locally with 0% telemetry.
opencode plugin add github:jadmadi/opencode-task-tool Local manual setup:
Copy task-tool.ts into ~/.config/opencode/plugins/ and restart the TUI.
The Problem It Solves
Multi-step work loses its structure in long sessions, and ad hoc lists renumber or disappear when the context compacts.
Registered Agent Tools
This plugin registers custom tools that OpenCode agents can invoke autonomously during execution:
task Design Guardrails & Limitations
State is per session and ids never renumber.
Technical Specifications
- Target Host
- OpenCode V2 (CLI & TUI)
- Tested Runtime
- OpenCode
v2.0.16(builtUnder-2.0.16) - Artifact File
task-tool.ts- Version Scheme
- CalVer (YYYY.MM.MICRO) · Current:
v2026.9.0 - Default Install Path
~/.config/opencode/plugins/task-tool.ts- License
- MIT (Open Source)
- Last Updated
- 2026-09-25
Frequently Asked Questions
What problem does Task Tool solve?
Multi-step work loses its structure in long sessions, and ad hoc lists renumber or disappear when the context compacts.
How do I install Task Tool in OpenCode V2?
Run the terminal command: `opencode plugin add github:jadmadi/opencode-task-tool`. The runtime clones the repository into `~/.config/opencode/plugins/task-tool.ts` and activates it in your next session. Alternatively: Copy task-tool.ts into ~/.config/opencode/plugins/ and restart the TUI.
What are the guardrails and limitations for Task Tool?
State is per session and ids never renumber.
What autonomous agent tools are registered by Task Tool?
This plugin provides the following autonomous tools for OpenCode agents: task.