clings today             # or: clings t (default command)
clings inbox             # or: clings i
clings upcoming          # or: clings u
clings anytime
clings someday           # or: clings s
clings logbook           # or: clings l

# Organization
clings projects          # List all projects
clings areas             # List all areas
clings tags list         # List all tags
clings show <ID>         # Show details of a specific todo

clings add "draft changelog entry tomorrow #docs"
clings add "replace air filter friday 3pm #home !high"
clings add "finish reading list by dec 15 #reading"
clings add "review PR // needs careful testing - check auth - verify tests"

# Supported patterns:
# - Dates: today, tomorrow, next monday, in 3 days, dec 15
# - Times: 3pm, 15:00, morning, evening
# - Tags: #tag1 #tag2
# - Projects: for <Project Name>
# - Areas: in AreaName
# - Deadlines: by friday
# - Priority: !high, !!, !!!
# - Notes: // notes at the end
# - Checklist: - item1 - item2

clings add "Task title" \
  --when tomorrow \
  --deadline "2024-12-31" \
  --tags docs urgent \
  --project "Documentation" \
  --area "Writing" \
  --notes "Additional context"

# Preview without creating
clings add "Test task tomorrow #docs" --parse-only

# Text search (case-insensitive, searches title and notes)
clings search "meeting"
clings find "project report"     # alias for search
clings f "status"                # short alias

# Save and reuse named views
clings views save docs-today "tags CONTAINS 'docs' AND due <= today"
clings views run docs-today
clings views list

# Advanced filtering (SQL-like query language)
clings filter "status = open"
clings filter "due < today AND status = open"
clings filter "tags CONTAINS 'urgent'"
clings filter "name LIKE '%report%'"
clings filter "project IS NOT NULL"

# Custom todo-line formatting
clings today --format "{status} {name} [{project}] {tags}"

# Show details
clings show <ID>

# Interactive pick flows
clings pick show report
clings pick complete release
clings pick cancel cleanup

# Update properties
clings update <ID> --name "New title"
clings update <ID> --notes "Updated notes"
clings update <ID> --due 2024-12-25
clings update <ID> --tags work urgent

# Complete, cancel, or delete
clings complete <ID>             # or: clings done <ID>
clings complete --title "milk"   # complete by title search
clings cancel <ID>
clings delete <ID>               # or: clings rm <ID>
clings delete <ID> --force       # skip confirmation

# Undo supported recent changes
clings undo
clings undo --show

# ALWAYS preview changes first with --dry-run
clings bulk complete --where "tags CONTAINS 'done'" --dry-run

# Complete matching tasks
clings bulk complete --where "tags CONTAINS 'done'"

# Cancel archive prep tasks
clings bulk cancel --where "project = 'Archive Prep'"

# Tag matching tasks as urgent
clings bulk tag "urgent,priority" --where "tags CONTAINS 'docs'"

# Move tasks to a project
clings bulk move --where "tags CONTAINS 'draft'" --to "Archive"

clings stats              # Show dashboard
clings stats trends       # Completion trends over time
clings stats heatmap      # Activity heatmap calendar
clings stats --days 7     # Limit to last 7 days

# Focus mode
clings focus
clings focus --limit 5
clings focus --format "{name} [{project}]"

clings review             # Start a new review (default)
clings review start       # Same as above
clings review status      # Show last review session info
clings review clear       # Clear review session

# Audit open projects for stalled work
clings project audit
clings project audit --json

clings completions bash > ~/.bash_completion.d/clings
clings completions zsh > ~/.zfunc/_clings
clings completions fish > ~/.config/fish/completions/clings.fish

# Get your auth token from Things 3:
# Settings > General > Enable Things URLs > Copy auth token

# Save it to clings
clings config set-auth-token <your-token>

# Diagnose local setup
clings doctor
clings doctor --verbose

clings template save weekly-review "Weekly review" \
  --project "Documentation" \
  --when "tomorrow morning" \
  --checklist "Process inbox" "Review deadlines"

clings template list
clings template run weekly-review

# You can also combine a template with an explicit add command
clings add "Weekly review prep" --template weekly-review

brew install dan-hart/tap/clings

brew update && brew upgrade clings

# Clone the repository
git clone https://github.com/dan-hart/clings
cd clings

# Build release binary
swift build -c release

# Install to /usr/local/bin
cp .build/release/clings /usr/local/bin/

# View today's tasks
clings today

# Add a quick task
clings add "draft changelog entry tomorrow #docs"

# Save and run a reusable view
clings views save docs-today "tags CONTAINS 'docs' AND due <= today"
clings views run docs-today

# Save and reuse a template
clings template save weekly-review "Weekly review" --when "tomorrow morning"
clings template run weekly-review

# View your inbox
clings inbox

# Search for tasks
clings search "project"

# Filter by status and date
clings filter "due < today AND status = open"

# Get productivity stats
clings stats

# See your working queue
clings focus

# Check local setup
clings doctor

# Get help on any command
clings --help
clings add --help

clings today --json | jq '.items[] | select(.tags | contains(["docs"]))'

open "x-apple.systempreferences:com.apple.preference.security?Privacy_Automation"

swift build              # Build
swift run clings today   # Run in debug mode
swift test               # Run tests
bash scripts/asp-preflight.sh --staged --strict   # Safety preflight before commit
bash scripts/release-docs-check.sh                # Help/README/docs pre-release audit