Files
gems/opal-task
joakim 9bde1aefea Migrate table formatting to go-pretty for proper UTF-8 and ANSI handling
Replace manual string-based table formatting with jedib0t/go-pretty/v6/table
library to fix alignment issues with Norwegian characters (æøå) and ANSI
color codes.

Changes:
- Migrate FormatTaskList() to use go-pretty table
- Migrate FormatTaskDetail() to use clean table format
- Migrate FormatProjects() and FormatTagCounts() for consistency
- Remove truncate() function (no longer needed)
- Configure StyleLight with Unicode box-drawing characters
- Set proper column widths and alignment

Fixes:
- Priority column now center-aligned under 'Pri'
- Norwegian characters (æøå) display and align correctly
- Tags column properly aligned
- Description field truncates at 40 chars with proper UTF-8 handling
- All ANSI color codes handled automatically
- Consistent formatting across all table views

All existing color functions work unchanged. UTF-8 and ANSI codes are
handled automatically by go-pretty's width calculation.
2026-01-05 13:41:46 +01:00
..

Opal task manager

This is the counterpart to jade, where we track tasks.

Syntax

opal [<filter>] [<command>] [<modifier>]

Filters the Task to run a command on. Adressing a set of subtasks. opal +home -garden status:pending list - lists all tasks with the +home tag and status pending, but excludes +garden tags. This is a compound filter with implicit AND.

add - Creates a new task done - Completes a task list - Lists task count - Counts number of tasks

Modifies atributes of tasks.

Task

A task has multiple atributes: status - pending, completed, deleted, recurring description - One line summary start - the most recent time at which this task was started (a task with no start key is not active) end - if present, the time at which this task was completed or deleted due - Use a due date to specify the exact date by which a task must be completed.created - Time task created schedueled - represents the earliest opportunity to work on a task. If a task has a scheduled date, then once that date passes, the task is considered ready. Tasks with no scheduled is considered always ready. wait - a wait date for a task, which has the effect of hiding the task from you until that date. until - the point at which to mark task as deleted. an expiration date.

Recurrence

A task can be recurring. Then we have a template task and instances of that task. opal add Change sheets due:sun recur:1w - A task to be done every sunday. A recurring task is given a status of recurring which hides it from view. The recurring task you create is called the template task, from which recurring tasks instances are created. So the template remains hidden, and the recurring instances that spawn from it are the tasks that you will see and complete.

Storage

Sqlite store.