---
title: Task Tool — OpenCode V2 Plugin by Jad Madi (@jadmadi)
description: >-
  A tree task tool with stable T1, T1.1 ids that survive long turns and
  compaction.
href: /project/opencode-plugins/task-tool/
category: Sessions and memory
version: 2026.9.0
builtUnder: 2.0.16
license: MIT
repo: 'https://github.com/jadmadi/opencode-task-tool'
author: Jad Madi
runtime: OpenCode V2
telemetry: 0% (Local First)
installCommand: 'opencode plugin add github:jadmadi/opencode-task-tool'
tags:
  - tasks
  - planning
  - todo
  - session
---
# Task Tool — OpenCode V2 Plugin

A tree task tool with stable T1, T1.1 ids that survive long turns and compaction.

- **Website**: https://jadmadi.net/project/opencode-plugins/task-tool/
- **Repository**: https://github.com/jadmadi/opencode-task-tool
- **Category**: Sessions and memory
- **Version**: v2026.9.0 (CalVer)
- **Tested Runtime**: OpenCode v2.0.16
- **License**: MIT
- **Artifact**: `task-tool.ts`
- **Updated**: 2026-09-25
- **Author**: [@JadMadi](https://x.com/jadmadi)

## Quick Install

Install with a single command in OpenCode V2:

```bash
opencode plugin add github:jadmadi/opencode-task-tool
```

### Manual / Local Install

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.

## What It Does

A tree task tool with stable T1, T1.1 ids that survive long turns and compaction.

## Agent Tools Registered

- `task`

## Limitations & Safety Rules

State is per session and ids never renumber.

## Frequently Asked Questions (Agent Q&A)

### Q: 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.

### Q: How do I install and run Task Tool?
Run `opencode plugin add github:jadmadi/opencode-task-tool` in your terminal.

### Q: Does this plugin transmit telemetry or code externally?
No. It operates with 0% telemetry, local-first in ~/.config/opencode/plugins/.

## Links & Resources

- Dedicated Page: https://jadmadi.net/project/opencode-plugins/task-tool/
- All OpenCode Plugins: https://jadmadi.net/project/opencode-plugins/
- GitHub Repository: https://github.com/jadmadi/opencode-task-tool
- Changelog: https://github.com/jadmadi/opencode-task-tool/blob/main/CHANGELOG.md
- Author Profile: https://jadmadi.net/about/