eq 0.1.0

Terminal-based task manager using the Eisenhower Matrix method.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101

<div align="center">
  <img src="assets/logo.png" alt="eq Logo" width="120"/>
  <h1>EQ</h1>
  <p><strong>Focus on what matters.</strong></p>
  <p>
    <a href="https://xiaolong-y.github.io/eq/">Website</a> •
    <a href="#installation">Installation</a> •
    <a href="#features">Features</a>
  </p>
</div>

---

**eq** is a terminal-based task manager designed for speed and focus. It uses the Eisenhower Matrix to prioritize tasks by urgency and importance, keeping your workflow efficient and keyboard-driven.

## Installation

```bash
cargo install --path .
```

## Features

- **Eisenhower Matrix**
  Automatically sorts tasks into four quadrants: Do First, Schedule, Delegate, and Drop.

- **Zen Mode**
  A distraction-free interface with a built-in Pomodoro timer and floating particles to help you maintain flow.

- **AI Integration**
  Chat with your tasks. The AI helps you prioritize, break down complex projects, and organize your day.

- **Keyboard Driven**
  Navigate and manage tasks entirely from your keyboard using Vim-like shortcuts.

- **Privacy First**
  All data is stored locally on your machine.

## Usage

Launch the interactive interface:

```bash
eq tui
```

### Shortcuts

| Key | Action |
| :--- | :--- |
| `a` | Add task |
| `d` | Toggle done |
| `x` | Delete task |
| `z` | Zen Mode |
| `c` | AI Chat |
| `Tab` | Switch Quadrant |
| `?` | Help |

### CLI

Add tasks directly from your terminal:

```bash
# Add a high-priority task (Urgency 3, Importance 3)
eq add "Fix server crash !!!$$$"

# Add a scheduled task (Urgency 1, Importance 3)
eq add "Plan roadmap u1i3"

# View stats
eq stats
```

## Configuration

Data is stored in your system's standard application data directory. To enable AI features, set `OPENAI_API_KEY` in your environment or a `.env` file.action-free focus mode.
- **Pomodoro Timer**: Built-in 25-minute timer.
- **Visuals**: Floating particles to help you flow.
- **Single Task**: Focus on one thing at a time.

### AI Integration
- **Prioritization Help**: Ask AI how to categorize tasks.
- **Breakdown**: Split complex projects into steps.
- **Context Aware**: The AI knows your current task list.
- **Automatic Audit**: The AI helps you add tasks upon your confirmation. 

### CLI Usage
Add tasks quickly from your shell:
```bash
eq add "Fix server crash !!!$$$"   # High Urgency (3), High Importance (3) -> Q1
eq add "Buy milk u1i2"            # Urgency 1, Importance 2 -> Q3
eq add "Call Mom" --tomorrow      # Schedule for tomorrow
```

---

## Data
Data is stored locally in your system's standard data directory (e.g., `~/Library/Application Support/dev.quad_tasks.eq/` on macOS).
- `tasks.json`: Task database.
- `history.jsonl`: Event log.
- `chat_history.json`: Saved AI conversations.