things3

package module

Go to main page

Versions in this module

v0

v0.5.4

Feb 22, 2026

v0.5.3

Feb 21, 2026

v0.5.2

Feb 21, 2026

v0.5.1

Feb 21, 2026

v0.5.0

Feb 20, 2026

Changes in this version

+ type AreaQueryBuilder interface

+ HasTag func(has bool) AreaQueryBuilder

+ InTag func(title string) AreaQueryBuilder

+ IncludeItems func(include bool) AreaQueryBuilder

+ Visible func(visible bool) AreaQueryBuilder

+ WithTitle func(title string) AreaQueryBuilder

+ WithUUID func(uuid string) AreaQueryBuilder

+ type AreaQueryExecutor interface

+ All func(ctx context.Context) ([]Area, error)

+ Count func(ctx context.Context) (int, error)

+ First func(ctx context.Context) (*Area, error)

+ type AuthBatchCreator interface

+ AddProject func(configure func(BatchProjectConfigurator)) AuthBatchCreator

+ AddTodo func(configure func(BatchTodoConfigurator)) AuthBatchCreator

+ Build func() (string, error)

+ Execute func(ctx context.Context) error

+ Reveal func(reveal bool) AuthBatchCreator

+ UpdateProject func(id string, configure func(BatchProjectConfigurator)) AuthBatchCreator

+ UpdateTodo func(id string, configure func(BatchTodoConfigurator)) AuthBatchCreator

+ type BatchCreator interface

+ AddProject func(configure func(BatchProjectConfigurator)) BatchCreator

+ AddTodo func(configure func(BatchTodoConfigurator)) BatchCreator

+ Build func() (string, error)

+ Execute func(ctx context.Context) error

+ Reveal func(reveal bool) BatchCreator

+ type BatchProjectConfigurator interface

+ AddTags func(tags ...string) BatchProjectConfigurator

+ AppendNotes func(notes string) BatchProjectConfigurator

+ Area func(name string) BatchProjectConfigurator

+ AreaID func(id string) BatchProjectConfigurator

+ Canceled func(canceled bool) BatchProjectConfigurator

+ Completed func(completed bool) BatchProjectConfigurator

+ CompletionDate func(date time.Time) BatchProjectConfigurator

+ CreationDate func(date time.Time) BatchProjectConfigurator

+ Deadline func(t time.Time) BatchProjectConfigurator

+ Notes func(notes string) BatchProjectConfigurator

+ PrependNotes func(notes string) BatchProjectConfigurator

+ Tags func(tags ...string) BatchProjectConfigurator

+ Title func(title string) BatchProjectConfigurator

+ Todos func(configs ...func(BatchTodoConfigurator)) BatchProjectConfigurator

+ When func(t time.Time) BatchProjectConfigurator

+ WhenAnytime func() BatchProjectConfigurator

+ WhenEvening func() BatchProjectConfigurator

+ WhenSomeday func() BatchProjectConfigurator

+ type BatchTodoConfigurator interface

+ AddTags func(tags ...string) BatchTodoConfigurator

+ AppendNotes func(notes string) BatchTodoConfigurator

+ Canceled func(canceled bool) BatchTodoConfigurator

+ ChecklistItems func(items ...string) BatchTodoConfigurator

+ Completed func(completed bool) BatchTodoConfigurator

+ CompletionDate func(date time.Time) BatchTodoConfigurator

+ CreationDate func(date time.Time) BatchTodoConfigurator

+ Deadline func(t time.Time) BatchTodoConfigurator

+ Heading func(name string) BatchTodoConfigurator

+ List func(name string) BatchTodoConfigurator

+ ListID func(id string) BatchTodoConfigurator

+ Notes func(notes string) BatchTodoConfigurator

+ PrependNotes func(notes string) BatchTodoConfigurator

+ Tags func(tags ...string) BatchTodoConfigurator

+ Title func(title string) BatchTodoConfigurator

+ When func(t time.Time) BatchTodoConfigurator

+ WhenAnytime func() BatchTodoConfigurator

+ WhenEvening func() BatchTodoConfigurator

+ WhenSomeday func() BatchTodoConfigurator

type Client

+ func NewClient(opts ...ClientOption) (*Client, error)

+ func (c *Client) AddProject() ProjectAdder

+ func (c *Client) AddTodo() TodoAdder

+ func (c *Client) AuthBatch() AuthBatchCreator

+ func (c *Client) Batch() BatchCreator

+ func (c *Client) CreatedWithin(ctx context.Context, since time.Time) ([]Task, error)

+ func (c *Client) ShowBuilder() ShowNavigator

+ func (c *Client) ShowList(ctx context.Context, list ListID) error

+ func (c *Client) ShowSearch(ctx context.Context, query string) error

+ func (c *Client) UpdateProject(id string) ProjectUpdater

+ func (c *Client) UpdateTodo(id string) TodoUpdater

+ type ClientOption func(*clientOptions)

+ func WithBackgroundNavigation() ClientOption

+ func WithForegroundExecution() ClientOption

+ func WithPreloadToken() ClientOption

+ type DateFilterBuilder interface

+ After func(date time.Time) TaskQueryBuilder

+ Before func(date time.Time) TaskQueryBuilder

+ Exists func(has bool) TaskQueryBuilder

+ Future func() TaskQueryBuilder

+ On func(date time.Time) TaskQueryBuilder

+ OnOrAfter func(date time.Time) TaskQueryBuilder

+ OnOrBefore func(date time.Time) TaskQueryBuilder

+ Past func() TaskQueryBuilder

+ type ProjectAdder interface

