Blinko

Use Blinko as the single source of truth for notes.

Setup (one-time)

Env vars (Gateway env is OK):

• BLINKO_API_KEY (required)


• BLINKO_BASE_URL (optional; default ) ## Core workflow ### 1) Create a note When user says something like: - “blinko: …” - “note: …” Create a note with: - Markdown body - Add tags as hashtags at the end (respect the user’s taxonomy constraints) ### 2) List/search notes If the user asks “liste mes notes” or “cherche …”, call the list endpoint and show: - id - first line/title - top tags (if present) ### 3) Tagging rules (user constraints) - Max **7** top-level tags. - For each note: choose **1** top-level tag + **0–2** sub-tags max. - Sub-tag syntax: #Tech/dev. ### 4) Destructive actions (delete/purge) Always confirm explicitly ("OK vas-y") before: - deleting notes - deleting tags Use the helper script for batch operations. ## Helper script scripts/blinko.py wraps the API. Examples: __CODE_BLOCK_0__ ## Reference See references/blinko_api.md` for endpoint cheat sheet.

Github