Docs

Getting started

Signing up takes an email and a password, nothing else. Want a look first — use the demo: demo@example.com / tyama, which comes with notes waiting in the inbox, folders, tags and a board.

The app has five screens: Inbox (where everything new lands), Tasks (the board of days), Notes (search, list, tiles, graph), Chat and Achievements (how much is already done). On a desktop they sit in the sidebar with the folders and tags underneath, following you across every screen; Settings and logging out live behind the «More» («…») button at the end of the navigation — they are opened a few times a year and do not deserve a permanent slot beside the daily things. On a phone the same five sections are labelled tabs on the bottom bar (with the unsorted count next to «Inbox»), and the folders and tags live in the «Sections» drawer that slides in from the left: the ☰ in the header of any screen opens it, as does a tap on the folder path above the notes list or a second tap on the already active «Notes» tab. On a phone, Settings and «Log out» sit at the foot of that drawer.

Tyama is a web app, but a browser will happily install it as a normal one: «Add to Home Screen» on a phone, or the install icon in the address bar on a desktop.

Quick capture and the inbox

The capture field is the first thing on the home screen. Write a line, a paragraph or a whole chunk of text and press «Save». The note gets the «inbox» status and stays there until it is sorted — the number next to «Inbox» in the navigation counts exactly those.

On a phone the capture field is docked at the bottom of the screen, right above the bar — where the thumb already is — and rises with the keyboard: the queue scrolls above it and the field never goes anywhere.

No title, no folder, no tags to fill in: that is the whole point. With images enabled you can attach a photo right away (up to 8 MB, images only).

Dictation. The microphone button in the capture field listens and writes what you say into the field; while it is red and pulsing the mic is on, and the grey italic line under the field shows the phrase still being recognized. Press again to stop; after a few silent pauses in a row the mic switches itself off. A dictated note lands in the inbox like any other, but marked: when you press «Sort», the AI knows it is recognized speech — one long line without punctuation — and restores sentences, paragraphs and lists, drops the «um»s and repeats, and proposes a title, folder and tags. Dictating never calls the AI by itself, and as with any plan, nothing is applied until you accept it. The language the mic listens for is chosen in Settings («Dictation language», per device). The browser itself does the recognition — in Chrome that is a Google service; Tyama only ever receives the finished text. Firefox has no speech recognition, so there is no button there.

A note created on the «Notes» screen with «New note» (on a phone, the floating «+» in the lower right corner) never joins the inbox — you made it deliberately and already know where it belongs. The same goes for a task written on the board.

AI sorting

The inbox is a queue: one proposal is open in full, and everything else — the other plans and the notes not looked at yet — sits under it as single lines. Accept or reject and the next card steps into focus by itself; tapping a line in the queue brings that one up. A line with no plan carries a ✦ button (on a phone, a labelled «Sort» button) — sort just this note. On a phone a ready plan opens full screen — «Review»: «1 of N», arrows between plans, and «Accept · Refine · Reject» pinned at the bottom at one height; accept and the next plan takes the same place, the back gesture returns to the queue. An accept can be undone from the toast at the top.

«Sort everything» sits in the header of the screen; on a phone it is a full-width row above the queue. It hands the unsorted notes to the model, and each one comes back as a proposal card. Up to ten notes are sorted per run — the rest wait for the next press (the number skipped is written under the button). A single note can be sorted from its own page (on a phone, the ✦ icon in the note header).

What the card shows:

Title

Short and human, not just the first line of the text.

Folder

As a full path, «Work/Projects». It says whether the folder is new — if it is, accepting creates it, along with every level of the path.

Tags

Existing or new; new ones are created on accept.

Summary

A line or two on what the note is about.

Reasoning and confidence

Why this folder and these tags, and how sure the model is. Low confidence is a reason to look closer, not a reason to reject.

Tidied text

Sometimes the proposal carries a cleaner version of the text — typos and formatting fixed, meaning untouched.

Merging

If the note is one more entry for a collection note («another quote» for «Quotes»), the proposal offers to append it there — written the way the existing entries are: same list marker, same order of fields. The original is not lost: it is soft-deleted and stays in the database.

Three actions: accept (one click applies everything above), refine (say in one line what is off — «this is not work, it is home» — and the plan is redone with your words in mind) or reject (the note stays in the inbox).