+ Area func(name string) ProjectAdder

+ AreaID func(id string) ProjectAdder

+ Canceled func(canceled bool) ProjectAdder

+ Completed func(completed bool) ProjectAdder

+ CompletionDate func(date time.Time) ProjectAdder

+ CreationDate func(date time.Time) ProjectAdder

+ Deadline func(t time.Time) ProjectAdder

+ Notes func(notes string) ProjectAdder

+ Reminder func(hour, minute int) ProjectAdder

+ Reveal func(reveal bool) ProjectAdder

+ Tags func(tags ...string) ProjectAdder

+ Title func(title string) ProjectAdder

+ Todos func(titles ...string) ProjectAdder

+ When func(t time.Time) ProjectAdder

+ WhenAnytime func() ProjectAdder

+ WhenEvening func() ProjectAdder

+ WhenSomeday func() ProjectAdder

+ type ProjectUpdater interface

+ AddTags func(tags ...string) ProjectUpdater

+ AppendNotes func(notes string) ProjectUpdater

+ Area func(name string) ProjectUpdater

+ AreaID func(id string) ProjectUpdater

+ Canceled func(canceled bool) ProjectUpdater

+ ClearDeadline func() ProjectUpdater

+ Completed func(completed bool) ProjectUpdater

+ Deadline func(t time.Time) ProjectUpdater

+ Notes func(notes string) ProjectUpdater

+ PrependNotes func(notes string) ProjectUpdater

+ Reminder func(hour, minute int) ProjectUpdater

+ Reveal func(reveal bool) ProjectUpdater

+ Tags func(tags ...string) ProjectUpdater

+ Title func(title string) ProjectUpdater

+ When func(t time.Time) ProjectUpdater

+ WhenAnytime func() ProjectUpdater

+ WhenEvening func() ProjectUpdater

+ WhenSomeday func() ProjectUpdater

+ type ShowNavigator interface

+ Build func() (string, error)

+ Execute func(ctx context.Context) error

+ Filter func(tags ...string) ShowNavigator

+ ID func(id string) ShowNavigator

+ List func(list ListID) ShowNavigator

+ Query func(query string) ShowNavigator

+ type StartFilterBuilder interface

+ Anytime func() TaskQueryBuilder

+ Inbox func() TaskQueryBuilder

+ Someday func() TaskQueryBuilder

type Status

+ func (s *Status) UnmarshalJSON(data []byte) error

+ func (s *Status) UnmarshalYAML(unmarshal func(any) error) error

+ func (s Status) MarshalJSON() ([]byte, error)

+ func (s Status) MarshalYAML() (any, error)

+ type StatusFilterBuilder interface

+ Any func() TaskQueryBuilder

+ Canceled func() TaskQueryBuilder

+ Completed func() TaskQueryBuilder

+ Incomplete func() TaskQueryBuilder

+ type TagQueryBuilder interface

+ IncludeItems func(include bool) TagQueryBuilder

+ WithParent func(parentUUID string) TagQueryBuilder

+ WithTitle func(title string) TagQueryBuilder

+ WithUUID func(uuid string) TagQueryBuilder

+ type TagQueryExecutor interface

+ All func(ctx context.Context) ([]Tag, error)

+ First func(ctx context.Context) (*Tag, error)

+ type TaskQueryBuilder interface

+ IncludeItems func(include bool) TaskQueryBuilder

+ OrderByTodayIndex func() TaskQueryBuilder

+ Search func(query string) TaskQueryBuilder

+ WithDeadlineSuppressed func(suppressed bool) TaskQueryBuilder

+ WithUUID func(uuid string) TaskQueryBuilder

+ WithUUIDPrefix func(prefix string) TaskQueryBuilder

+ type TaskQueryExecutor interface

+ All func(ctx context.Context) ([]Task, error)

+ Count func(ctx context.Context) (int, error)

+ First func(ctx context.Context) (*Task, error)

+ type TaskRelationFilter interface

+ HasArea func(has bool) TaskQueryBuilder

+ HasHeading func(has bool) TaskQueryBuilder

+ HasProject func(has bool) TaskQueryBuilder

+ HasTag func(has bool) TaskQueryBuilder

+ InArea func(uuid string) TaskQueryBuilder

+ InHeading func(uuid string) TaskQueryBuilder

+ InProject func(uuid string) TaskQueryBuilder

+ InTag func(title string) TaskQueryBuilder

+ type TaskStateFilter interface

+ ContextTrashed func(trashed bool) TaskQueryBuilder

+ Start func() StartFilterBuilder

+ Status func() StatusFilterBuilder

+ Trashed func(trashed bool) TaskQueryBuilder

+ Type func() TypeFilterBuilder

+ type TaskTimeFilter interface

+ CreatedAfter func(t time.Time) TaskQueryBuilder

+ Deadline func() DateFilterBuilder

+ StartDate func() DateFilterBuilder

+ StopDate func() DateFilterBuilder

type TaskType

+ func (t *TaskType) UnmarshalJSON(data []byte) error

+ func (t *TaskType) UnmarshalYAML(unmarshal func(any) error) error

+ func (t TaskType) MarshalJSON() ([]byte, error)

+ func (t TaskType) MarshalYAML() (any, error)

+ type TodoAdder interface

+ Canceled func(canceled bool) TodoAdder

+ ChecklistItems func(items ...string) TodoAdder

+ Completed func(completed bool) TodoAdder

+ CompletionDate func(date time.Time) TodoAdder

+ CreationDate func(date time.Time) TodoAdder

+ Deadline func(t time.Time) TodoAdder

