The Taskie desktop app

The Taskie desktop app brings two experiences together: the main window, which opens the full version of Taskie (projects, tasks, documents, dashboards and settings), and a small quick-add window you can reach with one key from any app. The app can wait in the menu bar or system tray, hold on to tasks you capture offline and keep working without a browser open.

The whole panel in a standalone app: The main window loads the same complete, up-to-date Taskie product from your server, so workspace features and permissions stay the same as on the web. Native tools such as the menu bar/tray icon, shortcuts, the offline queue and notifications sit alongside it.

Download and install

1. Go to the Download page.
2. Choose the version for your operating system: Mac (Apple Silicon), Mac (Intel), Windows or Linux (AppImage).
3. Install the downloaded file like any other app.
4. After installation, the Taskie main window opens, and the app icon also stays in the system menu bar or tray (at the top of the screen on Mac, next to the clock on Windows and Linux).

If your operating system shows a warning: The current version isn't signed with an official Apple or Microsoft certificate yet. On Mac, right-click the file and choose "Open". On Windows, in the SmartScreen message, click "More info" and then "Run anyway". You only need to do this the first time.

Signing in to your account

The first time, sign in to Taskie as usual inside the main window. Two-factor authentication, passkeys and company SSO work just like on the web. If you also want to use quick add, click "Connect quick add" in settings. The authorization page opens in the main window using your signed-in session, and the app connects to your account with PKCE.

• The panel uses your secure web session: your password and second factor are only exchanged with your Taskie domain, and the remote window has no access to the system's native commands.
• Quick add has its own authorization: the API token is stored only in the operating system's secure store (Keychain on Mac, Credential Manager on Windows), never in a settings file or the app window.
• It stays signed in: you sign in once and the app stays signed in, unless you sign out or revoke this device's access.
• Self-hosted installations: enter your server's HTTPS address in the "Server" section. Newer versions of Taskie announce the desktop OAuth public client ID automatically; for older versions you can enter the output of php artisan api:client desktop manually.

Global shortcuts

The app has two separate shortcuts: Ctrl/Cmd+Alt+Space opens the quick-add window, and Ctrl/Cmd+Alt+T shows or hides the main window. Both work from your browser, email, text editor and other apps.

1. Open "Settings…" from the menu bar/tray menu.
2. In the "Global shortcuts" section, type the combination you want for quick add or the main panel, or pick one of the ready-made options.
3. Click "Save". The two shortcuts must be different.
4. Click "Test" and press the same combination. If no event is received or saving fails, another app has taken that key, and you need to choose a different combination.

Linux users on a Wayland session: The current plugin can't register global shortcuts. In the shortcut settings of GNOME, KDE or your desktop environment, register taskie-desktop --capture for quick add and taskie-desktop for the main panel.

Working with the main panel

Launching the app normally opens the full Taskie panel. By default, closing the window doesn't quit the app: the panel is hidden, and the menu bar/tray icon and quick add stay active. On Mac and Windows, left-click the icon, and on Linux choose "Open Taskie" from the menu, to bring back the page that was open. The panel shortcut does the same.

• The same data and permissions: because the main panel loads directly from your Taskie installation, shared projects, plans, permissions and real-time behavior are the same as on the web.
• Quick routes: from the "Go To" submenu you can open Dashboard, My Tasks, My Day, Inbox, Documents or Files directly, and use "Reload Panel" to reload the panel.
• Configurable behavior: control closing to the menu bar/tray, starting in the background, always-on-top windows and native notifications in the desktop settings.

Capturing a task

The quick-add window has just one text box asking what needs to be done. Type the sentence you have in mind and press Enter. The task is created, a summary of the result is shown for a moment and the window closes.

Writing the way you always do

What you type is read with the same rules as the web version and the messenger bots, so there's nothing new to learn:

• @ for a project: typing @ opens a list of your projects so you can pick one.
• # for a label: typing # suggests the workspace's labels.
• ! for priority: for example, !urgent or !high.
• Plain-language dates: phrases such as "tomorrow at 5pm", "Saturday" or "in 3 days" are recognized and set on the task. Date phrases work in both supported interface languages.
• All together: a single line such as Call Mr. Rezaei tomorrow at 10am @Marketing #call !high does all of this at once.

