Features

Available Beta

Task Management

Add, edit, and remove tasks with minimal ceremony:

jyn add "Write integration tests" --priority high
jyn edit #1 --title "Write integration and unit tests"
jyn rm #2

Status Workflow

Simple lifecycle for personal tasks:

jyn done #1        # Mark as done (alias for jyn close)
jyn ls             # Show open tasks (the default)
jyn --closed       # Show completed tasks
jyn --all          # Include closed and archived

Tags

Organize tasks with free-text tags for filtering and grouping:

jyn add "Review pull request JOY-00D3" --tag work
jyn add "Call Lisa" --tag personal --prio high
jyn ls --tag work                # Show only work tasks

Priorities

Five priority levels to surface what matters most: low, medium, high, critical, extreme.

jyn add "Fix broken deploy" --priority critical
jyn add "Update docs" --priority low
jyn ls --sort priority           # Sort by priority, highest first

Due Dates

Set a deadline on a task and list by what is due. --due accepts a calendar date, a weekday name, a relative offset, or a date plus time of day:

jyn add "Submit report" --due 2026-04-15
jyn add "Reply to RFC"  --due fri
jyn add "Pay invoice"   --due +3d
jyn add "Health check"  --due "2026-04-13 14:00"
jyn ls --due today               # Due today or overdue
jyn ls --sort due                # Sort by due date

Recurring Tasks

Turn any task into a repeating series. --recur takes a short human phrase that jyn translates into an iCalendar rule (RFC 5545) for storage and sync. Completing the task with jyn done records that occurrence and rolls the due date forward to the next one.

jyn add "Standup"          --due 2026-04-13      --recur "every Monday"
jyn add "Water plants"     --due 2026-04-13      --recur daily
jyn add "Pay rent"         --due 2026-04-01      --recur "monthly on the 1st"
jyn add "Quarterly review" --due 2026-04-01      --recur "every 3 months"
jyn add "Health check"     --due "2026-04-13 14:00" --recur "hourly for 3 times"

Phrases jyn understands: bare frequency (daily, weekly, monthly, yearly, hourly), every <weekday>, every N <unit>, weekdays, monthly on the Nth, plus an optional for N times / for N <unit> suffix to cap the series. Raw RRULE bodies like FREQ=WEEKLY;BYDAY=MO,WE,FR are accepted as a power-user fallback.

Configuration

Personal preferences live in YAML, layered so global settings apply everywhere and project-local settings only inside a specific .jyn/:

• Global: ~/.config/jyn/config.yaml (or $XDG_CONFIG_HOME/jyn/config.yaml)
• Project-local: ./.jyn/config.yaml

Inspect and modify via jyn config:

jyn config                                     # merged view, [default] marks unset
jyn config get output.fortune                  # print a single value
jyn config set --global output.fortune false   # personal preference, everywhere
jyn config set --local  output.fortune-category tech  # this project only

When no config file exists yet, jyn config set asks for an explicit --global or --local so a .jyn/ never appears in a surprise directory. Typos like outpt.fortune are rejected at set-time with a schema-derived hint rather than silently accepted.

Tutorial and Self-Update

A built-in tutorial and a self-updater round out the CLI:

jyn tutorial          # guided walk-through (add -i to browse by chapter)
jyn update            # update the binary to the latest release
jyn update --check    # check without changing anything

jyn update only swaps binaries installed via the official installer; builds from a package manager are left untouched.

Coming Next Planned

Reminders

Time-based reminders for tasks with due dates. Delivered through the platform or desktop notifications.

Sync and Integrations

Create tasks in Jyn, check them off anywhere, synced back through the Joyint platform:

• CalDAV - Apple Reminders, Google Calendar, Thunderbird, and any standards-compliant client.
• Microsoft 365 - A Microsoft Graph adapter syncs to Microsoft To Do (visible in Outlook and the To Do app), with optional Teams notifications.

See Applications for details.

Dispatch Integration with Joy

Receive tasks dispatched from a Joy backlog. When a team uses Joy for planning and Jyn for personal execution, dispatch bridges the two: Joy items can spawn Jyn tasks for individual team members.