# Calcurse

> A text-based calendar and scheduling application. Use strictly for CLI-based calendar management.

- Skill: `modbender/calcurse` (Agent Skill)
- Install (CLI): `npx skillmds@latest add modbender/calcurse`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modbender/calcurse/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: modbender (https://skillmd.com/u/modbender)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/modbender/calcurse

---


# calcurse

A text-based calendar and scheduling application.

## Usage (CLI Mode)

Use `calcurse` in non-interactive mode for quick queries and updates.

### Query
List appointments for the next 2 days:
```bash
calcurse -r2
```

Query a specific date range:
```bash
calcurse -Q --from 2026-01-20 --to 2026-01-22
```

### Add Items
Add an appointment:
```bash
calcurse -a "Meeting with Team" 2026-01-21 14:00 60
```
(Format: Description, Date, Time, Duration in mins)

Add a todo:
```bash
calcurse -t "Buy milk" 1
```
(Format: Description, Priority)

## Interactive Mode (TUI)
For the full TUI experience, run in a PTY session (e.g., inside `tmux` or using `process` with `pty=true`).
```bash
calcurse
```