FraGament Reference Guide

1. What is FraGament?

FraGament is a completely local note-taking app designed to capture the “fragments of awareness” that arise while you are engaged with a work — games, books, movies, videos, and more.

Features like short tags, session time tracking, automatic saving, and JSON backup make it useful not only for journaling, but also for reviews, analysis, and creative work.

2. Titles and Fragments

● Title

A title represents the top-level unit of your notes. You can create one for each game, book, movie, or any work you engage with.

● Fragment

A fragment is a card where you write down individual insights that arise during play, reading, or viewing. The first line becomes the headline; the rest is completely free-form.

・Automatic tag extraction
・Sorting by time
・Linked to sessions
These functions all integrate with fragments inside FraGament.

3. Memo Editor

The memo editor in FraGament is powered by CodeMirror 6. Everything you type is saved instantly to IndexedDB (fully local / automatic saving).

● Automatic Tag Extraction

Hashtags like #tag are extracted in real-time and displayed in the fragment list.

4. Short Tag List (@...)

In FraGament, typing @f or@t and pressing enter will automatically convert the input into a tag.

The format of time-based tags changes depending on “Include time in short tag” in the settings:
#fun-1:23 (hyphen)
#fun 1:23 (space)

Input	Output	Meaning
@now	Current time	Insert system timestamp
@uid	uid:xxxx	User ID
@tid	tid:xxxx	Title ID
@sid	sid:xxxx	Session ID
@fid	fid:xxxx	Fragment ID
@a	#angry	Anger / frustration
@b	#bad	Bad moment / negative scene
@c	#cut	Clip-worthy moment
@d	#death	Death event / fatal scene
@e	#event	Event / key scene
@f	#fun	Fun moment
@g	#good	Good moment / positive impression
@h	#hint	Hint / foreshadowing
@i	#idea	Idea / thought
@j	#joke	Joke / funny line
@k	#key	Key moment / important clue
@l	#love	Affection / favorite moment
@m	#memo	Additional memo
@n	#note	Note / annotation
@o	#oops	Mistake / slip-up
@p	#0:15 etc.	Session elapsed time
@q	#quest	Quest / task
@r	#reveal	Reveal / truth uncovered
@s	#sad	Sad moment
@t	#1:15:30 etc.	Total time for title
@u	#unlock	Unlock / breakthrough
@v	#voice	Notable voice line / dialogue
@w	#wow	Wow moment / amazement
@x	#extra	Extra info / details
@y	#yummy	Tasty moment / emotionally flavorful
@z	#zoom	Focus point / highlight
@!	#surprise	Surprise / shock
@?	#question	Question / mystery

Tags convert when typing patterns like @t⏎.

5. Session Tracking

Each time you open a title, a new session is automatically created. A session represents a block of working or thinking time.

・Start / end time
・Real-time elapsed time
・Number of fragments created in the session

All of this helps connect your progress — reading, play, or work — to your changing thoughts.

6. JSON Export / Import

● Export

All data can be exported into a single JSON file.

● Import

You can restore data or migrate to another device by loading the JSON file.

※ Importing will overwrite all existing data.

7. Settings

Language (Japanese / English)
Auto-create first fragment when opening a title
Fragment order (Updated / Created)
Fragment tap behavior (Mobile)
Font size
Line height
Autosave delay
Include time in short tags

8. Export (Text / Markdown)

You can merge all fragments and export them as a draft for reviews.

Text (.txt)
Markdown (.md)