+ Heading func(name string) TodoAdder

+ HeadingID func(id string) TodoAdder

+ List func(name string) TodoAdder

+ ListID func(id string) TodoAdder

+ Notes func(notes string) TodoAdder

+ Reminder func(hour, minute int) TodoAdder

+ Reveal func(reveal bool) TodoAdder

+ ShowQuickEntry func(show bool) TodoAdder

+ Tags func(tags ...string) TodoAdder

+ Title func(title string) TodoAdder

+ Titles func(titles ...string) TodoAdder

+ When func(t time.Time) TodoAdder

+ WhenAnytime func() TodoAdder

+ WhenEvening func() TodoAdder

+ WhenSomeday func() TodoAdder

+ type TodoUpdater interface

+ AddTags func(tags ...string) TodoUpdater

+ AppendChecklistItems func(items ...string) TodoUpdater

+ AppendNotes func(notes string) TodoUpdater

+ Canceled func(canceled bool) TodoUpdater

+ ChecklistItems func(items ...string) TodoUpdater

+ ClearDeadline func() TodoUpdater

+ Completed func(completed bool) TodoUpdater

+ CompletionDate func(date time.Time) TodoUpdater

+ CreationDate func(date time.Time) TodoUpdater

+ Deadline func(t time.Time) TodoUpdater

+ Duplicate func(duplicate bool) TodoUpdater

+ Heading func(name string) TodoUpdater

+ HeadingID func(id string) TodoUpdater

+ List func(name string) TodoUpdater

+ ListID func(id string) TodoUpdater

+ Notes func(notes string) TodoUpdater

+ PrependChecklistItems func(items ...string) TodoUpdater

+ PrependNotes func(notes string) TodoUpdater

+ Reminder func(hour, minute int) TodoUpdater

+ Reveal func(reveal bool) TodoUpdater

+ Tags func(tags ...string) TodoUpdater

+ Title func(title string) TodoUpdater

+ When func(t time.Time) TodoUpdater

+ WhenAnytime func() TodoUpdater

+ WhenEvening func() TodoUpdater

+ WhenSomeday func() TodoUpdater

+ type TypeFilterBuilder interface

+ Heading func() TaskQueryBuilder

+ Project func() TaskQueryBuilder

+ Todo func() TaskQueryBuilder

+ type URLBuilder interface

+ Build func() (string, error)

+ Execute func(ctx context.Context) error

v0.5.0-rc.1

Feb 4, 2026

v0.4.0

Jan 1, 2026

Changes in this version

+ func ApplyWhen[T WhenScheduler[T]](b T, when string) T

+ func DaysAgo(n int) time.Time

+ func MonthsAgo(n int) time.Time

+ func Today() time.Time

+ func Tomorrow() time.Time

+ func WeeksAgo(n int) time.Time

+ func YearsAgo(n int) time.Time

type JSONProjectBuilder

+ func (p *JSONProjectBuilder) WhenAnytime() *JSONProjectBuilder

+ func (p *JSONProjectBuilder) WhenEvening() *JSONProjectBuilder

+ func (p *JSONProjectBuilder) WhenSomeday() *JSONProjectBuilder

type JSONTodoBuilder

+ func (t *JSONTodoBuilder) WhenAnytime() *JSONTodoBuilder

+ func (t *JSONTodoBuilder) WhenEvening() *JSONTodoBuilder

+ func (t *JSONTodoBuilder) WhenSomeday() *JSONTodoBuilder

type ProjectBuilder

+ func (b *ProjectBuilder) WhenAnytime() *ProjectBuilder

+ func (b *ProjectBuilder) WhenEvening() *ProjectBuilder

+ func (b *ProjectBuilder) WhenSomeday() *ProjectBuilder

type SchemeOption

+ func WithBackground() SchemeOption

type TaskQuery

+ func (q *TaskQuery) CreatedAfter(t time.Time) *TaskQuery

type TodoBuilder

+ func (b *TodoBuilder) WhenAnytime() *TodoBuilder

+ func (b *TodoBuilder) WhenEvening() *TodoBuilder

+ func (b *TodoBuilder) WhenSomeday() *TodoBuilder

type UpdateProjectBuilder

+ func (b *UpdateProjectBuilder) WhenAnytime() *UpdateProjectBuilder

+ func (b *UpdateProjectBuilder) WhenEvening() *UpdateProjectBuilder

+ func (b *UpdateProjectBuilder) WhenSomeday() *UpdateProjectBuilder

type UpdateTodoBuilder

+ func (b *UpdateTodoBuilder) WhenAnytime() *UpdateTodoBuilder

+ func (b *UpdateTodoBuilder) WhenEvening() *UpdateTodoBuilder

+ func (b *UpdateTodoBuilder) WhenSomeday() *UpdateTodoBuilder

+ type WhenScheduler interface

+ When func(t time.Time) T

+ WhenAnytime func() T

+ WhenEvening func() T

+ WhenSomeday func() T

v0.3.0

Dec 28, 2025

Changes in this version

+ var ErrInvalidReminderTime = errors.New("things3: invalid reminder time (hour must be 0-23, minute must be 0-59)")

type AuthJSONBuilder

+ func (b *AuthJSONBuilder) Execute(ctx context.Context) error

type JSONBuilder

+ func (b *JSONBuilder) Execute(ctx context.Context) error

type ProjectBuilder

+ func (b *ProjectBuilder) Execute(ctx context.Context) error

+ func (b *ProjectBuilder) Reminder(hour, minute int) *ProjectBuilder

type Scheme

+ func (s *Scheme) SearchURL(query string) string

