Kiroku User Guide

Welcome to Kiroku

Kiroku is a visual weekly planner. Your week appears as a colorful grid — each column is a day, and each row is an hour. Create tasks by clicking and dragging directly on the grid.

All your data stays on your device. No account required.

Table of Contents

• Get started
• The main view

- Day columns

- Hour markers

- Notes and hours summary

• Create, edit, and delete tasks

- Resize a task

- Move a task

- Add text to a task

- Delete a task

- The current time indicator

• Manage task types
• View task details on hover
• Navigate your schedule

- Zoom in and out

• Turn on dark mode
• Track your time

- View time breakdowns

- View daily timelines

• View the daily summary
• Use the calendar view
• Write day notes
• Clear all tasks for a day
• Settings

- General

- Styles

- Overlay

- Days

- Tasks

- Colors

- Alerts

- Calendar

- Pomodoro

- Templates

- Status

• Pomodoro timer

- Session cycling

- Pomodoro settings

• Backlog sidebar

- Schedule a backlog task

• Command palette

- Natural language input

- Task type tags

• Recurring tasks

- Recurrence patterns

- Edit or delete instances

• Day templates

- Apply a template

- Manage templates

• Cloud sync

• Status presets

- Customize status colors

• Pop-up notifications
• Keyboard shortcuts
• Privacy and data

Get started

Open Kiroku in your browser or the Windows desktop app. Your current week appears automatically.

To plan your first task:

1. Click a colored task type button at the top of the screen (such as Work or Personal).
2. Click and drag on any day column to draw a block of time.
3. Release to create the task.

The task appears on the grid immediately. Hover over it to see its start time, end time, and duration.

The main view

The top bar

The top bar contains navigation controls and quick-access buttons.

• Month and year. Displays the current month (such as "March 2026").
• Task type buttons. Colored buttons for each task category. The selected type has a glowing border. Hover over a button to see its name.
• Workspace switcher. A dropdown that appears when you have more than one workspace.
• Prev / Next arrows. Move one week backward or forward.
• Today. Return to the current week.
• Zoom level. Displays the current zoom percentage when not at 100%.
• Icon buttons. From left to right: Time Tracking (bar chart), Daily Summary (bell), Calendar View (calendar), Dark Mode (moon or sun), Settings (gear).

Day columns

Each day has its own column with the following elements:

• Header. Shows the day number and name (such as "19 Wed"). Today's header is highlighted in blue. Holidays appear in red text when turned on. If a day has multiple holidays, the first is shown with a "+1" badge — hover to see all.
• Grid. Solid lines mark each hour. Dashed lines mark the half hour. Faint vertical lines help you position tasks precisely.
• Current time marker. A red highlight on today's column shows the current time. It updates automatically.
• Hour lines. Bold horizontal lines you can add in Settings to mark important times.
• Background colors. Columns alternate between two background colors. You can customize weekday and weekend colors separately.

Hour markers

Small numbered circles appear along the left edge of each column, one for each hour (0 through 23).

Click any marker to cycle through three states:

• Normal. A subtle circle with the hour number.
• Highlighted. A bold, filled circle that stands out.
• Hidden. The marker is not visible.

Notes and hours summary

Below each day's header:

• Total time. The total scheduled time for that day (such as "2 hours and 30 minutes"). If no tasks are scheduled, it reads "No tasks."
• Notes. A text area for quick notes about that day. Click to edit, and the notes save automatically when you click away or press Tab. Press Escape to discard changes.

Create, edit, and delete tasks

Create a task

1. Click a task type button at the top of the screen.
2. Click and hold on a day column where you want the task to begin.
3. Drag up or down to set the duration. A colored preview appears as you drag.
4. Release to place the task.

Tasks snap to 5-minute intervals. The minimum task duration is 5 minutes.

Resize a task

Move your pointer to the top or bottom edge of a task until the cursor changes. Click and drag to make the task longer or shorter.

Tasks snap to 5-minute intervals when resizing.

Move a task

Click and drag from the center of a task to reposition it.

Do any of the following:

• Change the time. Drag the task up or down within the same column.
• Change the day. Drag the task left or right to a different column.

The task saves to its new position when you release.

Add text to a task

1. Double-click a task to open the editor.
2. Type a label, meeting name, or any text you like.
3. Do one of the following:

- Press Shift + Enter to add a new line.

- Press Escape to cancel without saving.

- Click Save or Cancel.

Text appears directly on the task block. Long text is truncated with an ellipsis.

Delete a task

Do either of the following:

• Use the editor. Double-click the task, then click Delete. Confirm when prompted.
• Press and hold. Hold the pointer on a task for 3 seconds without moving. A confirmation dialog appears. If you move the pointer during the hold, the action is cancelled and the task is dragged instead.

The current time indicator

A red highlight appears on today's column showing the current time. It updates in real time and appears only on today's column.

Manage task types

Task types are categories with assigned colors. Every task belongs to one type. Kiroku includes five default types:

To customize task types, go to Settings > Tasks.

You can rename any type, change its color, add new types, or delete types you no longer need. If tasks exist that use a type you delete, you are prompted to confirm before those tasks are removed.

View task details on hover

When you hover over a task, an info overlay appears with details about it.

The overlay can show:

To customize which fields appear, the overlay position, time format, and hover delay, go to Settings > Overlay.

Navigate your schedule

Switch weeks

• Click Prev to go back one week.
• Click Next to go forward one week.
• Click Today to return to the current week.

The month and year in the top bar update as you navigate.

Zoom in and out

Hold Ctrl and scroll the mouse wheel to zoom. Five zoom levels are available:

The zoom level appears in the top bar when not at 100%. The view remains centered on the area you are viewing.

Turn on dark mode

Click the moon icon in the top bar. All interface elements update to a dark color scheme.

To return to light mode, click the sun icon. Your preference is saved automatically.

Track your time

Click the bar chart icon in the top bar to open Time Tracking.

Choose a date range

Use the From and To date pickers at the top. Click either to open a calendar. Use the arrows to change months. Click Today to set both dates to the current day.

If no tasks exist in the selected range, a message indicates this.

Click X to close.

View time breakdowns

For each task type with scheduled time in the date range, the following appears:

• The type name with its color.
• Total hours spent on that type.
• A proportional colored bar for visual comparison.

View daily timelines

Below the totals, each day is shown as a horizontal 24-hour timeline with colored bars at the actual times of your tasks.

• Hover over a bar to see its time range, duration, and text.
• Time markers appear at 6 AM, 9 AM, 12 PM, 3 PM, 6 PM, and 9 PM.
• Total time for each day appears on the right.

View the daily summary

Click the bell icon in the top bar.

The daily summary shows:

• Total number of tasks and total time planned for today.
• A breakdown by task type (such as "3 Work tasks — 4 hours").
• Day notes, if any.

This is a read-only overview. Close it to make changes on the grid.

Use the calendar view

Click the calendar icon in the top bar.

The calendar displays three months at once. Each day shows:

• Colored bars representing tasks (up to 5 visible, with a "+2 more" indicator for additional tasks).
• Holiday names, if holiday countries are configured.
• Background colors matching your column settings.

Click any day to jump to that week in the main view. Today is marked with a colored circle.

To navigate:

• Click « or » to jump 3 months.
• Click ‹ or › to move 1 month.
• Click Today to return to the current month. This button appears only when you have navigated away.

Write day notes

Every day includes a notes area below the header.

1. Click the Notes... text area.
2. Type your notes.
3. Click away or press Tab to save.

Press Escape to discard changes. Day notes also appear in the Daily Summary.

To change the notes font size, go to Settings > Days.

Clear all tasks for a day

1. Press and hold the day header (the area showing the day number and name) for 3 seconds.
2. A confirmation dialog appears showing how many tasks will be deleted.
3. Click Delete all to confirm, or Cancel to dismiss.

Settings

Click the gear icon in the top bar. The Settings panel has 12 tabs. Click any tab name to switch to it. Click outside the panel to close it.

Workspaces

Workspaces are separate environments, each with its own tasks, categories, colors, and settings.

Each workspace appears as a card. The active workspace is labeled "Active." Other workspaces show a Switch button.

Do any of the following:

• Rename a workspace. Click the workspace name and type a new name.
• Switch workspaces. Click Switch on any workspace card.
• Delete a workspace. Click the × button. This option appears only when you have more than one workspace. Confirm when prompted.
• Add a workspace. Click + Add Workspace. A new workspace is created with default settings.

When you have multiple workspaces, a dropdown in the top bar lets you switch without opening Settings. A checkmark indicates the active workspace.

General

The General tab manages your data and provides account utilities.

Export your data

Click Export to download all workspaces, tasks, settings, and notes as a .tdb file. The file name includes the current date.

Import data from a backup

1. Click Import and select a .tdb file.
2. Review the summary: number of workspaces, number of tasks, and file date.
3. Click Import and replace to proceed, or Cancel to dismiss.

Clear all tasks

Displays the number of tasks in the current workspace. Click Clear all tasks and confirm to delete them. Settings, notes, and other workspaces are not affected.

Reset to defaults

Erases all workspaces, tasks, notes, and settings and returns the app to its initial state.

Client ID

A unique identifier for your browser. Click Copy to copy it to your clipboard. This code persists even after a reset.

Styles

Control how tasks appear on the grid.

Choose a task appearance

Three visual styles are available:

• Normal. Solid colored blocks with clean edges.
• Highlighter. Translucent colors with a slight text tilt, resembling a highlighter pen. Use the opacity slider to adjust transparency.
• Office. A faint colored background with a bold stripe on the left edge, similar to Outlook or Google Calendar. Use the opacity slider to adjust the background intensity.

Set overlap indicators

When tasks overlap, the overlapping area can be marked with a visual pattern.

Choose from: None, Solid, Crosshatch, Dots, Diagonal, or Lines.

For any option other than None, you can also set the pattern color (from your palette) and adjust the opacity.

Adjust text size

Use the slider to set the font size for task text. The range is 8 to 24 pixels. The default is 13.

Choose a font

The available fonts depend on the selected task appearance.

• Caveat — Clean and legible handwriting
• Patrick Hand — Friendly and rounded
• Shadows Into Light — Light and elegant
• Indie Flower — Casual and sketch-like
• Kalam — Bold, brush-style handwriting
• Architects Daughter — Technical drawing style
• Permanent Marker — Thick marker pen

• Inter — Modern and highly readable (default)
• Roboto — Clean and versatile
• Open Sans — Friendly and clear
• Lato — Warm with soft edges
• Source Sans 3 — Professional and clean
• Nunito — Rounded and approachable
• IBM Plex Sans — Precise and technical

Each font includes a preview showing sample task text.

Overlay

Configure the info overlay that appears when you hover over a task.

Choose which fields to show

Turn on or turn off each field independently:

• Start Time — When the task begins
• End Time — When the task ends
• Duration — How long the task lasts
• Text — The task label
• Task Type — The category name

Set the overlay position

Choose where the overlay appears on screen:

• Top Left, Top Right, Bottom Left, Bottom Right — Fixed in a corner.
• Centered — Fixed in the center of the screen.
• Mouse — Follows the pointer.

Choose a time format

• Short. 24-hour format with abbreviations (such as "09:30 · 4H 5M").
• Long. 12-hour format with full words (such as "9:30 AM · 4 Hours 5 Min").

Set the hover delay

Use the slider to set how long you must hover before the overlay appears. The range is 0 to 10 seconds. Set to 0 for instant display.

Days

Configure which days are visible and how columns appear.

Choose visible days

Seven buttons represent each day of the week. Click to show or hide individual days. At least one day must remain visible.

Two presets are available:

• All — Show Sunday through Saturday.
• Weekdays — Show Monday through Friday only.

Adjust cell size

Use the slider to set the column width, from 20 to 100 pixels. You can also type an exact value.

Adjust font sizes

Two sliders control text size:

• Notes Font — Font size in the notes area (8 to 24 pixels).
• Hours Font — Font size for the total hours display (8 to 24 pixels).

Set column backgrounds

Set background colors for four column types:

• Even columns — The 1st, 3rd, 5th columns.
• Odd columns — The 2nd, 4th, 6th columns.
• Saturday — A dedicated color for Saturday. Click "--" to follow the even/odd pattern.
• Sunday — A dedicated color for Sunday.

Click any color from your palette to apply it.

Configure hour markers

A grid of 24 buttons (0 through 23) appears in two rows. Click any hour to cycle through Normal, Highlighted, and Hidden states.

Hover over a button to see its current state.

Adjust marker size

Use the slider to set the hour marker size, from 16 to 48 pixels. The default is 28.

Add hour lines

Hour lines are bold horizontal lines that span the grid at specific times.

Each line has:

• A time picker (hour and minute in 5-minute steps).
• Day buttons to choose which days the line appears on. New lines default to Monday through Friday.
• A delete button (×) to remove the line.

Click + Add Line to create a new line.

Tasks

Manage the task type categories that appear as colored buttons in the top bar.

Each task type displays as a card with:

• A colored square showing the current color.
• An editable name field.
• Color swatches from your palette.
• A delete button (×).

Colors

Manage the color palette used throughout the app for task types and backgrounds.

Active palette

Your selected colors appear at the top (up to 20). Click any color to remove it from the palette. At least one color must remain.

Click Reset to defaults to restore the original 20 colors.

Color catalog

A library of 120 colors organized into six groups:

• Pastels (30) — Soft, light tones
• Warm (20) — Reds, oranges, yellows
• Cool (20) — Blues, teals, cyans
• Earth (20) — Browns, tans, olives
• Jewel (15) — Rich, saturated tones
• Neutral (15) — Grays and silvers

Click a color in the catalog to add it to your active palette. Colors already in your palette have a highlighted border. The palette has a maximum of 20 colors.

Alerts

Configure browser notifications for task reminders and daily overviews.

Turn on notifications

Turn on the toggle at the top. Your browser requests permission to send notifications. Click Allow when prompted.

If notifications are blocked, follow the on-screen instructions to update your browser permissions.

Sound

Turn on or turn off the notification sound. Sound is on by default.

Task reminders

Turn on to receive a notification before each task begins. Choose your reminder interval:

The selected interval has a highlighted border.

Daily summary notification

Turn on to receive a daily overview of your scheduled tasks. Use the time slider to choose when the notification is sent — from midnight to 11:00 PM. The selected time is displayed next to the slider.

Calendar

Configure holiday display and custom calendars.

Choose where holidays appear

Two options are available:

• Show in header. Holidays appear in the day header below the day name.
• Show in column. Holidays appear as markers on the grid.

Turn on either or both options.

Select holiday countries

Choose which countries' public holidays to display. Use the search field to filter the list by name or country code.

Each country row shows:

• A checkbox to select or deselect the country.
• The country flag and name.
• The country code (such as "US" or "DE").
• An expand arrow (▼) to view all holidays for the current year.

Selected countries appear as pills above the list. Click × on a pill to remove it.

Import a custom calendar

Import your own dates from a text file.

The file format is:

My School Holidays 2026
2026 : 0101 : New Year's Day
2026 : 0321 : Spring Break Starts
2026 : 0328 : Spring Break Ends
2026 : 1225 : Christmas

The first line is the calendar name. Each subsequent line follows the format: year : mmdd : description (where mmdd is the month and day — 0321 means March 21).

Save the file as .txt and click Import to load it.

After importing, you can:

• Turn on or turn off the calendar with its checkbox.
• Expand (▼) to view all dates.
• Export (↓) to download it as a text file.
• Delete (✕) to remove it.

Pomodoro timer

The built-in Pomodoro timer helps you work in focused intervals. Click the tomato icon in the top bar to open the timer widget.

Start a session

Click Start Focus to begin a focus session. The timer counts down from your configured focus duration (default: 25 minutes). A circular progress ring shows how much time remains.

Controls available during a session:

• Pause. Temporarily stop the countdown. Click Resume to continue.
• Skip. Jump to the next session (break or focus).
• Reset. Return to the initial idle state.

Session cycling

The Pomodoro timer follows a focus/break cycle:

1. Focus session — Concentrated work time (default: 25 minutes).
2. Short break — A brief rest (default: 5 minutes).
3. Repeat steps 1 and 2 for the configured number of sessions per cycle (default: 4).
4. Long break — An extended rest after completing the full cycle (default: 15 minutes).

Session dots below the timer show your progress through the current cycle. Completed sessions appear as filled dots.

When a session ends:

• A bell sound plays (if sound is enabled).
• A browser notification appears (if notifications are enabled).
• The browser tab title flashes so you notice even when Kiroku is in the background. The flashing stops when you return to the tab.

The timer uses timestamps rather than interval counting, so it remains accurate even when the browser tab is in the background.

Pomodoro settings

Configure the timer in Settings > Pomodoro:

Backlog sidebar

The backlog is a holding area for tasks that are not yet scheduled. Use it to capture ideas and to-dos before deciding when to do them.

Click the grid icon in the top bar to open the backlog sidebar. It appears on the left side of the screen.

Add tasks to the backlog

1. Select a task type by clicking one of the colored chips at the top of the sidebar.
2. Type a task name in the text field.
3. Press Enter or click + to add it.

The task appears in the backlog list with a colored dot indicating its type. A badge in the sidebar header shows the total number of backlog tasks.

Schedule a backlog task

Drag any task from the backlog list and drop it onto a day column in the grid. The task is removed from the backlog and placed at the position where you dropped it.

To delete a backlog task without scheduling it, click the x button on the task row.

Command palette

The command palette lets you create tasks quickly using natural language, without clicking on the grid.

Open the command palette

Press Ctrl + K to open the command palette. A search bar appears in the center of the screen.

Type a task description with optional time, day, and type information. The palette parses your input in real time and shows a preview of the task it will create, including badges for the task type, day, and time range.

Press Enter or click Create Task to confirm. Press Escape to close without creating anything.

Natural language input

The command palette understands a variety of time and day expressions:

If you specify a single time without a duration, the task defaults to 30 minutes.

If you specify a time but no day, the task defaults to today.

• "Lunch 12pm-1pm today" — Creates a 1-hour task from noon to 1 PM today.
• "Design review 2pm tomorrow for 1h" — Creates a 1-hour task at 2 PM tomorrow.
• "Team standup 9am monday" — Creates a 30-minute task at 9 AM next Monday.
• "Buy groceries" — No time specified, so the task is added to the backlog.

Task type tags

Add a # tag to assign a task type:

• "Lunch 12pm #personal" — Assigns the Personal task type.
• "Sprint planning 10am #work" — Assigns the Work task type.

The tag is matched against your task type names (case-insensitive). If no tag is specified, the currently selected task type is used.

Recurring tasks

Recurring tasks repeat automatically on a schedule. A recurring task appears on every matching day without manual duplication.

Create a recurring task

1. Double-click a task to open the task editor.
2. Set a recurrence pattern (the recurrence options appear in the editor).
3. Save the task.

The task becomes a recurring series. Virtual instances are generated for each matching date and appear on the grid automatically. Recurring tasks display a small repeat icon to distinguish them from one-off tasks.

Recurrence patterns

The following patterns are available:

Additional options:

• End date. Stop generating instances after a specific date.
• End count. Stop after a specific number of occurrences.
• Days of week. For weekly and biweekly patterns, choose which days to repeat on.
• Day of month. For monthly patterns, choose which day of the month. If the day does not exist in a given month (such as the 31st in February), the last day of the month is used.

Edit or delete instances

When you edit, move, resize, or delete a recurring task, a dialog asks whether you want to change:

• Just this one. Creates an exception for this specific date. The rest of the series is unchanged.
• All occurrences. Updates the master task, which affects all instances in the series.

Excluded dates (deleted instances) are tracked on the series. They will not reappear unless you modify the recurrence rule.

Day templates

Day templates let you save a day's layout and apply it to any other day. This is useful for days that follow a regular pattern, such as a "Focus Day" or "Meeting Day."

Save a template

1. Right-click a day header (the area showing the day number and name).
2. Select Save as template from the context menu.
3. Enter a name for the template.

The template captures all tasks on that day, including their times, types, and text.

Apply a template

1. Right-click the header of the day you want to populate.
2. Select the template from the context menu.

The template's tasks are added to the target day. Existing tasks on that day are not removed.

Manage templates

Go to Settings > Templates to view, rename, or delete saved templates.

Each template card shows:

• The template name (click Rename to change it).
• The number of tasks in the template.
• The date the template was created.
• A Delete button to remove the template.

Cloud sync

When you are signed in with an account, Kiroku syncs your data across devices. All workspaces, tasks, notes, and settings are included.

Real-time sync

Kiroku uses Server-Sent Events (SSE) for real-time push notifications between your devices. When you make a change on one device, other devices connected to the same account receive the update automatically within seconds.

If the real-time connection is interrupted, Kiroku falls back to periodic polling (every 2 minutes when the tab is active, every 10 minutes when the tab is in the background). The real-time connection is re-established automatically when possible.

Data is compressed before upload and protected by hash verification. When a conflict is detected (changes on two devices at the same time), you are prompted to choose which version to keep.

Status presets

Task statuses let you track progress on individual tasks. Choose a status preset that matches your workflow, then assign statuses to tasks.

Choose a preset

Go to Settings > Status and select a preset. Five presets are available:

Each status has a default color. You can turn individual statuses on or off using the checkboxes. Only enabled statuses appear as options when editing tasks.

Customize status colors

Click the colored dot next to any status to open a color picker. Choose a color from your palette or the full color catalog.

Click reset next to any status to restore its default color.

A preview at the bottom of the settings panel shows your enabled statuses as colored chips.

Pop-up notifications

When notifications are turned on (in Settings > Alerts), notification banners slide in from the right side of the screen.

• Multiple notifications stack vertically.
• Each notification has a close button (X).
• Click a Daily Summary notification to open the full Daily Summary view.

Keyboard shortcuts

Privacy and data

• Your data stays on your device by default. All data is stored in your browser's IndexedDB storage. Without an account, nothing is sent to any server.
• Cloud sync (optional). When you sign in with an account, your data is encrypted, compressed, and synced to the server. Sync uses hash verification to detect conflicts. See Cloud sync for details.
• Client ID. A unique identifier stored in your browser. It persists across resets and can be used to link your data or transfer it between browsers.
• Back up regularly. Go to Settings > General and click Export to save a backup file. Use Import to restore from a backup at any time.
• Browser data affects your tasks. Clearing your browser data removes Kiroku data. Always export before clearing.
• The desktop app stores data locally on your computer using the same approach.