ObsiKO ObsiKO Docs

Routines β€” the same chores, in one press πŸ”

Every time you finish a piece: tidy the formatting, fix the symbols, add a tag, flip the status to done… the same order, every time?
A routine bundles those three or four steps so one press finishes them.

← Home: ObsiKO 101


1️⃣ What is a routine? πŸ€”

A routine is a list of steps. That's all it is!

β‘  Tidy formatting  β†’  β‘‘ Fix symbols  β†’  β‘’ Add a tag (done)  β†’  β‘£ Set a property (status = done)

They run in that order, one after another. Nothing to learn, nothing to memorise. 😊

πŸ’‘ It isn't a macro language. There are no conditions and no loops.
No "if this, then that" β€” it simply runs exactly the order you wrote down.


2️⃣ Your first routine in 3 minutes ✨

Open Routines in the right-hand panel. (the right sidebar icon row, or the command palette ⌘P β†’ Routines)

✨ Before you build one, try what's already there.
The Example routines section at the bottom of the panel ships with five: Polish this note Β· Log to today's note Β· New meeting note Β· Start a focus session Β· Start next episode.
Press one to run it as is, and if you like it, use the copy button on the right to make it yours.
(Examples create no files in your vault. Copy one and press Save to turn it into your own.)

  1. Press the + next to a group name. (Or + New routine in the list, if you have none yet.)
  2. Give it a Routine name. (e.g. Wrap up a chapter) Press the box in front of the name to pick an emoji β€” it makes the routine easy to spot in the list.
  3. Which note β€” pick the target. The note you're viewing is usually all you need.
  4. Press + Add a step and pick what you want done. Stack up to nine of them.
  5. Save!

The routine editor β€” one target and four steps
β–² Which note Β· what to do Β· in what order. Pick from the lists and the routine is done.

Now just press the routine in the list. πŸŽ‰

The β–Ά at the right end means "press to run". Anywhere on the row works.

As they pile up β€” group them πŸ—‚οΈ

More routines, longer list. Collapsible groups let you keep open only what you're using.

A group travels with the routine in your vault, so other devices on the same vault see it too.
(Different vaults never mix. Only an empty group β€” one with no routines yet β€” stays on that device.)


3️⃣ Where can I run it? πŸš€

Do this And it runs
Press it in the list in the Routines panel the usual way
Command palette ⌘P β†’ Routine: name without leaving the keyboard
Right-click in the note β†’ Routines β–Έ mid-writing (⭐ favorites only)
The starter row on the welcome screen right after opening a vault

⭐ Mark a routine as a Favorite and it moves to the top of the list β€” and shows up in the right-click menu and the welcome screen.

The Routines panel β€” favorites on top, β–Ά at the right end
β–² Each row summarises its steps. Press β–Ά and they run in that order.

The right-click menu only lists routines that target the note you're viewing.
Right-clicking in a note means "do this to this document", so a routine that creates a new note there would quietly edit the wrong file. πŸ˜‰


4️⃣ Which note? β€” picking the target 🎯

A routine edits exactly one note. It's fixed the moment you press Run, and opening another note halfway through won't touch it.