+ func (s *Scheme) ShowBuilder() *ShowBuilder

+ type SchemeOption func(*Scheme)

+ func WithForeground() SchemeOption

type ShowBuilder

+ func (b *ShowBuilder) Execute(ctx context.Context) error

type TodoBuilder

+ func (b *TodoBuilder) Execute(ctx context.Context) error

+ func (b *TodoBuilder) Reminder(hour, minute int) *TodoBuilder

type UpdateProjectBuilder

+ func (b *UpdateProjectBuilder) Execute(ctx context.Context) error

+ func (b *UpdateProjectBuilder) Reminder(hour, minute int) *UpdateProjectBuilder

type UpdateTodoBuilder

+ func (b *UpdateTodoBuilder) Execute(ctx context.Context) error

+ func (b *UpdateTodoBuilder) Reminder(hour, minute int) *UpdateTodoBuilder

v0.2.1

Dec 17, 2025

Changes in this version

type AreaQuery

+ func (q *AreaQuery) Visible(visible bool) *AreaQuery

+ func (q *AreaQuery) WithTitle(title string) *AreaQuery

type StatusFilter

+ func (f *StatusFilter) Any() *TaskQuery

type TagQuery

+ func (q *TagQuery) WithParent(parentUUID string) *TagQuery

+ func (q *TagQuery) WithUUID(uuid string) *TagQuery

v0.2.0

Dec 14, 2025

Changes in this version

+ var ErrEmptyToken = errors.New("things3: empty token provided to WithToken")

+ var ErrIDRequired = errors.New("things3: id required for update operation")

+ var ErrNoJSONItems = errors.New("things3: no items provided for JSON operation")

+ var ErrNotesTooLong = errors.New("things3: notes exceed 10,000 character limit")

+ var ErrTitleTooLong = errors.New("things3: title exceeds 4,000 character limit")

+ var ErrTooManyChecklistItems = errors.New("things3: checklist exceeds 100 item limit")

+ func Headings(headings ...string) string

type AreaQuery

+ func (q *AreaQuery) InTag(tag any) *AreaQuery

+ type AuthJSONBuilder struct

+ func (b *AuthJSONBuilder) AddProject(configure func(*JSONProjectBuilder)) *AuthJSONBuilder

+ func (b *AuthJSONBuilder) AddTodo(configure func(*JSONTodoBuilder)) *AuthJSONBuilder

+ func (b *AuthJSONBuilder) Build() (string, error)

+ func (b *AuthJSONBuilder) Reveal(reveal bool) *AuthJSONBuilder

+ func (b *AuthJSONBuilder) UpdateProject(id string, configure func(*JSONProjectBuilder)) *AuthJSONBuilder

+ func (b *AuthJSONBuilder) UpdateTodo(id string, configure func(*JSONTodoBuilder)) *AuthJSONBuilder

+ type AuthScheme struct

+ func (a *AuthScheme) JSON() *AuthJSONBuilder

+ func (a *AuthScheme) UpdateProject(id string) *UpdateProjectBuilder

+ func (a *AuthScheme) UpdateTodo(id string) *UpdateTodoBuilder

+ type Command string

+ const CommandAdd

+ const CommandAddProject

+ const CommandJSON

+ const CommandSearch

+ const CommandShow

+ const CommandUpdate

+ const CommandUpdateProject

+ const CommandVersion

+ func (c Command) String() string

+ type DB struct

+ func NewDB(opts ...DBOption) (*DB, error)

+ func (d *DB) Anytime(ctx context.Context) ([]Task, error)

+ func (d *DB) Areas() *AreaQuery

+ func (d *DB) Canceled(ctx context.Context) ([]Task, error)

+ func (d *DB) ChecklistItems(ctx context.Context, todoUUID string) ([]ChecklistItem, error)

+ func (d *DB) Close() error

+ func (d *DB) Complete(ctx context.Context, uuid string) error

+ func (d *DB) Completed(ctx context.Context) ([]Task, error)

+ func (d *DB) CreatedWithin(ctx context.Context, duration Duration) ([]Task, error)

+ func (d *DB) Deadlines(ctx context.Context) ([]Task, error)

+ func (d *DB) Filepath() string

+ func (d *DB) Get(ctx context.Context, uuid string) (any, error)

+ func (d *DB) Inbox(ctx context.Context) ([]Task, error)

+ func (d *DB) Logbook(ctx context.Context) ([]Task, error)

+ func (d *DB) OpenSearch(ctx context.Context, query string) error

+ func (d *DB) Projects(ctx context.Context) ([]Task, error)

+ func (d *DB) Search(ctx context.Context, query string) ([]Task, error)

+ func (d *DB) Show(ctx context.Context, uuid string) error

+ func (d *DB) Someday(ctx context.Context) ([]Task, error)

+ func (d *DB) Tags() *TagQuery

+ func (d *DB) Tasks() *TaskQuery

+ func (d *DB) Today(ctx context.Context) ([]Task, error)

+ func (d *DB) Todos(ctx context.Context) ([]Task, error)

+ func (d *DB) Token(ctx context.Context) (string, error)

+ func (d *DB) Trash(ctx context.Context) ([]Task, error)

+ func (d *DB) Upcoming(ctx context.Context) ([]Task, error)

+ type DBOption func(*dbOptions)

+ func WithDBPath(path string) DBOption

+ type DateFilter struct

+ func (f *DateFilter) After(date time.Time) *TaskQuery

+ func (f *DateFilter) Before(date time.Time) *TaskQuery

+ func (f *DateFilter) Exists(has bool) *TaskQuery

