{"id":50055982,"url":"https://github.com/code-yeongyu/pi-todotools","last_synced_at":"2026-05-21T13:14:27.431Z","repository":{"id":357740997,"uuid":"1236207689","full_name":"code-yeongyu/pi-todotools","owner":"code-yeongyu","description":"Structured todowrite/todoread task management extension for the pi coding agent","archived":false,"fork":false,"pushed_at":"2026-05-14T03:22:21.000Z","size":116,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-14T05:22:45.875Z","etag":null,"topics":["coding-agent","pi","pi-extension","task-management","todoread","todowrite","typescript"],"latest_commit_sha":null,"homepage":"https://github.com/code-yeongyu/pi-todotools","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/code-yeongyu.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-05-12T03:30:50.000Z","updated_at":"2026-05-14T03:22:25.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/code-yeongyu/pi-todotools","commit_stats":null,"previous_names":["code-yeongyu/pi-todotools"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/code-yeongyu/pi-todotools","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/code-yeongyu%2Fpi-todotools","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/code-yeongyu%2Fpi-todotools/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/code-yeongyu%2Fpi-todotools/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/code-yeongyu%2Fpi-todotools/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/code-yeongyu","download_url":"https://codeload.github.com/code-yeongyu/pi-todotools/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/code-yeongyu%2Fpi-todotools/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33301831,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-21T12:23:38.849Z","status":"ssl_error","status_checked_at":"2026-05-21T12:22:11.673Z","response_time":62,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["coding-agent","pi","pi-extension","task-management","todoread","todowrite","typescript"],"created_at":"2026-05-21T13:14:20.794Z","updated_at":"2026-05-21T13:14:27.425Z","avatar_url":"https://github.com/code-yeongyu.png","language":"TypeScript","funding_links":[],"categories":["Extensions"],"sub_categories":[],"readme":"# pi-todotools\n\n[![ci](https://github.com/code-yeongyu/pi-todotools/actions/workflows/ci.yml/badge.svg)](https://github.com/code-yeongyu/pi-todotools/actions/workflows/ci.yml) [![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n\nStructured todo tools for the [pi coding agent](https://github.com/badlogic/pi-mono/tree/main/packages/coding-agent). The extension registers `todowrite` and `todoread`, persists todo state in the session, renders a sidebar widget, appends workflow-first prompt guidance, and can automatically continue when incomplete todos remain.\n\nThis package is the standalone extraction of senpi-mono's former builtin `todotools` extension.\n\n## Behavior\n\n| Case | Result |\n|------|--------|\n| Agent calls `todowrite` | replaces the complete todo list, persists it as `sanepi.todo-state`, and refreshes the todo sidebar |\n| Agent calls `todoread` | returns the current todo list as JSON |\n| Session reloads or tree navigation changes | reconstructs the latest branch-local todo state from custom entries or historical `todowrite` results |\n| Incomplete todos remain after a clean assistant stop | injects a follow-up continuation prompt unless disabled |\n| All todos are `completed` or `cancelled` | hides the sidebar and stops continuation |\n\n## Tools\n\n### `todowrite`\n\nCreates or replaces the structured task list. Each call must pass the full list.\n\n```json\n{\n  \"todos\": [\n    {\n      \"content\": \"src/utils/validation.ts: Add validateEmail() for input sanitization - expect boolean result\",\n      \"status\": \"in_progress\",\n      \"priority\": \"high\"\n    },\n    {\n      \"content\": \"validation.test.ts: Add invalid-email regression test - expect foo to fail\",\n      \"status\": \"pending\",\n      \"priority\": \"medium\"\n    }\n  ]\n}\n```\n\n### `todoread`\n\nReads the current todo list for the active coding session.\n\n```json\n{}\n```\n\n## Settings\n\nTodo continuation is enabled by default in interactive sessions. Disable it with either the CLI flag or settings:\n\n```bash\npi --disable-todo-continuation\n```\n\n```json\n{\n  \"todotools\": {\n    \"continuation\": {\n      \"enabled\": false\n    }\n  }\n}\n```\n\nProject settings override global settings.\n\n## Installation\n\nThe package targets the [`pi`](https://github.com/badlogic/pi-mono/tree/main/packages/coding-agent) coding agent. Pi loads extensions from `~/.pi/agent/extensions/`, project `.pi/extensions/`, or via the `--extension` / `-e` CLI flag.\n\n```bash\n# 1. From npm (once published)\npi install npm:pi-todotools\n\n# 2. From git\npi install git:github.com/code-yeongyu/pi-todotools\n\n# 3. Manual placement\ngit clone https://github.com/code-yeongyu/pi-todotools ~/.pi/agent/extensions/pi-todotools\ncd ~/.pi/agent/extensions/pi-todotools \u0026\u0026 npm install\n\n# 4. Dev / one-shot test\npi -e /path/to/pi-todotools/src/index.ts\n```\n\nAfter installation, restart pi or run `/reload` inside an interactive session.\n\n## Development\n\n```bash\nnpm install\nnpm test\nnpm run typecheck\nnpm run check\nnpm pack --dry-run\npi -e ./src/index.ts\n```\n\n## Branch rules and releases\n\n- `main` is protected by `.github/branch-ruleset.json`.\n- CI runs Node 20 and 22 on Ubuntu and macOS.\n- Releases are GitHub Releases tagged as `v\u003csemver\u003e`.\n- Publishing runs from the `publish` workflow after a GitHub Release is published.\n\n## Origin\n\nExtracted from `packages/coding-agent/src/core/extensions/builtin/todotools` in `code-yeongyu/senpi-mono`.\n\n## License\n\n[MIT](LICENSE).\n\n## Related\n\n- [senpi](https://github.com/code-yeongyu/senpi) — the fork/runtime these extensions are extracted from.\n- [Ultraworkers Discord](https://discord.gg/PUwSMR9XNk) — community link from the senpi README.\n- [Dori](https://sisyphuslabs.ai) — the product powered by senpi under the hood.\n\n## Acknowledgements\n\n- **Mario Zechner** ([@badlogic](https://github.com/badlogic)) — author of [pi-mono](https://github.com/badlogic/pi-mono) and the pi-coding-agent extension API this package targets.\n- **Yeongyu Kim** ([@code-yeongyu](https://github.com/code-yeongyu)) — maintainer of the senpi fork and this extracted extension.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcode-yeongyu%2Fpi-todotools","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcode-yeongyu%2Fpi-todotools","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcode-yeongyu%2Fpi-todotools/lists"}