Protocol Launcher

Focus ​

Focus is a productivity and Pomodoro timer app. Protocol Launcher allows you to generate deep links to add and delete tasks, start timers, and pause the current timer in Focus.

Usage ​

There are two ways to use this library:

  • On-Demand import from subpaths enables tree-shaking and keeps bundles small.
  • Full Import from the root package is convenient but includes all app modules.

Pick On-Demand for production builds; Full Import is fine for quick scripts or demos.

Select Installation Method

On-Demand
Recommended. Optimized for production.
Full Import
Convenient. Good for quick scripts.

Add Task ​

On-Demand
ts
import { addTask } from 'protocol-launcher/focus'

const url = addTask({
  title: 'Read chapter 3',
})
Add Task

Add Task with Estimate ​

On-Demand
ts
import { addTask } from 'protocol-launcher/focus'

const url = addTask({
  title: 'Prepare Presentation',
  note: 'Referecene mail notes',
  sessionEstimate: 8,
  due: 'monday',
})
Add Estimated Task

Add Task with Minutes Estimate ​

On-Demand
ts
import { addTask } from 'protocol-launcher/focus'

const url = addTask({
  title: 'Study documentation',
  note: 'make notes',
  minutesEstimate: 120,
  due: 'tomorrow',
})
Add Task with Minutes

Delete Task ​

On-Demand
ts
import { deleteTask } from 'protocol-launcher/focus'

const url = deleteTask({
  id: 'B1127BC6-3CC3-4AC4-B561-3CD493D2EDD6',
})

Focus also supports deleting multiple tasks with a single ids string separated by ?.

On-Demand
ts
import { deleteTask } from 'protocol-launcher/focus'

const url = deleteTask({
  ids: 'B1127BC6-3CC3-4AC4-B561-3CD493D2EDD6?U36SAM-3CD3-1BC4-B481-2CD590D2EDD2',
})

Start Timer ​

On-Demand
ts
import { startTimer } from 'protocol-launcher/focus'

const url = startTimer()
Start Timer

Start Timer with Duration ​

On-Demand
ts
import { startTimer } from 'protocol-launcher/focus'

const url = startTimer({
  type: 'focus',
  duration: 40,
})
Start Focus Timer

Pause Timer ​

On-Demand
ts
import { pauseTimer } from 'protocol-launcher/focus'

const url = pauseTimer()
Pause Timer

x-callback-url ​

Focus supports x-success and x-error callback parameters on every command. The add command returns the new task id as id on the x-success callback.

On-Demand
ts
import { addTask } from 'protocol-launcher/focus'

const url = addTask({
  title: 'Read chapter 3',
  xSuccess: 'shortcuts://x-callback-url/run-shortcut?name=Focus Added',
  xError: 'shortcuts://x-callback-url/run-shortcut?name=Focus Error',
})