+ func (f *DateFilter) Future() *TaskQuery

+ func (f *DateFilter) On(date time.Time) *TaskQuery

+ func (f *DateFilter) OnOrAfter(date time.Time) *TaskQuery

+ func (f *DateFilter) OnOrBefore(date time.Time) *TaskQuery

+ func (f *DateFilter) Past() *TaskQuery

+ type Duration struct

+ func Days(n int) Duration

+ func Months(n int) Duration

+ func Weeks(n int) Duration

+ func Years(n int) Duration

+ func (d Duration) IsZero() bool

+ type JSONBuilder struct

+ func (b *JSONBuilder) AddProject(configure func(*JSONProjectBuilder)) *JSONBuilder

+ func (b *JSONBuilder) AddTodo(configure func(*JSONTodoBuilder)) *JSONBuilder

+ func (b *JSONBuilder) Build() (string, error)

+ func (b *JSONBuilder) Reveal(reveal bool) *JSONBuilder

+ type JSONItem struct

+ Attributes map[string]any

+ ID string

+ Operation JSONOperation

+ Type JSONItemType

+ type JSONItemType string

+ const JSONItemTypeProject

+ const JSONItemTypeTodo

+ type JSONOperation string

+ const JSONOperationCreate

+ const JSONOperationUpdate

+ type JSONProjectBuilder struct

+ func NewProject() *JSONProjectBuilder

+ func (p *JSONProjectBuilder) AddTags(tags ...string) *JSONProjectBuilder

+ func (p *JSONProjectBuilder) AppendNotes(notes string) *JSONProjectBuilder

+ func (p *JSONProjectBuilder) Area(name string) *JSONProjectBuilder

+ func (p *JSONProjectBuilder) AreaID(id string) *JSONProjectBuilder

+ func (p *JSONProjectBuilder) Canceled(canceled bool) *JSONProjectBuilder

+ func (p *JSONProjectBuilder) Completed(completed bool) *JSONProjectBuilder

+ func (p *JSONProjectBuilder) CompletionDate(date time.Time) *JSONProjectBuilder

+ func (p *JSONProjectBuilder) CreationDate(date time.Time) *JSONProjectBuilder

+ func (p *JSONProjectBuilder) Deadline(date string) *JSONProjectBuilder

+ func (p *JSONProjectBuilder) Notes(notes string) *JSONProjectBuilder

+ func (p *JSONProjectBuilder) PrependNotes(notes string) *JSONProjectBuilder

+ func (p *JSONProjectBuilder) Tags(tags ...string) *JSONProjectBuilder

+ func (p *JSONProjectBuilder) Title(title string) *JSONProjectBuilder

+ func (p *JSONProjectBuilder) Todos(items ...*JSONTodoBuilder) *JSONProjectBuilder

+ func (p *JSONProjectBuilder) When(when When) *JSONProjectBuilder

+ func (p *JSONProjectBuilder) WhenDate(year int, month time.Month, day int) *JSONProjectBuilder

+ type JSONTodoBuilder struct

+ func NewTodo() *JSONTodoBuilder

+ func (t *JSONTodoBuilder) AddTags(tags ...string) *JSONTodoBuilder

+ func (t *JSONTodoBuilder) AppendNotes(notes string) *JSONTodoBuilder

+ func (t *JSONTodoBuilder) Canceled(canceled bool) *JSONTodoBuilder

+ func (t *JSONTodoBuilder) ChecklistItems(items ...string) *JSONTodoBuilder

+ func (t *JSONTodoBuilder) Completed(completed bool) *JSONTodoBuilder

+ func (t *JSONTodoBuilder) CompletionDate(date time.Time) *JSONTodoBuilder

+ func (t *JSONTodoBuilder) CreationDate(date time.Time) *JSONTodoBuilder

+ func (t *JSONTodoBuilder) Deadline(date string) *JSONTodoBuilder

+ func (t *JSONTodoBuilder) Heading(name string) *JSONTodoBuilder

+ func (t *JSONTodoBuilder) List(name string) *JSONTodoBuilder

+ func (t *JSONTodoBuilder) ListID(id string) *JSONTodoBuilder

+ func (t *JSONTodoBuilder) Notes(notes string) *JSONTodoBuilder

+ func (t *JSONTodoBuilder) PrependNotes(notes string) *JSONTodoBuilder

+ func (t *JSONTodoBuilder) Tags(tags ...string) *JSONTodoBuilder

+ func (t *JSONTodoBuilder) Title(title string) *JSONTodoBuilder

+ func (t *JSONTodoBuilder) When(when When) *JSONTodoBuilder

+ func (t *JSONTodoBuilder) WhenDate(year int, month time.Month, day int) *JSONTodoBuilder

+ type ListID string

+ const ListAllProjects

+ const ListAnytime

+ const ListDeadlines

+ const ListInbox

+ const ListLogbook

+ const ListLoggedProjects

+ const ListRepeating

+ const ListSomeday

+ const ListToday

+ const ListTomorrow

+ const ListUpcoming

+ func (l ListID) String() string

+ type ProjectBuilder struct

+ func (b *ProjectBuilder) Area(name string) *ProjectBuilder

+ func (b *ProjectBuilder) AreaID(id string) *ProjectBuilder

+ func (b *ProjectBuilder) Build() (string, error)

+ func (b *ProjectBuilder) Canceled(canceled bool) *ProjectBuilder

+ func (b *ProjectBuilder) Completed(completed bool) *ProjectBuilder

+ func (b *ProjectBuilder) CompletionDate(date time.Time) *ProjectBuilder

