README.md — minder

1# Minder

3Scheduled task channel server for Claude Code sessions, built with [Sigil](https://codeberg.org/sigil/sigil).

5Minder manages cron-based scheduled tasks and pushes events into a running

6Claude Code session via the MCP channel protocol.

8## Installation

10```bash

11sigil app install codeberg:sigil/minder

12```

14## Configuration

16Schedules are defined in `minder.yaml`:

18```yaml

19schedules:

20 check-services:

21 cron: "*/30 * * * *"

22 prompt: "Check service health"

23 daily-review:

24 cron: "0 9 * * *"

25 prompt: "Daily task review"

26```

28Schedules can also be managed at runtime via MCP tools — changes are

29persisted back to `minder.yaml`.

31## Running

33Minder is designed to be spawned by Claude Code as a channel MCP server:

35```bash

36claude --channels server:minder

37```

39Register in `.mcp.json`:

41```json

42{

43 "mcpServers": {

44 "minder": {

45 "command": "./build/dev/bin/minder",

46 "env": {}

47 }

48 }

49}

50```

52## MCP Tools

54| Tool | Description |

55|------|-------------|

56| `list-schedules` | List all active scheduled tasks |

57| `add-schedule` | Add a recurring or one-time scheduled task |

58| `remove-schedule` | Remove a scheduled task |

60Cron expressions use 5 fields: `minute hour day-of-month month day-of-week`.

62## Building

64```bash

65sigil deps install

66sigil build

67```

69A C toolchain is required. On Guix: `guix shell -m ../sigil/manifest.scm`

71## License

73BSD-3-Clause