Tiimeer.com - Command Guide
Developed by Wox4us, Co
https://wox4us.com/

OVERVIEW
This app is a terminal focus timer with a coffee-inspired interface.
It lets you create orders, run focus sessions, mark work as done, and review progress.

The app stores your data in:
brew_state.json

Installed command:
tiimeer


QUICK START
If you installed Tiimeer globally, run:

tiimeer

If you are running the local source file directly, use:

python coffee_timer.py

This will ask:
1. What would you like to do?
2. How long would you like to focus on it (in minutes)?

Then it starts the timer automatically.


AVAILABLE COMMANDS

1. Add a new order
tiimeer add <order title>

Example:
tiimeer add Finish homepage copy

Local source alternative:
python coffee_timer.py add <order title>

Example:
python coffee_timer.py add Finish homepage copy


2. View active orders
tiimeer list

Local source alternative:
python coffee_timer.py list

This shows orders that are not marked as done yet.


3. View all orders
tiimeer list --all

Local source alternative:
python coffee_timer.py list --all

This shows both active and completed orders.


4. View completed orders only
tiimeer history

Local source alternative:
python coffee_timer.py history


5. Start a focus timer for an order
tiimeer start <id>

Example:
tiimeer start 2

You can also set custom times:
tiimeer start 2 --minutes 25 --refill 5

Local source alternative:
python coffee_timer.py start <id>

Example:
python coffee_timer.py start 2

You can also set custom times:
python coffee_timer.py start 2 --minutes 25 --refill 5

Options:
--minutes <number>     Focus time in minutes
--refill <number>      Refill break time in minutes
--skip-refill          Skip the refill prompt after the session


6. Mark an order as done
tiimeer done <id>

Example:
tiimeer done 2

Local source alternative:
python coffee_timer.py done <id>

Example:
python coffee_timer.py done 2

This marks the order as completed.


7. Mark an order as served
tiimeer serve <id>

Local source alternative:
python coffee_timer.py serve <id>

This does the same final completion action in the current version.


8. Delete an order
tiimeer delete <id>

Example:
tiimeer delete 3

Delete without confirmation:
tiimeer delete 3 -y

Local source alternative:
python coffee_timer.py delete <id>

Example:
python coffee_timer.py delete 3

Delete without confirmation:
python coffee_timer.py delete 3 -y


9. Show stats
tiimeer stats

Local source alternative:
python coffee_timer.py stats

This shows:
- Cups served today
- Brews completed
- Strong roast streak


10. Show dashboard
tiimeer dashboard

Local source alternative:
python coffee_timer.py dashboard

This shows:
- Stats
- Current orders
- Command help summary


TIMER CONTROLS
While a timer is running, use these keys:

P = Pause or resume the timer
E = Extend the current focus session by 5 minutes
B = Start a 5-minute break
D = Mark the current order as done
H = Show or hide completed order history
Q = Stop the current timer


ORDER STATES
The app may show orders with these states:

On deck      = waiting to be worked on
Brewing...   = currently active
Let it cool  = paused or stopped before completion
Served       = completed


EXTRA NOTES
- If you mark an order as done in guided mode, the app asks what you want to brew next.
- Completed orders can be reviewed with the history command or by pressing H during a timer.
- The app is designed for Command Prompt / terminal use only.


OPTIONAL STYLE
If you are running the local source file directly, you can also include the word "brew" before commands:

python coffee_timer.py brew list
python coffee_timer.py brew start 1

This is optional. The commands work without it too.