Target What it means
The note you're viewing the one that's open (what you'll use most)
Today's note today's dated note β€” created first if it isn't there β†’ 13 Calendar
A note you choose always the same note (e.g. Work/Journal.md); start typing and pick it from the list
Start in a new note makes a fresh note each run and works in that one

5️⃣ What can it do? 🧰

Steps are grouped by what they're for β€” just pick.

✏️ Polish the writing

Step What it does
Tidy formatting safe cleanup of blank lines, headings, property lines
Fix symbols ...→…, straight quotesβ†’curly, ->β†’β†’
Tidy punctuation !!!β†’!, spacing around punctuation
Replace a word find β†’ replace (leave it empty to delete)
Remove bold, italic, highlight strips the decoration, keeps the words
Remove Markdown syntax (text only) plain text, all the way
Remove frontmatter (properties) the whole property block at the top
Remove comments %%notes%% and <!-- -->
Indent paragraphs / Remove indents first-line indents
Blank line between paragraphs one empty line between paragraphs

πŸ“ Add content

Set a property Β· Add a tag / Remove a tag Β· Add to the top Β· Add to the end Β· Insert a template Β· Add under a heading Β· Set note colour Β· Mark as verified

βœ… Tasks

Move done tasks down Β· Clear done checkmarks

🎭 Story

Remove character tags Β· Remove background tags β€” strips the <<name:image>> tokens the story views use β†’ 18-3 Messenger & Visual Novel Views

πŸ”– Mark & check

Bookmark Β· Spell check (underline only) Β· Spacing check (underline only) β†’ 06 Korean Writing Tools

πŸ… Focus

Start focus timer Β· Start character counter β†’ 14 Focus Timer (Pomodoro) ⏱

The two checks only underline β€” they never edit your words. Whether to accept a suggestion is your call.
(The spacing check is desktop-only.)


6️⃣ Ask me when it runs πŸ’¬

Small chips under a value field insert auto-fill expressions.

Chip Inserts What happens
Ask when it runs {{ask:question}} a prompt appears the moment you run it
Use the run date {{date}} that day's date goes in

So if the text field of Add to the end says:

## {{date}} progress
{{ask:What did you get done today?}}

…every run asks you, and the answer lands under today's date. πŸ“…

Several questions are asked on one form, together. Cancel and nothing is edited at all.


7️⃣ Writing a series? β€” automatic numbering πŸ“š

Press the {n} button to the right of the title field in Start in a new note. No syntax to
memorise β€” pick what you see and it goes in at the cursor.

Pick this And you get
1, 2, 3 Ch. 1 β†’ Ch. 2 β†’ Ch. 3 …
01, 02, 03 01 Part β†’ 02 Part … (padded to width)
001, 002, 003 001 β†’ 002 …

Put text around it however you like (Episode {n}), and (n), [n] and <n> all work the same
β€” use whichever bracket is easiest to type. πŸ˜‰

Want to start at 51? β€” Start at πŸ”’

Moved a series over after 50 chapters elsewhere? Put 51 in Start at, right under the title.

See it before you press πŸ‘€

Under the title you get Run now β†’ Ch. 51.md β€” and why that number.

2 matching in this folder Β· highest number 52, for example.
Nothing matching means the prefix or suffix differs, so nothing was counted (Side story 3 is not a Ch. {n}).

Meeting (n th) and the like are left as plain text β€” only brackets holding nothing but n count as a token.

When you use several devices πŸ“±πŸ’»

If the same vault is open on more than one device, this device may not have seen an episode the other
one just made (sync may have only finished a moment ago, or the folder listing may still be arriving).


8️⃣ Why it's safe to lean on πŸ›‘οΈ

The promise What it means
You always press Run there is no scheduled or automatic run
One note only it never edits several notes at once
Everything is checked first if a single step can't run, it doesn't start at all β€” no half-applied note
Undo in one go ten steps still land as one entry in change history; revert it and you're back
Safe to run again tags and text that are already there are skipped
Stop mid-run press "stop after this step" while it's running

⚠️ Three exceptions do add again on a second run β€” Insert a template, Replace a word, and Start in a new note.
Those steps carry a note in the panel, so it won't surprise you. 😊


9️⃣ What it won't do (honestly) πŸ™…

None of this is missing by accident β€” it's left out on purpose, so an unrecoverable accident has nowhere to start. πŸ™‚


πŸ”Ÿ Share one, receive one πŸ“€πŸ“₯

Routines live in your vault at .obsiko/routines/, one file each. Devices sharing that vault pick them up on their own. ☁️


1️⃣1️⃣ Ask the AI to build one πŸ€–

"Make me a routine that tidies formatting and adds a tag when I wrap up for the day"

The AI will build and save it for you. β†’ 16 AI Agent


1️⃣2️⃣ Recipes 🍳

Wrap up a chapter

The note you're viewing β†’ Tidy formatting β†’ Fix symbols β†’ Add a tag (done) β†’ Set a property (status = done)

Start a new chapter

Start in a new note (Ch. {n}, folder Series) β†’ Insert a template β†’ Start focus timer β†’ Start character counter

Open today's journal

Today's note β†’ Insert a template β†’ Add to the end ({{ask:What's today's goal?}}) β†’ Start focus timer

Finish meeting notes

The note you're viewing β†’ Move done tasks down β†’ Add under a heading (Decisions) β†’ Bookmark

Pre-revision check

The note you're viewing β†’ Tidy punctuation β†’ Spell check (underline only) β†’ Spacing check (underline only)

Make plain text to paste elsewhere

A note you choose β†’ Remove Markdown syntax β†’ Remove frontmatter (properties) β†’ Remove comments


❓ Common questions

Q. It ran but said "the note is unchanged".
A. Every step you used was one that doesn't edit text β€” a check, a bookmark, a timer. That's normal! 😊

Q. What about "there was nothing to change"?
A. It was already tidy and already tagged, so there was nothing left to do. That's proof it's safe to run again.

Q. It won't start at all.
A. The pre-run check found a step it can't do. It tells you which step and why, so fix that one field.

Q. I ran the wrong one! 😱
A. Revert that single entry in change history. However many steps ran, one revert takes you back.

Q. Can it run automatically every day?
A. Deliberately not. Your notes shouldn't change while you're not looking. Mark it ⭐ Favorite instead β€” it's one press away from the welcome screen and the right-click menu.


← Previous: Review & Rediscovery Β· Home Β· Next: AI Agent β†’