F.R.I.D.A.Y ⚡

A dry, fast, local-first terminal productivity CLI.
Tasks. Habits. Streaks. Personality included.

---

🌐 Live on npm

npm install -g @sridattasai_v/friday
friday

Data and config live in ~/.friday/ — never inside the project.

---

✨ Features

• Task + Habit Tracking — add, complete, skip, delete from the terminal
• 14-day Dot Row — visual habit history (▓ done · ▒ skipped · ░ missed)
• Streak Tracking — per-habit streak counter with history log
• Accent Color System — entire UI palette derives from your chosen color
• Personality Engine — dry / warm / casual greeting styles via getResponse()
• Interactive Settings — arrow-key navigation, live preview, instant save
• Smart Suggestions — full command prefix matching as you type
• Local First — all data stays at ~/.friday/, no cloud, no accounts

---

🛠️ Tech Stack

• Runtime: Node.js 18+ (ESM modules throughout)
• UI: Ink v7 + React 19
• Banner: cfonts
• Storage: Local JSON via filesystem (~/.friday/)
• Build: tsx

---

💻 Commands

Command	Description
/add task <title>	Add a task
/add habit <title>	Add a recurring habit
/done <title>	Mark a task or habit done
/skip <title>	Skip a habit for today
/delete <title>	Delete a task or habit
/streak	Show habit streaks
/list	Reload and display all tasks
/clear	Remove completed tasks
/settings	Open interactive settings panel
/features	Open power commands panel
/help	Show all commands
/exit	Quit F.R.I.D.A.Y

---

⚙️ Settings

Open /settings — use ↑ ↓ to navigate, ← → to change values:

Setting	How to change
name	ENTER to edit · type · ENTER to confirm
greeting style	← → to cycle dry / warm / casual
banner color	← → for presets · h to type hex
banner font	← → to cycle cfonts fonts

All changes apply instantly and persist to ~/.friday/config.json.

---

📁 Project Structure

F.R.I.D.A.Y/
├── bin/
│   └── friday.js          # Entry point — shebang + ESM dynamic import
├── src/
│   ├── app.jsx            # Main Ink component (~950 lines)
│   └── Onboarding.jsx     # First-launch onboarding flow
├── core/
│   ├── commands.js        # Task/habit mutations (addTask, markDone, etc.)
│   ├── storage.js         # Read/write ~/.friday/data.json
│   ├── personality.js     # getResponse() personality engine
│   └── config.js          # Read/write ~/.friday/config.json
└── package.json

---

📸 Screenshots

Greeting screen

Main dashboard

Command suggestions

Exit screen

---

🚀 Local Development

git clone https://github.com/Sridattasai18/Friday
cd Friday
npm install
npm start

---

🗺️ Roadmap

• v1 — task + habit manager with personality engine ✅ (current)
• v2 — smart suggestions based on your usage patterns
• v3 — local AI agent via Ollama, fully offline, no API costs

---

🤝 Contributing

Issues and feature requests are welcome.
Check the issues page.

---

📄 License

MIT © sridattasai_v

---

👤 Author

Kaligotla Sri Datta Sai Vithal

• GitHub: @Sridattasai18
• npm: @sridattasai_v/friday

---

⭐ Star this repo if F.R.I.D.A.Y helps your day.