npm package: @sridattasai_v/friday
Description: F.R.I.D.A.Y — terminal productivity CLI. Tasks, habits, streaks.
Author: sridattasai_v
Latest version: 1.0.1

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

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

[![npm](https://img.shields.io/npm/v/@sridattasai_v/friday?color=cc8b3c&label=npm)](https://www.npmjs.com/package/@sridattasai_v/friday)
[![node](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org)
[![license](https://img.shields.io/badge/license-MIT-blue)](./LICENSE)
[![version](https://img.shields.io/badge/version-1.0.0-violet)](https://github.com/Sridattasai18/Friday/releases)

---

## 🌐 Live on npm

```bash
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](https://github.com/vadimdemedes/ink) v7 + React 19
- **Banner:** [cfonts](https://github.com/dominikwilkowski/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

![Greeting screen](./Greeting-Screen.png)

### Main dashboard

![Dashboard](./Main-dashboards.png)

### Command suggestions

![Command suggestions](./Command-suggestions.png)

### Exit screen

![Exit screen](./Exit-screen.png)

---

## 🚀 Local Development

```bash
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](https://github.com/Sridattasai18/Friday/issues).

---

## 📄 License

MIT © [sridattasai_v](https://github.com/Sridattasai18)

---

## 👤 Author

**Kaligotla Sri Datta Sai Vithal**

- GitHub: [@Sridattasai18](https://github.com/Sridattasai18)
- npm: [@sridattasai_v/friday](https://www.npmjs.com/package/@sridattasai_v/friday)

---

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