SHARE.mdā¢1.45 kB
# TickTick Command Line Client - Quick Share
Add tasks to TickTick from the command line!
## Setup (5 minutes)
1. **Install dependencies:**
```bash
pip install -r requirements.txt
```
2. **Get API credentials from TickTick:**
- Go to https://developer.ticktick.com/manage
- Create an app (any name)
- Set redirect URI to: `http://127.0.0.1:8080`
- Copy your Client ID and Client Secret
3. **Configure `.env` file:**
```bash
cp .env.example .env
# Edit .env with your credentials
```
4. **Authenticate (one time):**
```bash
python ticktick_rest_api.py --auth
```
This saves a token and you won't need to authenticate again.
## Usage
```bash
# Simple task
python add_task.py "Buy groceries"
# Task with project, priority, and due date
python add_task.py "Morning workout" --project Health --priority 5 --due today
# Task with long description
python add_task.py "Weekly check-in" --content "$(cat <<'EOF'
1. What went well?
2. What needs work?
3. Next week goals?
EOF
)"
```
**Parameters:**
- `--content "text"` - Task description
- `--project Name` - Add to specific project
- `--priority 0-5` - Priority (5=High, 3=Medium, 1=Low, 0=None)
- `--due YYYY-MM-DD` - Due date (or "today"/"tomorrow")
## Full Documentation
See [GETTING-STARTED.md](GETTING-STARTED.md) for complete setup instructions and examples.
---
**That's it!** Add tasks from anywhere, sync with TickTick app on all devices.