After you submit, a summary of the created task is shown, and the items that were actually recognized (project, label, priority) are highlighted in bold. If a label isn't bold, it didn't match any existing label and stayed in the title as plain text.

Picking with buttons instead of typing

Below the text box are a few small buttons that do the same things without typing: pick a project, label, priority and date. For dates, the ready-made options Today, Tomorrow, Weekend and Next week are available.

Keyboard shortcuts in the window

• Enter: submit the task and close the window.
• Cmd/Ctrl + Enter: submit the task and keep the window open, for when you have several items in mind in a row.
• Esc: close the window. If a suggestion list is open, the first Esc only closes that list so you don't lose what you've typed.
• Cmd/Ctrl + ,: open settings.
• Cmd/Ctrl + R: refresh the list of projects and labels.
• Pin: with the pin button, the window doesn't close when you click outside it, for when you need to copy something from somewhere else.

When you're offline

If there's no connection when you submit, or your session has ended, the task isn't lost: it stays in a queue on this device, and the message "Offline — queued" is shown. As soon as the connection is back or you sign in again, the items for that same server and account are sent in order, exactly once. Queues for other accounts and servers are never mixed with the current account.

• The count is always visible: the number of pending items appears both at the bottom of the quick-add window and in the menu bar/tray menu.
• Automatic retries: sending is retried at increasing intervals until it succeeds.
• Nothing is deleted on its own: if the server rejects an entry, it stays in the "Failed captures" section of settings so you can decide what to do. Only you can delete it.

App settings

Open the settings window from the "Settings…" option in the menu bar/tray menu or with Cmd/Ctrl + ,. Its sections are:

• Main panel: open Taskie, My tasks and My day, or reload the panel.
• Taskie account: securely connect quick add, see the connected account and sign out of the API.
• Global shortcuts: change and test the separate shortcuts for quick add and the main panel.
• Desktop behavior: closing to the menu bar/tray, starting in the background, always-on-top windows and native notifications.
• Launch at startup: run Taskie in the menu bar/tray when your computer starts, without an initial window getting in your way.
• Server: test and choose your Taskie installation. The secure sign-in ID is usually detected automatically.
• Failed captures: entries the server rejected, ready to retry or delete.

The menu bar/tray menu

The desktop app's own windows use Taskie's own interface, while the operating system's native menus intentionally use standard English labels. On Mac, the menu bar at the top of the screen also has the full Taskie, File, Edit, Go, View, Window and Help menus.

• Open Taskie: show the panel without changing the page that was open.
• New Task and New Document: open the main panel and go straight to the matching tab in Quick Add.
• Quick Capture: does the same thing as the global quick-add shortcut.
• Go To: go directly to Dashboard, My Tasks, My Day, Inbox, Documents or Files.
• Pending Sync: shows the number of queued items in Latin digits. When something is queued, choosing it opens settings.
• Settings… and Reload Panel: open the desktop settings or refresh the main window.
• Help: open the Taskie help center or submit a support request.
• Quit Taskie: quit the app completely.

Getting new versions

Automatic updates are turned off in this version. Download new versions only from the official download page and install them over the current version. On Linux, if you installed the app from a system package, install the new version with the same package manager.

Managing devices

Every computer you sign in with is added to your account's list of connected devices. If you hand over or lose a computer, revoke its access from Connected devices.

Frequently asked questions

• Do I need a specific plan to use it? No, the desktop app is available for all accounts.
• Why isn't the default shortcut Cmd+Shift+Space? On Mac, that key is reserved for switching the keyboard input language and causes conflicts on systems set up with more than one keyboard input language.
• Which project does the task I capture go into? If you don't pick a project or set one with @, the task is saved without a project and you can move it later.
• Can I write a long description too? The quick-add window is intentionally a single line so it stays fast. For descriptions, attachments or subtasks, open the main panel inside the same app.