# DOXA-TODO 🦅

**Local-First Todo Manager** - A minimalist terminal-based todo application for managing your tasks with support for categories, priorities, and tags.

## Features

- **Dual Language Support**: Czech and English (toggle with `l` key)
- **Categories**: Personal and Work tasks
- **Priorities**: 3 levels (Low, Medium, High)
- **Tags**: Support for tagging todos
- **Automatic Date**: Creation and modification timestamps
- **Persistent Storage**: Todos are saved to `~/.doxa-todo/doxa_todo.json`
- **Search & Filter**: Search by text, browse by tags, filter by category
- **Export**: Export individual todos to text files

## Installation

### Using install.sh (Recommended)

```bash
# Clone the repository
git clone https://codeberg.org/Kankys/doxa-todo.git
cd doxa-todo

# Make install.sh executable and run it
chmod +x install.sh
./install.sh
```

The script will:
1. Check for Go installation
2. Download dependencies
3. Compile the application
4. Install to `~/.local/bin`
5. Create configuration directory at `~/.doxa-todo`

### Manual Installation

```bash
# Clone the repository
git clone https://codeberg.org/Kankys/doxa-todo.git
cd doxa-todo

# Build the application
go build -o doxa-todo .

# Install to your PATH
cp doxa-todo ~/.local/bin/
chmod +x ~/.local/bin/doxa-todo

# Make sure ~/.local/bin is in your PATH
export PATH=$PATH:~/.local/bin
```

## Usage

### Keyboard Shortcuts

| Key | Action |
|-----|--------|
| `Enter` | Start application / View selected todo |
| `q` | Quit application / Go back |
| `Esc` | Go back / Clear search |
| `1` | Add new todo |
| `2` | Edit selected todo |
| `3` | Export selected todo |
| `4` | Delete selected todo |
| `/` | Search todos |
| `b` | Browse tags |
| `c` | Filter by category |
| `l` | Toggle language (Czech/English) |
| `+` | Increase priority (when adding/editing) |
| `↑/↓` or `j/k` | Navigate through list |
| `Tab` | Switch between fields |

### Todo Structure

Each todo has:
- **Title** (required)
- **Description** (optional)
- **Priority**: Low (●), Medium (●), High (●) - with color coding
- **Category**: Personal (🏠) or Work (💼)
- **Tags**: Comma-separated list
- **Created At**: Automatic timestamp
- **Modified At**: Automatic timestamp on edits

### Storage

All todos are stored in JSON format at:
```
~/.doxa-todo/doxa_todo.json
```

Exported todos are saved to:
```
~/doxa-todo-export/
```

## Configuration

The application automatically creates the configuration directory and file on first run.

## License

MIT License - Copyright (c) 2026 Kankys

## Author

Kankys - [Codeberg](https://codeberg.org/Kankys)

## Related Projects

- [doxa-cli](https://codeberg.org/Kankys/doxa-cli) - Local-First Notes Manager
- [doxa-secret](https://codeberg.org/Kankys/doxa-secret) - Message Encryption Tool