Obsidian Tasks, Dataview and nokko's files

- [ ] Order samples [Budget:: 900] [est:: 3h] 🎯 ⏫ 🔁 every week 🛫 2026-08-01 ⏳ 2026-08-04 📅 2026-08-14 #fitout

Most of that is optional: - [ ] Order samples is a complete task. A board is a file with type: project in its frontmatter, ## headings are its groups, and an indented task is a subtask.

Order matters. nokko and the Tasks plugin both read marks from the end of the line. Both stop at the first thing they do not know. So keep [Name:: value] fields to the left of the emoji. nokko writes them in that order: text, fields, 🎯, 🆔, ⛔, priority, 🔁, 🏁, ➕, 🛫, ⏳, 📅, ❌, ✅, then a block link.

The checkbox holds the status: [ ] open, [/] in progress, [>] waiting, [x] or [X] done, [-] cancelled. Any other single character is kept as written and counts as open. What the Tasks plugin calls /, - and > depends on your settings in that plugin. A symbol it does not know counts as TODO.

nokko reads the bracket form only, so (key:: value) is plain text to it. It will not create a column named est, status, type, or any field name the Tasks plugin's Dataview format owns: due, start, scheduled, created, completion, cancelled, priority, repeat, id, dependsOn, onCompletion. If a file already has one, nokko keeps it and warns.

One limit from Dataview: it refuses a field name containing brackets. So the [Logged (ClickUp):: 1h30m] column from a ClickUp import works in nokko but is invisible to Dataview.

Paste this into any note in the vault. It lists what is due today or overdue in one folder, grouped by board. Change Client work/ to your own folder.

```tasks
not done
due on or before today
path includes Client work/
sort by due
group by filename
```

If nokko's tasks do not appear, look at the Global Filter in the Tasks plugin's settings. With a filter set, Tasks only counts lines that contain it. nokko has no such filter and does not add that text to the tasks it writes.

```dataview
TASK
FROM "Client work"
WHERE !completed AND status != "-" AND due AND due <= date(today) + dur(7 days)
SORT due ASC
```

```dataview
TABLE WITHOUT ID T.text AS "Task", T.est AS "Estimate", T.Budget AS "Budget"
FROM "Client work"
FLATTEN file.tasks AS T
WHERE !T.completed AND T.status != "-" AND T.est
```

Dataview reads the date emoji as due, scheduled, start, created and completion. It does not read priorities or repeats, and its text field includes the raw marks. To query hours, see Query them with Dataview.

An edit changes only the characters it has to. Move a due date and that one date changes in the file. Your prose, links, blank lines, indentation and any mark nokko does not recognise stay byte for byte.

nokko does not read or change .obsidian, your plugins or your themes. It adds one hidden folder, .nokko, at the top of the workspace for its index and view settings.

1. 1Choose Workspace ▸ Open Workspace…. On first launch the button is Open an Existing Folder….
2. 2Pick the vault folder. Obsidian can stay open on it.
3. 3Open Inbox. Tasks in notes that are not boards yet are listed there, grouped by file.
4. 4Use Make Project on a file's group to turn that note into a board.

Make Project adds type: project to the file's frontmatter, and ⌘Z removes it. Nothing else changes in your notes. A file with no type and no tasks lists as a doc. A file with a type nokko does not know is left as it is, though its tasks still count.

The vault opens, and nokko warns you once for that vault on each Mac. The same warning covers iCloud Drive, Dropbox, Google Drive, OneDrive and other cloud folders. Those services can replace a file underneath nokko or leave a placeholder where a file was. Their conflict copies also appear as extra boards.

The safest setup is a vault in an ordinary local folder, with nokko's own sync carrying it between devices. If you use Obsidian Sync today, read sync without Obsidian Sync.

Sync carries your Markdown, not the whole vault. It copies every .md file, plus png, jpg, jpeg, tiff, heic and pdf files inside People/ and Invoices/.

It does not copy .obsidian, dot-folders or attachments anywhere else. An image in your vault's attachments folder stays on the Mac it is on, so it will be missing on another device. Keep Obsidian's own settings and attachments in step some other way if you need them there.