+ func (b *ProjectBuilder) CreationDate(date time.Time) *ProjectBuilder

+ func (b *ProjectBuilder) Deadline(date string) *ProjectBuilder

+ func (b *ProjectBuilder) Notes(notes string) *ProjectBuilder

+ func (b *ProjectBuilder) Reveal(reveal bool) *ProjectBuilder

+ func (b *ProjectBuilder) Tags(tags ...string) *ProjectBuilder

+ func (b *ProjectBuilder) Title(title string) *ProjectBuilder

+ func (b *ProjectBuilder) Todos(titles ...string) *ProjectBuilder

+ func (b *ProjectBuilder) When(when When) *ProjectBuilder

+ func (b *ProjectBuilder) WhenDate(year int, month time.Month, day int) *ProjectBuilder

+ type Scheme struct

+ func NewScheme() *Scheme

+ func (s *Scheme) JSON() *JSONBuilder

+ func (s *Scheme) Project() *ProjectBuilder

+ func (s *Scheme) Search(query string) string

+ func (s *Scheme) Show() *ShowBuilder

+ func (s *Scheme) Todo() *TodoBuilder

+ func (s *Scheme) Version() string

+ func (s *Scheme) WithToken(token string) *AuthScheme

+ type ShowBuilder struct

+ func (b *ShowBuilder) Build() string

+ func (b *ShowBuilder) Filter(tags ...string) *ShowBuilder

+ func (b *ShowBuilder) ID(id string) *ShowBuilder

+ func (b *ShowBuilder) List(list ListID) *ShowBuilder

+ func (b *ShowBuilder) Query(query string) *ShowBuilder

+ type StartFilter struct

+ func (f *StartFilter) Anytime() *TaskQuery

+ func (f *StartFilter) Inbox() *TaskQuery

+ func (f *StartFilter) Someday() *TaskQuery

+ type StatusFilter struct

+ func (f *StatusFilter) Canceled() *TaskQuery

+ func (f *StatusFilter) Completed() *TaskQuery

+ func (f *StatusFilter) Incomplete() *TaskQuery

type TaskQuery

+ func (q *TaskQuery) CreatedWithin(d Duration) *TaskQuery

+ func (q *TaskQuery) Deadline() *DateFilter

+ func (q *TaskQuery) HasArea(has bool) *TaskQuery

+ func (q *TaskQuery) HasHeading(has bool) *TaskQuery

+ func (q *TaskQuery) HasProject(has bool) *TaskQuery

+ func (q *TaskQuery) HasTag(has bool) *TaskQuery

+ func (q *TaskQuery) InTag(title string) *TaskQuery

+ func (q *TaskQuery) Start() *StartFilter

+ func (q *TaskQuery) StartDate() *DateFilter

+ func (q *TaskQuery) Status() *StatusFilter

+ func (q *TaskQuery) StopDate() *DateFilter

+ func (q *TaskQuery) Type() *TypeFilter

+ type TodoBuilder struct

+ func (b *TodoBuilder) Build() (string, error)

+ func (b *TodoBuilder) Canceled(canceled bool) *TodoBuilder

+ func (b *TodoBuilder) ChecklistItems(items ...string) *TodoBuilder

+ func (b *TodoBuilder) Completed(completed bool) *TodoBuilder

+ func (b *TodoBuilder) CompletionDate(date time.Time) *TodoBuilder

+ func (b *TodoBuilder) CreationDate(date time.Time) *TodoBuilder

+ func (b *TodoBuilder) Deadline(date string) *TodoBuilder

+ func (b *TodoBuilder) Heading(name string) *TodoBuilder

+ func (b *TodoBuilder) HeadingID(id string) *TodoBuilder

+ func (b *TodoBuilder) List(name string) *TodoBuilder

+ func (b *TodoBuilder) ListID(id string) *TodoBuilder

+ func (b *TodoBuilder) Notes(notes string) *TodoBuilder

+ func (b *TodoBuilder) Reveal(reveal bool) *TodoBuilder

+ func (b *TodoBuilder) ShowQuickEntry(show bool) *TodoBuilder

+ func (b *TodoBuilder) Tags(tags ...string) *TodoBuilder

+ func (b *TodoBuilder) Title(title string) *TodoBuilder

+ func (b *TodoBuilder) Titles(titles ...string) *TodoBuilder

+ func (b *TodoBuilder) When(when When) *TodoBuilder

+ func (b *TodoBuilder) WhenDate(year int, month time.Month, day int) *TodoBuilder

+ type TypeFilter struct

+ func (f *TypeFilter) Heading() *TaskQuery

+ func (f *TypeFilter) Project() *TaskQuery

+ func (f *TypeFilter) Todo() *TaskQuery

+ type UpdateProjectBuilder struct

+ func (b *UpdateProjectBuilder) AddTags(tags ...string) *UpdateProjectBuilder

+ func (b *UpdateProjectBuilder) AppendNotes(notes string) *UpdateProjectBuilder

+ func (b *UpdateProjectBuilder) Area(name string) *UpdateProjectBuilder

+ func (b *UpdateProjectBuilder) AreaID(id string) *UpdateProjectBuilder

+ func (b *UpdateProjectBuilder) Build() (string, error)

+ func (b *UpdateProjectBuilder) Canceled(canceled bool) *UpdateProjectBuilder

+ func (b *UpdateProjectBuilder) ClearDeadline() *UpdateProjectBuilder

+ func (b *UpdateProjectBuilder) Completed(completed bool) *UpdateProjectBuilder

+ func (b *UpdateProjectBuilder) Deadline(date string) *UpdateProjectBuilder