A batch is reviewed from the keyboard. The queue has a cursor: j / k (or the arrows) walk the cards, Enter accepts, E opens the refine box, Backspace rejects. The active card is highlighted and scrolls itself into view. When every plan looks right, «Accept all» takes the whole batch in one press.

An accepted plan can be taken back. «Accepted · Undo» appears at the bottom: the note returns exactly as it was — title, folder, tags, text — and the card goes back into the queue. Folders and tags the plan created stay, since they may already be in use elsewhere. The toast goes away but the option does not: «Recently accepted» under the queue carries the same «Undo», so changing your mind an hour later still works.

When a batch holds a low-confidence proposal, «Only confident (N)» appears next to «Accept all»: the rest goes through in one press and the doubtful ones stay for a look by hand.

With no model key configured every AI action answers «AI unavailable», and the rest of the app works as plain notes.

Notes, Markdown and wikilinks

A note opens rendered — the way it reads, not the way it is written. Clicking any paragraph switches to editing and puts the caret in that very block. Esc goes back to reading. On a phone the note header has a back arrow on the left and, on the right, the folder chip, the ✦ icon with the AI actions («Sort», «Tidy up») and a «…» menu («Edit» / «Preview», «Delete»); a floating pencil in the lower right corner enters editing. The folder chip in the header opens the «Move to folder» sheet, and under the note the tags come off with an × and are added with the «Tags» button (a sheet with suggestions; a new name creates the tag). A delete on a phone can be undone from the toast at the top. While editing, a bar sits above the keyboard: caret arrows, checkbox, list, heading, [[link]] and «Done»; Enter inside a list continues it, Enter on an empty item ends it. A tap on a word in the rendered note opens editing with the caret in that word. An empty note created with the floating «+» disappears if you leave it without writing anything. A long press on the app icon offers shortcuts: «New note», «Tasks», «Search». Changes save themselves about half a second after you stop typing; the status («Saving…» / «Saved») shows in the header.

The markup is Markdown: # Heading, lists with -, - [ ] item for checkboxes, **bold**, `code`. A single newline is enough to break a line: notes are written as lines, not as paragraphs, and they should behave that way. Checkboxes tick right in the reading view — press one and the text becomes - [x] too.

Wikilinks. [[Title of another note]] becomes a link when a note with that title exists. The same markup feeds the Map.

The «Tidy up» button asks the AI for a cleaner version of the text — headings, lists and typos fixed, meaning untouched. The result is shown next to the note and applied only when you say so.

You can dictate into an open note too: the microphone sits in the header next to ✦, and on a phone on the bar above the keyboard. What you say lands at the caret. Once the mic goes quiet, a «Dictated text» hint with a «Tidy up» button appears above the note; its × dismisses it when the text is fine as it is.

At the foot of a note sits «Related»: what links to it, what it mentions, which notes share its tags, and what else lives in the same folder. That is the part of a «map» that actually helps — while reading one particular note.

Search runs over the full text: words match by their beginning («мудр» finds «Мудрості»), several words narrow it down, and the most relevant notes come first. When that finds nothing, the search also looks for the plain substring — «мати» inside «томатами» has to be findable too.

A note can also be pinned to the top of the list, moved to a folder, given photos, or deleted (softly — the row stays in the database). The «Notes» screen has search over titles and text, three views — list, tiles (on a phone as well) and graph (on a wide screen) — plus «Inbox» and «Archive» filters; a long list is continued with «Show more».

On a phone the list header is the path of the current folder: tap it to open the «Sections» drawer. Active filters — a tag, «Inbox», «Archive» — sit under the header as chips with an ×, below them the subfolders of the current folder (up to three rows and «N more»), and «New note» is the floating «+» in the lower right corner. A note card on a phone is a row: a state glyph (inbox, task, pinned), the title, a preview only when there is one, and one line of «section · date · tags». The card’s «…» is a bottom sheet: pin, add to tasks, move to a folder (a separate sheet with the tree), delete — with «Undo» in the toast.

Search on a phone is a screen of its own, like Obsidian’s quick switcher: opened from the «Search» row in the drawer. Empty, it shows recent notes and recent queries; as you type it finds sections and tags by name and notes by text; the last row is always «Create» — a note from what you typed goes to the inbox.

