calcurse

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

Security Scan

The skill is a minimal, instruction-only wrapper for running the local calcurse CLI and is internally consistent with that purpose.

Purpose & Capability

Name, description, and required binary (calcurse) align: the skill simply instructs the agent to invoke the local calcurse CLI for calendar operations. No unrelated services, env vars, or credentials are requested.

Instruction Scope

SKILL.md contains only calcurse CLI examples (non-interactive queries, adding items) and a note about using a PTY for the TUI. It does not instruct reading unrelated files or external endpoints. Note: invoking calcurse will read/write the user's calendar data (typically in ~/.calcurse) even though no config paths are declared—this is expected for a CLI calendar tool.

Install Mechanism

No install spec (instruction-only). The skill requires the calcurse binary to already be present; nothing is downloaded or written by the skill bundle itself.

Credentials

No environment variables, credentials, or config paths are requested. The lack of declared config paths is acceptable but remember the calcurse binary will use its normal data directory on the host.

Persistence & Privilege

always is false and the skill is user-invocable. It does not request persistent or platform-wide privileges and does not modify other skills.

Assessment

This skill is essentially a set of usage instructions for the local calcurse CLI. Before installing: ensure you trust the calcurse binary on the host (verify source/version), be aware that running the skill runs that local binary which will read and modify your calendar data (usually ~/.calcurse), and consider backing up your calendar files if you care about accidental changes. If you are uncomfortable with an agent being able to execute local commands, limit autonomous invocation or require explicit user confirmation before the skill runs commands.

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:

calcurse -r2

Query a specific date range:

calcurse -Q --from 2026-01-20 --to 2026-01-22

Add Items

Add an appointment:

calcurse -a "Meeting with Team" 2026-01-21 14:00 60

(Format: Description, Date, Time, Duration in mins)

Add a todo:

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).

calcurse