+ func (b *UpdateProjectBuilder) Notes(notes string) *UpdateProjectBuilder

+ func (b *UpdateProjectBuilder) PrependNotes(notes string) *UpdateProjectBuilder

+ func (b *UpdateProjectBuilder) Reveal(reveal bool) *UpdateProjectBuilder

+ func (b *UpdateProjectBuilder) Tags(tags ...string) *UpdateProjectBuilder

+ func (b *UpdateProjectBuilder) Title(title string) *UpdateProjectBuilder

+ func (b *UpdateProjectBuilder) When(when When) *UpdateProjectBuilder

+ func (b *UpdateProjectBuilder) WhenDate(year int, month time.Month, day int) *UpdateProjectBuilder

+ type UpdateTodoBuilder struct

+ func (b *UpdateTodoBuilder) AddTags(tags ...string) *UpdateTodoBuilder

+ func (b *UpdateTodoBuilder) AppendChecklistItems(items ...string) *UpdateTodoBuilder

+ func (b *UpdateTodoBuilder) AppendNotes(notes string) *UpdateTodoBuilder

+ func (b *UpdateTodoBuilder) Build() (string, error)

+ func (b *UpdateTodoBuilder) Canceled(canceled bool) *UpdateTodoBuilder

+ func (b *UpdateTodoBuilder) ChecklistItems(items ...string) *UpdateTodoBuilder

+ func (b *UpdateTodoBuilder) ClearDeadline() *UpdateTodoBuilder

+ func (b *UpdateTodoBuilder) Completed(completed bool) *UpdateTodoBuilder

+ func (b *UpdateTodoBuilder) CompletionDate(date time.Time) *UpdateTodoBuilder

+ func (b *UpdateTodoBuilder) CreationDate(date time.Time) *UpdateTodoBuilder

+ func (b *UpdateTodoBuilder) Deadline(date string) *UpdateTodoBuilder

+ func (b *UpdateTodoBuilder) Duplicate(duplicate bool) *UpdateTodoBuilder

+ func (b *UpdateTodoBuilder) Heading(name string) *UpdateTodoBuilder

+ func (b *UpdateTodoBuilder) HeadingID(id string) *UpdateTodoBuilder

+ func (b *UpdateTodoBuilder) List(name string) *UpdateTodoBuilder

+ func (b *UpdateTodoBuilder) ListID(id string) *UpdateTodoBuilder

+ func (b *UpdateTodoBuilder) Notes(notes string) *UpdateTodoBuilder

+ func (b *UpdateTodoBuilder) PrependChecklistItems(items ...string) *UpdateTodoBuilder

+ func (b *UpdateTodoBuilder) PrependNotes(notes string) *UpdateTodoBuilder

+ func (b *UpdateTodoBuilder) Reveal(reveal bool) *UpdateTodoBuilder

+ func (b *UpdateTodoBuilder) Tags(tags ...string) *UpdateTodoBuilder

+ func (b *UpdateTodoBuilder) Title(title string) *UpdateTodoBuilder

+ func (b *UpdateTodoBuilder) When(when When) *UpdateTodoBuilder

+ func (b *UpdateTodoBuilder) WhenDate(year int, month time.Month, day int) *UpdateTodoBuilder

+ type When string

+ const WhenAnytime

+ const WhenEvening

+ const WhenSomeday

+ const WhenToday

+ const WhenTomorrow

+ func (w When) String() string

v0.1.0

Nov 30, 2025

Changes in this version

+ var ErrAreaNotFound = errors.New("things3: area not found")

+ var ErrAuthTokenNotFound = errors.New("things3: auth token not found")

+ var ErrDatabaseNotFound = errors.New("things3: database not found")

+ var ErrDatabaseVersionTooOld = errors.New("things3: database version too old (requires version > 21)")

+ var ErrInvalidParameter = errors.New("things3: invalid parameter")

+ var ErrTagNotFound = errors.New("things3: tag not found")

+ var ErrTaskNotFound = errors.New("things3: task not found")

+ type Area struct

+ Items []Task

+ Tags []string

+ Title string

+ Type string

+ UUID string

+ type AreaQuery struct

+ func (q *AreaQuery) All(ctx context.Context) ([]Area, error)

+ func (q *AreaQuery) Count(ctx context.Context) (int, error)

+ func (q *AreaQuery) First(ctx context.Context) (*Area, error)

+ func (q *AreaQuery) IncludeItems(include bool) *AreaQuery

+ func (q *AreaQuery) WithTag(tag any) *AreaQuery

+ func (q *AreaQuery) WithUUID(uuid string) *AreaQuery

+ type ChecklistItem struct

+ Created time.Time

+ Modified time.Time

+ Status string

+ StopDate *time.Time

+ Title string

+ Type string

+ UUID string

+ func (c *ChecklistItem) IsCanceled() bool

+ func (c *ChecklistItem) IsCompleted() bool

+ func (c *ChecklistItem) IsIncomplete() bool

+ type Client struct

+ func New(opts ...Option) (*Client, error)

+ func (c *Client) AddProjectURL(params map[string]string) string

+ func (c *Client) AddTodoURL(params map[string]string) string

+ func (c *Client) Anytime(ctx context.Context) ([]Task, error)

+ func (c *Client) Areas() *AreaQuery

+ func (c *Client) Canceled(ctx context.Context) ([]Task, error)

+ func (c *Client) ChecklistItems(ctx context.Context, todoUUID string) ([]ChecklistItem, error)

+ func (c *Client) Close() error

+ func (c *Client) Complete(ctx context.Context, uuid string) error

