JynJyn Docs

Features

What Jyn can do today and what is planned.

Available Beta

Task Management

Add, edit, and remove tasks with minimal ceremony:

jyn add "Write integration tests" --priority high
jyn edit JOT-0003 --title "Write integration and unit tests"
jyn rm JOT-0005

Status Workflow

Simple lifecycle for personal tasks:

jyn done JOT-0001               # Mark as done
jyn ls --status open             # Show open tasks
jyn ls --status done             # Show completed tasks

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

Four priority levels to surface what matters most:

jyn add "Fix broken deploy" --priority critical
jyn add "Update docs" --priority low
jyn ls --priority high           # Show high-priority tasks

Effort Tracking

Estimate effort on a 1-7 scale, same as Joy:

jyn add "Migrate database" --effort 5
jyn ls --effort 3                # Show tasks with effort >= 3

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.

Coming Next Planned

Recurring Tasks (RRULE)

Define tasks that repeat on a schedule using standard RRULE syntax:

jyn add "Weekly team standup" --recur "FREQ=WEEKLY;BYDAY=MO"
jyn add "Pay rent" --recur "FREQ=MONTHLY;BYMONTHDAY=1"

Recurring tasks auto-generate new instances when the current one is completed or when the next occurrence is due.

Due Dates

Set deadlines on tasks and get warned about overdue items:

jyn add "Submit report" --due 2026-04-15
jyn ls --overdue                 # Show overdue tasks

Reminders

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

CalDAV Sync

Bidirectional sync with CalDAV clients. Create tasks in Jyn, check them off on your phone. 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.