README file from
GithubParanoid Tasks
About
Paranoid Tasks is a Kanban task board for Obsidian. All tasks live in a single Markdown note (Tasks/Main.md by default): each column is a section and each task is a list item, so the list stays readable and editable without the plugin.
The goal is a simple task tracker with the widest possible customization in settings: almost every feature can be tuned or turned off, so the board does only what you need.
What it can do:
- Columns you define, with drag-and-drop for tasks and columns, collapsing and task counts.
- Priorities with your own names, symbols and colors.
- Deadlines, optionally raising a task's priority as the deadline approaches.
- Recurring tasks with a checkbox that clears itself every hour, day, week, month or year (optionally at a set time).
- A linked details note for any task.
- Archive: archived tasks stay in the file until you clear them.
- English, Russian, German, French and Spanish interface.
A task in the task file looks like this:
## Open
- [Priority: High] [Deadline: 2026-10-30] [Details: [[Report]]] Prepare the report
- [Repeat: daily 09:00] Morning exercise
Installation
From Obsidian
Once the plugin is available in the community plugin directory: Settings → Community plugins → Browse, search for Paranoid Tasks, install and enable it.
Until then (or to get updates right after release), you can install it with the BRAT plugin, including on mobile: add the repository ParanoidMann/Paranoid-Tasks in BRAT.
From source
1. Requirements
- Obsidian. The vault must have been opened in it at least once (so that the
.obsidianfolder exists). - Node.js 20 or newer (comes with
npm). Check withnode -v. - Git, if you download with
git clone(a ZIP archive from GitHub also works).
2. Download and build
git clone https://github.com/ParanoidMann/Paranoid-Tasks.git
cd Paranoid-Tasks
npm ci
npm run build
If you downloaded a ZIP, unpack it and run npm ci and npm run build in the unpacked folder.
The build creates main.js. Together with manifest.json and styles.css, this is the plugin.
3. Install into a vault
The vault path is the folder you chose when creating or opening the vault in Obsidian (it contains the hidden .obsidian folder).
npm run install-plugin -- "<path to vault>"
This copies main.js, manifest.json and styles.css to <vault>/.obsidian/plugins/paranoid-tasks/. You can also copy them there by hand.
4. Enable in Obsidian
- Restart Obsidian (or Ctrl+P → Reload app without saving).
- Open Settings → Community plugins. If Restricted mode is on, click Turn on community plugins.
- Enable Paranoid Tasks in the list of installed plugins.
- Click the board icon in the left ribbon. The task file
Tasks/Main.mdis created in the vault.
Updating
git pull
npm ci
npm run build
npm run install-plugin -- "<path to vault>"
Then restart Obsidian (or turn the plugin off and on in settings).
Phone / tablet
The plugin cannot be built on mobile devices. Build it on a computer and copy the three files (main.js, manifest.json, styles.css) to <vault>/.obsidian/plugins/paranoid-tasks/ on the device, by hand or through vault sync (Obsidian Sync, iCloud, Syncthing, etc.; in Obsidian Sync, "Installed community plugins" sync must be on). Then enable the plugin as in step 4.