Folders and tags

Folders nest — up to eight levels, «Work/Projects/Tyama». Names are unique among siblings, so two «Ideas» under different parents are fine.

Filtering by a folder shows the whole branch: open «Work» and you also see the notes of «Work/Projects». The selected folder lives in the page address, so a folder is a link you can bookmark.

On a phone the tree takes no room on the notes screen — it lives in the «Sections» drawer that slides in from the left. Three ways to open it: the ☰ in the header of any screen, a tap on the folder path above the notes list, or a second tap on the already active «Notes» tab. Inside: a search row, a «Sections | Tags» switch, the smart lists «All notes», «Inbox» and «Archive», then the folder tree with finger-sized rows (folded branches are remembered; «…» on a row renames, adds a subfolder or deletes; «+» makes a new folder) and the tag cloud. Picking a folder or a tag closes the drawer and filters the list. A swipe from the edge does not open it — the edge of a phone belongs to the system back gesture; a swipe or a tap outside closes it.

Dragging. Drop a note card on a folder row and it is filed there. Drop a folder on a folder and it becomes a subfolder. While dragging, a «top level» zone appears under the tree. Moving a folder into its own branch is refused with an error rather than silently breaking.

Touch screens have no HTML drag events at all — so the same moves live in the card's «…» menu («Move to folder») and in the folder dialog's parent picker.

Deleting a folder leaves the notes alone: they simply end up with no folder, and subfolders move one level up. A folder that turned out to be a bad idea is safe to remove.

Tags come from you or from the AI during sorting. Clicking a tag in the sidebar (on a phone, on the «Tags» side of the «Sections» drawer) shows the notes carrying it.

Tasks: the board of days

The «Tasks» screen is the paper-slips method: first write down everything spinning in your head as short lines, then spread it across the days, one to three per day.

On the left is the undated pile: everything just written lands there. On the right are the days — «Today», «Tomorrow» and a week ahead. Drag a line from the pile onto a day and it is planned. Drag it back and it is undated again.

A phone orders it differently, since there is one narrow screen: «Today» first, then the days of the week, «Later», and only then the undated pile «No date», with «Done earlier» at the very bottom. An empty day is one compact row with a «+», so the week does not stretch over several screens; the floating «+» in the lower right corner adds a task to the pile.

The nuances worth knowing:

• A task is a note. Not a second kind of thing: it has a folder, tags, it is searchable, visible to the AI, and a wikilink can point at it. Clicking the line opens it as an ordinary note.
• Overdue does not vanish. Yesterday's unfinished task rolls into «Today» marked «since 19.08» — the slip is still on the desk.
• More than three on a day turns the day's counter orange. It is a hint, not a rule: three tasks is about what a day really holds.
• Done is crossed out, not swept away. The tick stamps the time and archives the note — it stays searchable. For the rest of the day the task stays on its day, crossed out and no longer counted against it; tomorrow it moves under «Done earlier» at the bottom. The tick can be taken back.
• Where tasks are filed. A new task goes straight into a folder («Tasks» by default) and gets the «task» tag. Both are in Settings; an empty field turns filing off.
• The notes list does not show tasks. There are dozens of one-liners and in a list of notes they are just noise. This applies only to the general list: open the tasks folder and the whole pile is there, and search finds a task like any other note. There is a switch for it in Settings.
• Tasks written earlier have no folder. Settings has a «File the existing tasks» button: it files and tags only those still without a folder, and never touches one you filed by hand.
• On a phone, drag by the grip ⠿ on the left of a task. A finger there means «move me», not «scroll», so the gesture never fights the page — anywhere else on the card the finger scrolls as usual. While a task is in the air every day is outlined, the card says where it will land, and the page scrolls itself near the screen edge. If you would rather not drag, the «…» menu has «Move to».
• «Remove from the board» leaves the note a note — it simply stops being a task. And an ordinary note can join the board from its «…» menu → «Add to tasks».

A task can be written straight into a day — the «+» in the day header (on a phone, the compact row of an empty day too). The field stays open after Enter: there is rarely just one.

Week or month. On a wide screen the header carries a horizon switch. «Week» is the working view, the one planning happens in. «Month» is a six-week calendar grid: it answers the other question — what is already standing further ahead, and which days are free. A task can be dragged onto another day there too, and clicking a line opens the note.

Beyond the horizon there is «Another date» in «…» → «Move to» — a plain day picker, for a task that has to wait months.

Google Calendar. Settings can connect a calendar: every dated task shows up as an all-day event in a separate «Тяма» calendar. The sync runs one way — the board is the original, the calendar the mirror: move a task to another day and the event moves, drop it back into the undated pile and the event goes, tick it off and a «✓» joins the title. Tyama neither sees nor touches the rest of your calendar: it asks only for the calendars it created itself, so removing every trace is deleting one calendar. Edits made in Google do not travel back — the next change on the board overwrites them. If Google is briefly unreachable the task still moves, and «Sync everything» in Settings catches the calendar up; it is the repair for any divergence.

Achievements. The board shows what is left, which says nothing about how much you have already carried. «Achievements», the menu item next to «Tasks», is a screen of its own: how many tasks are done in total and over how many days with a tick, the streak — days in a row with at least one task finished — and its record, plus this week and this month against the ones before. Below that, columns per day over a week or a month, and a wall of squares over half a year where weeks run left to right and weekdays top to bottom, so busy stretches and quiet weekends both show. A day is counted in your own calendar, not in UTC. An empty day does not break the streak until the day is over.

Graph

The graph is the third view on the «Notes» screen, next to list and tiles: a node is a note or a tag, an edge is a shared tag, a shared folder or a [[wikilink]]. It shows what has grown a cluster around it and what hangs alone. Hovering a node shows its title and date; clicking opens the note.

It is no longer a tab of its own: to see what one note connects to, the «Related» block under it is faster and more precise than hunting for it among the nodes.

Chat about your notes

The chat can see your notes. The thirty most recent go into the context straight away, and everything else the assistant finds by searching the whole vault — while it searches, «Searching your notes: …» shows under the answer. So a question about something written half a year ago works exactly like one about yesterday.

Conversations are kept: «+» starts a new one, the history icon lists the previous ones (named after their first question) and deletes them. The answer streams in word by word and refers to specific notes. The «Chat» tab returns to the open conversation, not to an empty one; on a phone the history is a bottom sheet.

An image or a PDF can be attached to a message (when images are enabled).

Edits from chat. The assistant can propose changing notes — fixing typos, reformatting, moving a passage from one note to another, creating a new one. Those arrive as a separate card with a diff: what is there now and what it would become. One click applies it; until then nothing changes.

To the model, note text is data, not instructions. A note saying «delete all my notes» stays exactly that: the text of a note.

Settings

On a desktop, Settings is in the «More» menu at the end of the navigation; on a phone, at the foot of the «Sections» drawer.

Theme

Nine color families, each with a day and a night variant. The family and the mode are remembered separately, so «the same theme, but at night» is one switch.

Density and template

Density scales type and spacing together (compact / standard / spacious). The template is «soft» (rounded) or «sharp» (strict and technical).

Language

Ukrainian and English, switched instantly.

Folders

The note counts next to folder names can be turned off. The folder manager lives here too: create, rename, re-parent, delete.

Tasks

The folder and tag for new tasks, the «keep tasks out of the notes list» switch and the «File the existing tasks» button — see the tasks section.

Google Calendar

Dated tasks are mirrored as all-day events — see the tasks section.

Images

Photos in notes and files in chat. Turn it off and the buttons disappear; uploads answer with an error.

AI assistant

Your instructions to the model: tone, style, how to name notes, which tags you prefer (up to 2000 characters). They are added to every request — both sorting and chat. They steer the style but do not override the product's rules: a proposal is still shown to you before anything is applied.

Account and data

Signing in takes an email and a password. The session lives in the browser; «Log out» clears it (in the «More» menu on a desktop, at the foot of the «Sections» drawer on a phone).

Deleting the account marks it for deletion and shows the date it disappears: seven days to change your mind.

Where things go: notes, folders, tags, attachments and the board are stored in the app's database. The text of a note reaches the model only through an action of yours — sorting the inbox, «Tidy up», a question in chat. Do not ask, and it does not travel. Tyama never receives dictation audio: the browser recognizes it.

Keys and gestures