+ func (c *Client) Completed(ctx context.Context) ([]Task, error)

+ func (c *Client) Deadlines(ctx context.Context) ([]Task, error)

+ func (c *Client) Filepath() string

+ func (c *Client) Get(ctx context.Context, uuid string) (any, error)

+ func (c *Client) Inbox(ctx context.Context) ([]Task, error)

+ func (c *Client) Last(ctx context.Context, offset string) ([]Task, error)

+ func (c *Client) Link(uuid string) string

+ func (c *Client) Logbook(ctx context.Context) ([]Task, error)

+ func (c *Client) OpenSearch(ctx context.Context, query string) error

+ func (c *Client) Projects(ctx context.Context) ([]Task, error)

+ func (c *Client) Search(ctx context.Context, query string) ([]Task, error)

+ func (c *Client) SearchURL(query string) string

+ func (c *Client) Show(ctx context.Context, uuid string) error

+ func (c *Client) ShowURL(uuid string) string

+ func (c *Client) Someday(ctx context.Context) ([]Task, error)

+ func (c *Client) Tags() *TagQuery

+ func (c *Client) Tasks() *TaskQuery

+ func (c *Client) Today(ctx context.Context) ([]Task, error)

+ func (c *Client) Todos(ctx context.Context) ([]Task, error)

+ func (c *Client) Token(ctx context.Context) (string, error)

+ func (c *Client) Trash(ctx context.Context) ([]Task, error)

+ func (c *Client) URL(ctx context.Context, cmd URLCommand, params map[string]string) (string, error)

+ func (c *Client) Upcoming(ctx context.Context) ([]Task, error)

+ type Option func(*clientOptions)

+ func WithDatabasePath(path string) Option

+ func WithPrintSQL(enabled bool) Option

+ type StartBucket int

+ const StartAnytime

+ const StartInbox

+ const StartSomeday

+ func (s StartBucket) String() string

+ type Status int

+ const StatusCanceled

+ const StatusCompleted

+ const StatusIncomplete

+ func (s Status) IsClosed() bool

+ func (s Status) IsOpen() bool

+ func (s Status) String() string

+ type Tag struct

+ Items []any

+ Shortcut string

+ Title string

+ Type string

+ UUID string

+ type TagQuery struct

+ func (q *TagQuery) All(ctx context.Context) ([]Tag, error)

+ func (q *TagQuery) First(ctx context.Context) (*Tag, error)

+ func (q *TagQuery) IncludeItems(include bool) *TagQuery

+ func (q *TagQuery) WithTitle(title string) *TagQuery

+ type Task struct

+ AreaTitle *string

+ AreaUUID *string

+ Checklist []ChecklistItem

+ Created time.Time

+ Deadline *string

+ HeadingTitle *string

+ HeadingUUID *string

+ Index int

+ Items []Task

+ Modified time.Time

+ Notes string

+ ProjectTitle *string

+ ProjectUUID *string

+ ReminderTime *string

+ Start string

+ StartDate *string

+ Status Status

+ StopDate *time.Time

+ Tags []string

+ Title string

+ TodayIndex int

+ Trashed bool

+ Type TaskType

+ UUID string

+ func (t *Task) HasChecklist() bool

+ func (t *Task) HasTags() bool

+ func (t *Task) IsCanceled() bool

+ func (t *Task) IsCompleted() bool

+ func (t *Task) IsHeading() bool

+ func (t *Task) IsIncomplete() bool

+ func (t *Task) IsProject() bool

+ func (t *Task) IsTodo() bool

+ type TaskQuery struct

+ func (q *TaskQuery) All(ctx context.Context) ([]Task, error)

+ func (q *TaskQuery) ContextTrashed(trashed bool) *TaskQuery

+ func (q *TaskQuery) Count(ctx context.Context) (int, error)

+ func (q *TaskQuery) First(ctx context.Context) (*Task, error)

+ func (q *TaskQuery) InArea(area any) *TaskQuery

+ func (q *TaskQuery) InHeading(heading any) *TaskQuery

+ func (q *TaskQuery) InProject(project any) *TaskQuery

+ func (q *TaskQuery) IncludeItems(include bool) *TaskQuery

+ func (q *TaskQuery) Last(offset string) *TaskQuery

+ func (q *TaskQuery) OrderByTodayIndex() *TaskQuery

+ func (q *TaskQuery) Search(query string) *TaskQuery

+ func (q *TaskQuery) Trashed(trashed bool) *TaskQuery

+ func (q *TaskQuery) WithDeadline(deadline any) *TaskQuery

+ func (q *TaskQuery) WithDeadlineSuppressed(suppressed bool) *TaskQuery

+ func (q *TaskQuery) WithStart(s StartBucket) *TaskQuery

+ func (q *TaskQuery) WithStartDate(date any) *TaskQuery

+ func (q *TaskQuery) WithStatus(s Status) *TaskQuery

+ func (q *TaskQuery) WithStopDate(date any) *TaskQuery

+ func (q *TaskQuery) WithTag(tag any) *TaskQuery

+ func (q *TaskQuery) WithType(t TaskType) *TaskQuery

+ func (q *TaskQuery) WithUUID(uuid string) *TaskQuery

+ type TaskType int

+ const TaskTypeHeading

+ const TaskTypeProject

+ const TaskTypeTodo

+ func (t TaskType) String() string

+ type URLCommand string

+ const URLCommandAdd

+ const URLCommandAddProject

+ const URLCommandSearch

+ const URLCommandShow

+ const URLCommandUpdate

+ const URLCommandUpdateProject

+ func (u URLCommand) String() string

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL