ip

Reverie: User Guide

Reverie is a personal task manager chatbot that helps you track todos, deadlines, and events via a simple command-line interface.

Quick Start
Features
Task Symbols
Data Storage
Command Summary
Tips
Appendix: Complete List of Accepted Date/Time Formats

Quick Start

Ensure you have Java 17 installed
Download reverie.jar
Open terminal, navigate to the jar file location
Run: java -jar reverie.jar
Type commands and press Enter

Features

Understanding Commands

Words in UPPER_CASE are parameters you need to provide
- Example: todo DESCRIPTION → todo read book
Items in [square brackets] are optional
- Example: deadline TASK /by DATE [TIME] can be used with or without time
All command words are case-insensitive
- Example: The command word todo can be replaced by TODO, ToDo, toDo, etc.
Task numbers start from 1 (shown when you use list)

Adding Tasks: `todo`, `deadline`, `event`

Todo: `todo`

Simple tasks without dates.

Format: todo DESCRIPTION
Case-sensitivity: Command word todo is case-insensitive.

todo read book

Got it. I've added this task:
  [T][ ] read book
Now you have 1 task in the list.

Deadline: `deadline`

Tasks with a due date/time.

Format: deadline DESCRIPTION /by DATE_TIME
Case-sensitivity: Command word deadline is case-insensitive. Keyword /by is case-sensitive (lowercase only).

deadline submit report /by 2019-12-02

Got it. I've added this task:
  [D][ ] submit report (by: Dec 02 2019)
Now you have 2 tasks in the list.

deadline return book /by Dec 02 2019 1800

Got it. I've added this task:
  [D][ ] return book (by: 18:00 Dec 02 2019)
Now you have 3 tasks in the list.

⚠️ Important: If the text after /by doesn’t match any accepted date/time format, Reverie will treat it as plain text, not as a date. Always check the output to verify your date was recognized.

Event: `event`

Tasks with start and end times.

Format: event DESCRIPTION /from START /to END
Case-sensitivity: Command word event is case-insensitive. Keywords /from, /to are case-sensitive (lowercase only).

event meeting /from 2019-12-02 1400 /to 2019-12-02 1600

Got it. I've added this task:
  [E][ ] meeting (from: 14:00 Dec 02 2019 to: 16:00 Dec 02 2019)
Now you have 4 tasks in the list.

event lunch /from 1200 /to 1400

Got it. I've added this task:
  [E][ ] lunch (from: 12:00 Oct 05 2024 to: 14:00 Oct 05 2024)
Now you have 5 tasks in the list.

💡 Tips:

Smart date inference:
- If the start has a date but the end has only time (e.g., /from Dec 02 2019 0900 /to 1700), Reverie intelligently decides and sets the end date = start date (or start date + 1 if end time < start time).
- If the end has a date but the start has only time (e.g., /from 0900 /to Dec 02 2019 1700), Reverie intelligently decides and sets the start date = end date (or end date - 1 if start time > end time).
If you provide only time (e.g., 1200), today’s date is used automatically; if both are time-only (e.g., /from 1200 /to 1400), today’s date is used for both.

⚠️ Important: If the text after /from or /to doesn’t match any accepted date/time format, Reverie will treat it as plain text, not as a date/time. Always check the output to verify your dates were recognized.

Date & Time Formats

Reverie accepts specific date and time formats:

Month names: capitalize only the first letter (e.g., Apr, Sep, Oct, Dec).
AM/PM indicators are case-insensitive.

Format Rules

Date formats:

Separators: - or /
Date orders: yyyy-MM-dd, dd-MM-yyyy, MMM dd yyyy, dd MMM yyyy, yyyy MMM dd
Examples: 2019-12-02, 02/12/2019, Dec 02 2019

Time formats:

24-hour: HHmm or HH:mm
- Examples: 1400, 14:00
12-hour: h:mma, h:mm a, hh:mma, hh:mm a, hmma, hmm a, hhmma, hhmm a
- 12-hour formats are ONLY valid when time is provided alone, NOT in date-time combinations
- Examples: 2:00pm, 2:00 pm, 02:00pm, 02:00 pm

Date-time combinations:

Date + Time: 2019-12-02 1400, Dec 02 2019 14:00, 02/12/2019 1400
Time + Date: 1400 2019-12-02, 14:00 Dec 02 2019, 1400 02/12/2019
ISO format: 2019-12-02T14:00, 2019-12-02T14:00:00

Quick examples:

deadline report /by 2019-12-02
deadline report /by Dec 02 2019 1400
deadline report /by 02/12/2019 2:00pm
deadline report /by 1400 2019-12-02
deadline report /by 2:00pm
event meeting /from 1400 /to 1600
event meeting /from Dec 02 2019 /to Dec 04 2019

📘 For the complete list of accepted date/time formats, please refer to the Appendix.

⚠️ Important:

Only formats listed above are recognized as dates/times
If you use a different format (e.g., December 2, 2019 or 2nd Dec 2019), Reverie will NOT recognize it as a date and will treat it as plain text
Always verify the output shows your intended date/time in the confirmation message

Viewing Tasks: `list`, `find`, `schedule`

List all tasks: `list`

Format: list
Case-sensitivity: Command word list is case-insensitive.

list

Here are the tasks in your list:
[T][ ] read book
[D][ ] submit report (by: Dec 02 2019)
[E][ ] meeting (from: 14:00 Dec 02 2019 to: 16:00 Dec 02 2019)

Find tasks: `find`

Search by keyword (case-insensitive match).

Format: find KEYWORD
Case-sensitivity: Command word find is case-insensitive. Keyword matching is case-insensitive.

find book

Here are the matching tasks in your list:
 1.[T][ ] read book
 5.[D][ ] return library book (by: Dec 10 2019)

find BOOK

Here are the matching tasks in your list:
 1.[T][ ] read book
 5.[D][ ] return library book (by: Dec 10 2019)

View schedule: `schedule`

See tasks on a specific date. Date must be in yyyy-MM-dd format only.

Format: schedule DATE
Case-sensitivity: Command word schedule is case-insensitive.

schedule 2019-12-02

Here are the tasks scheduled for Dec 02 2019:
 2.[D][ ] submit report (by: Dec 02 2019)
 3.[E][ ] meeting (from: 14:00 Dec 02 2019 to: 16:00 Dec 02 2019)

⚠️ Important: For the schedule command, only yyyy-MM-dd format is accepted (e.g., 2019-12-02). Other formats will cause an error.

Managing Tasks: `mark`, `unmark`, `delete`

Mark as done: `mark`

Format: mark TASK_NUMBER
Case-sensitivity: Command word mark is case-insensitive.

mark 1

Nice! I've marked this task as done:
  [T][X] read book

Mark as not done: `unmark`

Format: unmark TASK_NUMBER
Case-sensitivity: Command word unmark is case-insensitive.

unmark 1

OK, I've marked this task as not done yet:
  [T][ ] read book

Delete task: `delete`

Format: delete TASK_NUMBER
Case-sensitivity: Command word delete is case-insensitive.

delete 1

Noted. I've removed this task:
  [T][ ] read book
Now you have 4 tasks in the list.

⚠️ Important: Deletion is permanent. Task numbers shift after deletion - use list to verify.

Exit: `bye`

Format: bye
Case-sensitivity: Command word bye is case-insensitive.

bye

Bye. Hope to see you again soon!

Task Symbols

[T] = Todo [D] = Deadline [E] = Event
[ ] = Not done [X] = Done

Examples:

[T][ ] read book - Todo, not done
[D][X] submit report (by: Dec 02 2019) - Deadline, completed
[E][ ] meeting (from: 14:00 Dec 02 2019 to: 16:00 Dec 02 2019) - Event, not done

Data Storage

Tasks auto-save to ./data/reverie.txt after every change
Autoloads on startup
⚠️ Do not manually edit the data file - may cause corruption

To transfer data: Copy the entire data folder to your new computer.

Command Summary

Command	Format (case-sensitive only for `/by`, `/from`, `/to`)	Example
Add `todo`	`todo DESCRIPTION`	`todo read book`
Add `deadline`	`deadline DESCRIPTION /by DATE_TIME`	`deadline report /by Dec 02 2019`
Add `event`	`event DESCRIPTION /from START /to END`	`event meeting /from 1400 /to 1600`
`List` tasks	`list`	`list`
`Find` tasks	`find KEYWORD`	`find book`
View `schedule`	`schedule DATE`	`schedule 2019-12-02`
`Mark` done	`mark TASK_NUMBER`	`mark 1`
`Unmark`	`unmark TASK_NUMBER`	`unmark 1`
`Delete`	`delete TASK_NUMBER`	`delete 1`
Exit with `bye`	`bye`	`bye`

Tips

✅ Use descriptive task names for clarity
✅ Check list before using task numbers
✅ Use schedule to plan your day
✅ Back up your data folder regularly
✅ Time-only entries (1400) default to today
✅ Always verify the output message to confirm dates/times were recognized correctly

Appendix: Complete List of Accepted Date/Time Formats

Date-Time Formats (with both date and time)

Format Pattern	Example
`yyyy-MM-dd HHmm`	2025-10-05 1430
`yyyy-MM-dd HH:mm`	2025-10-05 14:30
`yyyy/MM/dd HHmm`	2025/10/05 1430
`yyyy/MM/dd HH:mm`	2025/10/05 14:30
`dd-MM-yyyy HHmm`	05-10-2025 1430
`dd-MM-yyyy HH:mm`	05-10-2025 14:30
`dd/MM/yyyy HHmm`	05/10/2025 1430
`dd/MM/yyyy HH:mm`	05/10/2025 14:30
`yyyy-MM-dd'T'HH:mm`	2025-10-05T14:30
`yyyy-MM-dd'T'HH:mm:ss`	2025-10-05T14:30:45
`yyyy MMM dd HHmm`	2025 Oct 05 1430
`yyyy MMM dd HH:mm`	2025 Oct 05 14:30
`MMM dd yyyy HHmm`	Oct 05 2025 1430
`MMM dd yyyy HH:mm`	Oct 05 2025 14:30
`dd MMM yyyy HHmm`	05 Oct 2025 1430
`dd MMM yyyy HH:mm`	05 Oct 2025 14:30
`HHmm yyyy-MM-dd`	1430 2025-10-05
`HH:mm yyyy-MM-dd`	14:30 2025-10-05
`HHmm yyyy/MM/dd`	1430 2025/10/05
`HH:mm yyyy/MM/dd`	14:30 2025/10/05
`HHmm dd-MM-yyyy`	1430 05-10-2025
`HH:mm dd-MM-yyyy`	14:30 05-10-2025
`HHmm dd/MM/yyyy`	1430 05/10/2025
`HH:mm dd/MM/yyyy`	14:30 05/10/2025
`HHmm yyyy MMM dd`	1430 2025 Oct 05
`HH:mm yyyy MMM dd`	14:30 2025 Oct 05
`HHmm MMM dd yyyy`	1430 Oct 05 2025
`HH:mm MMM dd yyyy`	14:30 Oct 05 2025
`HHmm dd MMM yyyy`	1430 05 Oct 2025
`HH:mm dd MMM yyyy`	14:30 05 Oct 2025

Date-Only Formats

Format Pattern	Example
`yyyy-MM-dd`	2025-10-05
`yyyy/MM/dd`	2025/10/05
`dd-MM-yyyy`	05-10-2025
`dd/MM/yyyy`	05/10/2025
`MMM dd yyyy`	Oct 05 2025
`dd MMM yyyy`	05 Oct 2025
`yyyy MMM dd`	2025 Oct 05

Time-Only Formats

Format Pattern	Example
`HHmm`	1430
`HH:mm`	14:30
`hhmm a`	0230 PM
`hhmma`	0230PM
`hmm a`	230 PM
`hmma`	230PM
`hh:mm a`	02:30 PM
`hh:mma`	02:30PM
`h:mm a`	2:30 PM
`h:mma`	2:30PM

ip

Reverie: User Guide

Table of Contents

Quick Start

Features

Understanding Commands

Adding Tasks: todo, deadline, event

Todo: todo

Deadline: deadline

Event: event