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 and list), Map (a graph of connections) and Chat. On a desktop the folders and tags live in the sidebar and follow you across every screen; on a phone there is a bottom bar, and the folder tree hides behind the filter row on the notes screen.

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.

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).

A note created on the «Notes» screen with «New note» 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

«Sort everything» in the inbox 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.

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.

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. 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.

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.

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 and graph — plus «Inbox» and «Archive» filters; a long list is continued with «Show more».

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.

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 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 (on a phone, at the top) 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.

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 goes to the archive. The tick stamps the time and archives the note: it leaves the board but not the search. The last few sit under «Done» at the bottom, and 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 there is no dragging: the line's «…» menu has «Move to» with the same list of days.
• «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. The field stays open after Enter: there is rarely just one.

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.

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

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.

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.

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.

Keys and gestures