todo

v0.4.0

Durable repository context an agent reads: tasks in todo.txt and decisions in docs/adr. Three skills — see what is ready and record every state change as it happens (todo), record and check architecture decisions (adr), install or inspect either in a repository (doctor). Two bundled CLIs, bin/todo and bin/adr. Successor to `harness`; absorbed the separate `adr` plugin. ADR format and bar vendored from mattpocock/skills (MIT).

CodexClaude Code3 Skills

By gigun0 GitHub starsUpdated 1 hour ago

Directory evidence

Runtimes: Codex and Claude Code
Parsed components: 3 skill or MCP entries
Source updated: Sep 25, 2026
Manifest status: Canonical path parsed

The directory validates manifest shape and source location. It does not execute the plugin or provide a security endorsement. Review the indexing methodology →

Install todo for Codex and Claude Code

Installs for the current user

codex plugin marketplace add gigun-dev/claude-code
codex plugin marketplace upgrade gigun
codex plugin add todo@gigun

Paste and run these commands in a terminal with Codex. They add and refresh the gigun catalog, then install this plugin.

Compatibility: the page URL and API slug “todo” remain stable.

Codex: todo@agent-plugin-marketplace → todo@gigun

The installer fetches third-party code from the source repository shown on this page. This directory validates manifest structure and source location, but does not perform a security audit; review the manifest, components, and source before installing.

Get the source manually

$ git clone https://github.com/gigun-dev/claude-code

Clone the source repository, then follow its setup instructions to add the plugin to a compatible client. The plugin root is plugins/todo/.

Plugin files

plugins/todo/

├── .codex-plugin/plugin.json
├── .claude-plugin/plugin.json
├── skills/adr/SKILL.md
├── skills/doctor/SKILL.md
└── skills/todo/SKILL.md

Included Skills3

adrskills/adr/SKILL.md

Read this repository's recorded decisions before touching an area that may already be decided, and record new hard-to-reverse ones. Use it at the start of work in a repository, before proposing or implementing a change to a protocol, a default, a build flag, a file format or a layout, when someone asks why it is done this way, when a measurement refutes an approach, and when the user settles a trade-off. Fire even when nobody says "ADR" or "decision".

doctorskills/doctor/SKILL.md

Use when asked to set up or check how a repository keeps tasks and decisions, or when todo.txt or docs/adr is missing, the agent instructions (CLAUDE.md / AGENTS.md) do not point at either, or `todo check` / `adr check` report violations that need explaining. Diagnoses by default; installs the files and instruction pointers when requested.

todoskills/todo/SKILL.md

Manage repository tasks in todo.txt: read ready work at the start of work in a repository, and update tasks whenever one starts, finishes, splits, or changes — including when the user never says "todo". Tasks live in this repository's todo.txt and done.txt, driven by the `todo` CLI. Also on '/todo:todo'.

Plugin manifests2

plugins/todo/.codex-plugin/plugin.json

{
  "$generatedFrom": "../.claude-plugin/plugin.json (scripts/generate_manifests.py --write); generates name/version/description/author here — homepage, repository, keywords, the mcpServers/skills pointer, and interface stay hand-edited in this file",
  "name": "todo",
  "version": "0.4.0",
  "description": "Durable repository context an agent reads: tasks in todo.txt and decisions in docs/adr. Three skills — see what is ready and record every state change as it happens (todo), record and check architecture decisions (adr), install or inspect either in a repository (doctor). Two bundled CLIs, bin/todo and bin/adr. Successor to `harness`; absorbed the separate `adr` plugin. ADR format and bar vendored from mattpocock/skills (MIT).",
  "author": {
    "name": "gigun",
    "url": "https://github.com/gigun-dev"
  },
  "homepage": "https://github.com/gigun-dev/claude-code/tree/main/plugins/todo",
  "repository": "https://github.com/gigun-dev/claude-code",
  "keywords": [
    "todo.txt",
    "tasks",
    "workflow",
    "adr",
    "architecture",
    "decisions"
  ],
  "skills": "./skills/",
  "interface": {
    "displayName": "Todo & ADR",
    "shortDescription": "todo.txt task list and ADR decisions for a repository",
    "longDescription": "Keep a repository's tasks in plain todo.txt and done.txt and its architecture decisions in docs/adr as one short Markdown file each. List what is ready (dependencies resolved) with the decisions indexed above it, record starts and completions as they happen, record a new decision only when it is hard to reverse, and check both for format violations.",
    "developerName": "gigun",
    "category": "Productivity",
    "capabilities": [
      "Read",
      "Write"
    ],
    "websiteURL": "https://github.com/gigun-dev/claude-code/tree/main/plugins/todo",
    "defaultPrompt": [
      "What is ready to work on in this repository?",
      "What has already been decided in this repository?"
    ]
  }
}

plugins/todo/.claude-plugin/plugin.json

{
  "name": "todo",
  "version": "0.4.0",
  "description": "Durable repository context an agent reads: tasks in todo.txt and decisions in docs/adr. Three skills — see what is ready and record every state change as it happens (todo), record and check architecture decisions (adr), install or inspect either in a repository (doctor). Two bundled CLIs, bin/todo and bin/adr. Successor to `harness`; absorbed the separate `adr` plugin. ADR format and bar vendored from mattpocock/skills (MIT).",
  "author": {
    "name": "gigun",
    "url": "https://github.com/gigun-dev"
  }
}

For maintainers

If you maintain this plugin, link to this source-backed listing from your README so users can review its manifest and indexed components.

[todo on Agent Plugins Marketplace](https://pluginsmp.com/plugins/todo)