Task Management

Adding Tasks

`tycana add`

The natural language parser handles projects, tags, dates, times, and estimates in a single sentence.

# Natural language — write tasks the way you think
tycana add "Renew staging cert @infra #urgent ~2h due tomorrow"
tycana add "Incident review friday 2pm @work"
tycana add "Review backup logs by end of week"

# Structured flags — for scripts and automation
tycana add "Deploy v2" --project ops --due friday --tags release
tycana add "Update runbook" --estimate 2h --note "Cover failover procedure"
tycana add "Standup" --due "2026-03-05 14:00"     # Date + 24-hour time

# Machine-readable output for scripts
tycana add "Deploy v2" --format json          # Returns created task as JSON
tycana add "Deploy v2" --format json | jq .ID # Extract just the ID
tycana add "Deploy v2" -q                     # Silent — exit code only

# Interactive form
tycana add

What the parser understands:

Syntax	Effect
`@infra`	Sets project
`#urgent #p1`	Adds tags
`~2h`, `~30m`	Sets time estimate
`tomorrow`, `friday 2pm`	Sets due date/time

See Natural Language for all supported date, time, and recurrence patterns.

Calendar tip: Tasks with a specific time appear in your calendar. Tasks with only a date are deadlines. The CLI tells you which: date-only tasks show a hint when you have sync configured.

Showing Task Details

`tycana show`

Display all fields for a single task, including notes. Tasks with notes show a + indicator in list output — use show to read the full note.

tycana show "staging cert"               # Find by title
tycana show 3                            # By number
tycana show abc123                       # By ID
tycana show                              # Browse all tasks

# Machine-readable output
tycana show abc123 --format json

Completing Tasks

`tycana done`

Find tasks by title, number, or ID.

# Natural title matching
tycana done "incident review"
tycana done "renew staging cert"

# By task number (from list output)
tycana done 1

# By task ID
tycana done abc123

# Interactive selection
tycana done

# Bulk completion
tycana done --project sprint-1           # Complete entire project
tycana done --tag milestone              # Complete by tag
tycana done --older-than 30d             # Complete stale tasks
tycana done --dry-run                    # Preview first

# Machine-readable output
tycana done "auth bug" --format json     # Returns completed task as JSON
tycana done --project sprint-1 -f json   # Returns array of completed tasks

Editing Tasks

`tycana edit`

Opens an interactive form pre-populated with the task’s current values. Same smart selection as done.

tycana edit "staging issue"               # Find by title
tycana edit 3                            # By number
tycana edit abc123                       # By ID
tycana edit                              # Browse all tasks

# Quick updates via flags (skip interactive form)
tycana edit abc123 --due friday
tycana edit abc123 --due "friday 2pm"             # Date + time
tycana edit abc123 --tags "urgent,p1"
tycana edit abc123 --project backend

# Machine-readable output
tycana edit abc123 --due friday --format json   # Returns modified task

Removing Tasks

`tycana rm`

Permanently removes a task.

tycana rm "old planning task"
tycana rm 5
tycana rm abc123
tycana rm abc123 --force --format json   # Script-friendly: skip prompt, return JSON

`tycana undo`

Reverse the last action (creation or deletion).

tycana undo