https://github.com/elvatis/openclaw-todo
OpenClaw plugin: Manage TODOs in markdown files with natural language.
https://github.com/elvatis/openclaw-todo
Last synced: 3 months ago
JSON representation
OpenClaw plugin: Manage TODOs in markdown files with natural language.
- Host: GitHub
- URL: https://github.com/elvatis/openclaw-todo
- Owner: elvatis
- License: mit
- Created: 2026-02-24T11:46:09.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-02-27T19:50:52.000Z (3 months ago)
- Last Synced: 2026-02-27T21:25:32.769Z (3 months ago)
- Language: TypeScript
- Size: 91.8 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Roadmap: ROADMAP.md
Awesome Lists containing this project
README
# openclaw-todo
OpenClaw plugin to manage `TODO.md` via chat commands.
## Commands
- `/todo-list` - show open items (with priority indicators)
- `/todo-add ` - add an item (supports `#tag` and `!high`/`!medium`/`!low`)
- `/todo-done ` - mark item done
- `/todo-edit ` - edit an item's text
- `/todo-remove ` - remove an item
- `/todo-search ` - search items by text, `#tag`, or `!priority`
## Tags and Priority
Inline tags and priority markers are supported in todo text:
```
/todo-add Fix login page #dev #frontend !high
/todo-add Update README #docs !low
/todo-add Review PR #backend
```
- **Tags**: `#word` - categorize items (e.g. `#dev`, `#front-end`, `#ops`)
- **Priority**: `!high`, `!medium`, `!low` - set urgency level
Tags and priorities are parsed automatically and displayed in `/todo-list`:
```
Open TODOs (3):
1. [HIGH] Fix login page #dev #frontend !high
2. [LOW] Update README #docs !low
3. Review PR #backend
```
The `todo_status` tool also returns structured `tags` and `priority` fields per item.
## Tool
- `todo_status({ limit })` - structured TODO status for the agent
## Configuration
All options are set via `pluginConfig` in your OpenClaw config:
| Option | Type | Default | Description |
|---|---|---|---|
| `enabled` | boolean | `true` | Enable/disable the plugin |
| `todoFile` | string | `~/.openclaw/workspace/TODO.md` | Path to the TODO file |
| `sectionHeader` | string | _(none)_ | Section heading under which new todos are inserted (e.g. `"## Backlog"`). When omitted, new items are appended after the last existing todo. |
| `brainLog` | boolean | `true` | Log todo changes to memory brain |
| `brainStorePath` | string | `~/.openclaw/workspace/memory/brain-memory.jsonl` | Path to the brain memory store |
| `maxListItems` | number | `30` | Maximum items shown by `/todo-list` |
## Install (dev)
```bash
openclaw plugins install -l ~/.openclaw/workspace/openclaw-todo
openclaw gateway restart
```
## Shared Template
For automation that creates GitHub issues, use `src/templates/github-issue-helper.ts`.
It provides `isValidIssueRepoSlug()`, `resolveIssueRepo()`, and `buildGhIssueCreateCommand()`.