daemora 1.0.1 → 1.0.3

package/skills/things.md

@@ -1,184 +1,20 @@
 ---
 name: things
-description: Manage Things 3 tasks, projects, and areas on macOS. Create todos with due dates, deadlines, checklists, tags, and notes. List inbox, today, upcoming, and anytime tasks. Search and update existing tasks. Use when the user asks to add a task to Things, check their to-do list, create a project, or manage Things 3. macOS only — requires Things 3 app installed.
+description: Manage Things 3 tasks, projects, and areas on macOS. Create todos with due dates, deadlines, checklists, tags, and notes. List inbox, today, and upcoming tasks. Use when the user asks to add a task to Things, check their to-do list, create a project, or manage Things 3.
 triggers: things, things 3, add task, todo, to-do, create task, things inbox, things today, upcoming tasks, things project, things area, things tag
+metadata: {"daemora": {"emoji": "✅", "install": ["brew install --cask things"], "os": ["darwin"]}}
 ---
 
-## When to Use
-
-✅ Add todos with dates/tags/projects, read inbox/today/upcoming, search tasks, move to a project, mark complete, create checklists
-
-❌ Complex project management across teams (use Trello) — Things is personal task management; no API, no web access
-
-## Requirements
-
-- macOS with Things 3 installed (`brew install --cask things`)
-- For read operations: grant Full Disk Access to Terminal/Daemora in System Settings → Privacy & Security
-- For write operations: Things URL scheme (no extra permissions needed)
-
-## Read Tasks
+## Add task (URL scheme - no permissions needed)
 
 ```bash
-# Find Things 3 database
-THINGS_DB=$(find ~/Library/Group\ Containers -name "*.sqlite3" -path "*Things3*" 2>/dev/null | head -1)
-echo "DB: $THINGS_DB"
-
-# List today's tasks
-sqlite3 "$THINGS_DB" "
-SELECT title, dueDate, notes
-FROM TMTask
-WHERE status = 0
-  AND (startDate <= strftime('%s','now') OR startDate IS NULL)
-  AND trashed = 0
-ORDER BY dueDate ASC
-LIMIT 20;"
-```
-
-## Python Helper (Read + Write)
-
-```python
-#!/usr/bin/env python3
-import subprocess, glob, sqlite3, os, urllib.parse
-from datetime import datetime, date
-from pathlib import Path
-
-# ── Read: direct SQLite access ─────────────────────────────────────────────
-
-def find_db() -> str:
-    """Locate Things 3 SQLite database."""
-    patterns = [
-        os.path.expanduser("~/Library/Group Containers/*/Things/Database5/main.sqlite"),
-        os.path.expanduser("~/Library/Group Containers/*/ThingsData-*/Things/Database5/main.sqlite"),
-    ]
-    for p in patterns:
-        matches = glob.glob(p)
-        if matches:
-            return matches[0]
-    raise FileNotFoundError("Things 3 database not found. Make sure Things 3 is installed and has been opened at least once.")
-
-def get_tasks(area: str = None, tag: str = None, limit: int = 30) -> list[dict]:
-    """Get pending tasks from Things 3."""
-    db_path = find_db()
-    conn = sqlite3.connect(db_path)
-    conn.row_factory = sqlite3.Row
-    cur = conn.cursor()
-
-    query = """
-        SELECT t.uuid, t.title, t.notes, t.dueDate, t.deadline,
-               p.title as project, a.title as area
-        FROM TMTask t
-        LEFT JOIN TMTask p ON t.project = p.uuid
-        LEFT JOIN TMArea a ON t.area = a.uuid
-        WHERE t.status = 0 AND t.trashed = 0 AND t.type = 0
-    """
-    params = []
-    if area:
-        query += " AND a.title LIKE ?"
-        params.append(f"%{area}%")
-    if tag:
-        query += """ AND t.uuid IN (
-            SELECT task FROM TMTaskTag tt
-            JOIN TMTag tg ON tt.tag = tg.uuid
-            WHERE tg.title LIKE ?)"""
-        params.append(f"%{tag}%")
-    query += f" ORDER BY t.dueDate ASC NULLS LAST LIMIT {limit}"
-
-    rows = cur.execute(query, params).fetchall()
-    conn.close()
-    return [dict(r) for r in rows]
-
-def get_today() -> list[dict]:
-    """Get tasks scheduled for today or overdue."""
-    db_path = find_db()
-    today_ts = int(datetime.combine(date.today(), datetime.min.time()).timestamp())
-    conn = sqlite3.connect(db_path)
-    conn.row_factory = sqlite3.Row
-    cur = conn.cursor()
-    rows = cur.execute("""
-        SELECT t.uuid, t.title, t.notes, t.dueDate, t.deadline
-        FROM TMTask t
-        WHERE t.status = 0 AND t.trashed = 0 AND t.type = 0
-          AND t.startDate IS NOT NULL AND t.startDate <= ?
-        ORDER BY t.dueDate ASC NULLS LAST
-    """, (today_ts,)).fetchall()
-    conn.close()
-    return [dict(r) for r in rows]
-
-# ── Write: Things URL scheme ────────────────────────────────────────────────
-
-def add_task(
-    title: str,
-    notes: str = "",
-    when: str = "",          # "today", "tomorrow", "evening", "anytime", "someday", or "YYYY-MM-DD"
-    deadline: str = "",      # "YYYY-MM-DD"
-    tags: list[str] = None,
-    list_name: str = "",     # project or area name
-    checklist: list[str] = None,
-    heading: str = "",
-) -> str:
-    """Add a task to Things 3 using the URL scheme."""
-    params = {"title": title}
-    if notes:       params["notes"]    = notes
-    if when:        params["when"]     = when
-    if deadline:    params["deadline"] = deadline
-    if tags:        params["tags"]     = ",".join(tags)
-    if list_name:   params["list"]     = list_name
-    if heading:     params["heading"]  = heading
-    if checklist:
-        params["checklist-items"] = "\n".join(checklist)
-
-    encoded = urllib.parse.urlencode(params)
-    url = f"things:///add?{encoded}"
-    subprocess.run(["open", url])
-    return url
-
-def add_project(title: str, notes: str = "", area: str = "", when: str = "") -> None:
-    """Create a new project in Things 3."""
-    params = {"title": title}
-    if notes: params["notes"] = notes
-    if area:  params["area"]  = area
-    if when:  params["when"]  = when
-    encoded = urllib.parse.urlencode(params)
-    subprocess.run(["open", f"things:///add-project?{encoded}"])
-```
-
-## Usage Examples
-
-```python
-# Add a simple task
-add_task("Buy groceries")
-
-# Task with date and tags
-add_task(
-    "Quarterly report",
-    notes="See shared doc in Drive",
-    when="2026-03-15",
-    deadline="2026-03-20",
-    tags=["work", "report"],
-    list_name="Q1 Planning"
-)
-
-# Task with checklist
-add_task(
-    "Deploy v2.0",
-    checklist=["Run test suite", "Update CHANGELOG", "Tag release", "Deploy to prod", "Notify team"],
-    list_name="Engineering",
-    when="today"
-)
-
-# Read today's tasks
-tasks = get_today()
-print(f"📋 Today ({len(tasks)} tasks):")
-for t in tasks:
-    print(f"  □ {t['title']}")
-
-# Read tasks in a project
-tasks = get_tasks(area="Work")
-for t in tasks:
-    print(f"  □ {t['title']} [{t.get('project', 'no project')}]")
+open "things:///add?title=Buy+groceries&when=today&tags=personal"
+open "things:///add?title=Deploy+v2&when=2026-03-15&deadline=2026-03-20&list=Engineering"
+open "things:///add-project?title=Q1+Planning&notes=..."
+# Checklist items: &checklist-items=Step+1%0AStep+2%0AStep+3 (newline-separated, URL-encoded)
 ```
 
-## `when` Values
+## `when` values
 
 | Value | Meaning |
 |-------|---------|
@@ -189,11 +25,23 @@ for t in tasks:
 | `someday` | Someday |
 | `YYYY-MM-DD` | Specific date |
 
-## Error Handling
+## Read tasks (SQLite - requires Full Disk Access)
+
+```bash
+THINGS_DB=$(find ~/Library/Group\ Containers -name "main.sqlite" -path "*Things*" 2>/dev/null | head -1)
+sqlite3 "$THINGS_DB" "SELECT title, dueDate FROM TMTask WHERE status=0 AND trashed=0 AND type=0 ORDER BY dueDate ASC LIMIT 20;"
+```
+
+## Workflow
+
+1. **Adding tasks** → use the `things:///add` URL scheme (no permissions needed)
+2. **Reading tasks** → query the SQLite database with `executeCommand`
+3. **With checklists** → pass `checklist-items` URL param, newline-separated, URL-encoded
+
+## Errors
 
 | Error | Fix |
 |-------|-----|
 | DB not found | Open Things 3 first; try `find ~/Library -name "*.sqlite3" 2>/dev/null \| grep -i things` |
-| Permission denied on DB | System Settings → Privacy & Security → Full Disk Access → add Terminal |
+| Permission denied on DB | System Settings → Privacy → Full Disk Access → add Terminal |
 | URL scheme not working | Ensure Things 3 is installed (`ls /Applications/Things3.app`) |
-| Task not appearing | Things syncs on open; click "Things" in dock to bring to front |

package/skills/tmux.md

@@ -13,7 +13,7 @@ triggers: tmux, terminal session, background session, tmux window, tmux pane, sp
 ## Check tmux is Available
 
 ```bash
-which tmux && tmux -V || echo "tmux not found — install with: brew install tmux"
+which tmux && tmux -V || echo "tmux not found - install with: brew install tmux"
 ```
 
 ## Session Management
@@ -71,51 +71,6 @@ tmux capture-pane -t mywork -p -S -500 > /tmp/session_output.txt
 tmux capture-pane -t mywork -p | tail -5
 ```
 
-## Python Helpers
-
-```python
-#!/usr/bin/env python3
-import subprocess, time
-
-def tmux_run(session: str, command: str, wait_seconds: float = 0.5) -> str:
-    """Send a command to a tmux session and capture output."""
-    subprocess.run(["tmux", "send-keys", "-t", session, command, "Enter"])
-    time.sleep(wait_seconds)
-    result = subprocess.run(
-        ["tmux", "capture-pane", "-t", session, "-p", "-S", "-100"],
-        capture_output=True, text=True
-    )
-    return result.stdout.strip()
-
-def tmux_session_exists(session: str) -> bool:
-    result = subprocess.run(["tmux", "has-session", "-t", session], capture_output=True)
-    return result.returncode == 0
-
-def tmux_get_output(session: str, lines: int = 50) -> str:
-    result = subprocess.run(
-        ["tmux", "capture-pane", "-t", session, "-p", "-S", f"-{lines}"],
-        capture_output=True, text=True
-    )
-    return result.stdout.strip()
-
-def tmux_ensure_session(session: str) -> None:
-    """Create session if it doesn't exist."""
-    if not tmux_session_exists(session):
-        subprocess.run(["tmux", "new-session", "-d", "-s", session, "-x", "220", "-y", "50"])
-        print(f"Created tmux session: {session}")
-    else:
-        print(f"Using existing session: {session}")
-
-# Example: run a dev server in tmux and monitor it
-tmux_ensure_session("devserver")
-output = tmux_run("devserver", "npm run dev", wait_seconds=2.0)
-print(f"Server output:\n{output}")
-
-# Later: check if server is still running
-current = tmux_get_output("devserver", lines=10)
-print(f"Current output:\n{current}")
-```
-
 ## Split Panes (Parallel Work)
 
 ```bash
@@ -138,51 +93,6 @@ tmux split-window -v -t monitor:0.1
 tmux send-keys -t monitor:0.2 "watch -n 2 df -h" Enter
 ```
 
-## Monitor a Long-Running Task
-
-```python
-#!/usr/bin/env python3
-"""Start a task in tmux and poll until it's done."""
-import subprocess, time, re
-
-def run_and_monitor(session: str, command: str, done_pattern: str, timeout: int = 300):
-    """
-    Run command in tmux and wait until output matches done_pattern.
-    Returns final output.
-    """
-    # Ensure session exists
-    subprocess.run(["tmux", "new-session", "-d", "-s", session, "-x", "220", "-y", "50"],
-                   capture_output=True)  # ignore error if exists
-
-    subprocess.run(["tmux", "send-keys", "-t", session, command, "Enter"])
-    print(f"Started: {command}")
-
-    start = time.time()
-    while time.time() - start < timeout:
-        time.sleep(3)
-        result = subprocess.run(
-            ["tmux", "capture-pane", "-t", session, "-p", "-S", "-50"],
-            capture_output=True, text=True
-        )
-        output = result.stdout
-        if re.search(done_pattern, output, re.IGNORECASE):
-            print(f"✅ Done (matched: {done_pattern})")
-            return output
-
-    print(f"⚠️ Timed out after {timeout}s")
-    return subprocess.run(["tmux", "capture-pane", "-t", session, "-p", "-S", "-50"],
-                          capture_output=True, text=True).stdout
-
-# Example
-output = run_and_monitor(
-    session="build",
-    command="npm run build",
-    done_pattern=r"build complete|error|failed",
-    timeout=120
-)
-print(output[-500:])  # show last 500 chars
-```
-
 ## Useful Shortcuts Reference
 
 ```

package/skills/trello.md

@@ -1,183 +1,58 @@
 ---
 name: trello
-description: Manage Trello boards, lists, and cards using the Trello REST API. Use when the user asks to create a Trello card, move a card, list boards, add a checklist, archive a card, or automate Trello workflows. Requires TRELLO_API_KEY and TRELLO_TOKEN environment variables.
+description: Manage Trello boards, lists, and cards via the Trello REST API. Use when the user asks to create a Trello card, move a card, list boards, add a checklist, or automate Trello workflows. Requires TRELLO_API_KEY and TRELLO_TOKEN.
 triggers: trello, kanban, trello card, trello board, create card, move card, trello list, trello checklist, trello archive, trello label
+metadata: {"daemora": {"emoji": "📋"}}
 ---
 
-## When to Use
-
-✅ Create/update/move/archive cards, list boards and cards, add checklists, labels, due dates, comments, attach files, automate Trello workflows
-
-❌ Real-time push notifications (use Trello webhooks + a server endpoint) — use polling for monitoring instead
-
 ## Setup
 
-```bash
-# Get your API key: https://trello.com/app-key
-# Generate token from that page
+Get API key: https://trello.com/app-key (then generate token from that page)
 
+```bash
 export TRELLO_API_KEY="your_api_key"
 export TRELLO_TOKEN="your_token"
 
-# Quick test
-curl -s "https://api.trello.com/1/members/me/boards?key=${TRELLO_API_KEY}&token=${TRELLO_TOKEN}" \
+# Quick test: list boards
+curl -s "https://api.trello.com/1/members/me/boards?fields=name,id&key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" \
   | python3 -c "import sys,json; [print(b['name'], '→', b['id']) for b in json.load(sys.stdin)]"
 ```
 
-## Python Helper (use for all Trello calls)
+## Key API endpoints
 
-```python
-#!/usr/bin/env python3
-import os, json, urllib.request, urllib.parse
+Base: `https://api.trello.com/1` - always append `key=$TRELLO_API_KEY&token=$TRELLO_TOKEN`
 
-API_KEY = os.environ["TRELLO_API_KEY"]
-TOKEN   = os.environ["TRELLO_TOKEN"]
-BASE    = "https://api.trello.com/1"
+| Operation | Method | Endpoint |
+|-----------|--------|----------|
+| List boards | GET | `/members/me/boards?fields=name,id` |
+| Lists on board | GET | `/boards/{id}/lists?filter=open` |
+| Cards on board | GET | `/boards/{id}/cards?fields=name,idList,due` |
+| Cards in list | GET | `/lists/{id}/cards` |
+| Create card | POST | `/cards` |
+| Move card | PUT | `/cards/{id}` with `idList` param |
+| Archive card | PUT | `/cards/{id}` with `closed=true` |
+| Add comment | POST | `/cards/{id}/actions/comments` |
+| Add checklist | POST | `/checklists` with `idCard` param |
 
-def trello(method: str, path: str, **kwargs) -> dict | list:
-    """Make a Trello API call. kwargs become query params for GET, form data for POST/PUT."""
-    params = {"key": API_KEY, "token": TOKEN, **kwargs}
-    url = f"{BASE}{path}"
-    if method == "GET":
-        url += "?" + urllib.parse.urlencode(params)
-        req = urllib.request.Request(url)
-    else:
-        data = urllib.parse.urlencode(params).encode()
-        req = urllib.request.Request(url, data=data, method=method)
-    with urllib.request.urlopen(req) as resp:
-        return json.loads(resp.read())
-```
+## Create card example
 
-## List Boards
-
-```python
-boards = trello("GET", "/members/me/boards", fields="name,id,url,closed")
-open_boards = [b for b in boards if not b.get("closed")]
-for b in open_boards:
-    print(f"📋 {b['name']}  (id: {b['id']})")
-```
-
-## Get Lists on a Board
-
-```python
-board_id = "BOARD_ID_HERE"
-lists = trello("GET", f"/boards/{board_id}/lists", filter="open")
-for lst in lists:
-    print(f"  📁 {lst['name']}  (id: {lst['id']})")
-```
-
-## Get Cards on a Board / List
-
-```python
-# All cards on a board
-board_id = "BOARD_ID_HERE"
-cards = trello("GET", f"/boards/{board_id}/cards", fields="name,idList,due,desc,labels")
-for card in cards:
-    print(f"  🃏 {card['name']}  (due: {card.get('due', 'none')})")
-
-# Cards in a specific list
-list_id = "LIST_ID_HERE"
-cards = trello("GET", f"/lists/{list_id}/cards", fields="name,due,desc")
-```
-
-## Create a Card
-
-```python
-new_card = trello("POST", "/cards",
-    idList="LIST_ID_HERE",
-    name="Task: Fix login bug",
-    desc="## Description\nThe login form fails when email contains special characters.\n\n## Steps\n1. Go to /login\n2. Enter: user+test@example.com\n3. See error",
-    due="2026-03-15T09:00:00.000Z",  # ISO 8601
-    pos="top"  # or "bottom" or a position number
-)
-print(f"✅ Card created: {new_card['name']} → {new_card['url']}")
-```
-
-## Move Card to Another List
-
-```python
-card_id = "CARD_ID_HERE"
-target_list_id = "TARGET_LIST_ID"
-trello("PUT", f"/cards/{card_id}", idList=target_list_id)
-print("✅ Card moved")
-```
-
-## Add Checklist to Card
-
-```python
-card_id = "CARD_ID_HERE"
-
-# Create checklist
-checklist = trello("POST", "/checklists", idCard=card_id, name="Acceptance Criteria")
-
-# Add items
-for item in ["Tests pass", "Code reviewed", "Deployed to staging", "QA sign-off"]:
-    trello("POST", f"/checklists/{checklist['id']}/checkItems", name=item)
-
-print(f"✅ Checklist created with {4} items")
-```
-
-## Add Comment to Card
-
-```python
-card_id = "CARD_ID_HERE"
-trello("POST", f"/cards/{card_id}/actions/comments",
-    text="Investigated this issue — root cause is in auth.js:142. PR coming shortly.")
-```
-
-## Add Label to Card
-
-```python
-# First get or create a label
-board_id = "BOARD_ID_HERE"
-labels = trello("GET", f"/boards/{board_id}/labels")
-bug_label = next((l for l in labels if l.get("name") == "Bug"), None)
-
-if bug_label:
-    card_id = "CARD_ID_HERE"
-    trello("POST", f"/cards/{card_id}/idLabels", value=bug_label["id"])
-```
-
-## Archive (Close) a Card
-
-```python
-card_id = "CARD_ID_HERE"
-trello("PUT", f"/cards/{card_id}", closed="true")
-print("✅ Card archived")
+```bash
+curl -s -X POST "https://api.trello.com/1/cards" \
+  -d "key=$TRELLO_API_KEY&token=$TRELLO_TOKEN" \
+  -d "idList=LIST_ID&name=Task+title&desc=Description&due=2026-03-15T09:00:00.000Z&pos=top"
 ```
 
-## Full Workflow: Create Card from Task Description
-
-```python
-def add_task_to_trello(title: str, description: str, board_name: str = None, list_name: str = "To Do"):
-    """Find the right board/list and create a card."""
-    boards = trello("GET", "/members/me/boards", fields="name,id")
-    board = next((b for b in boards if board_name and board_name.lower() in b["name"].lower()), boards[0])
-
-    lists = trello("GET", f"/boards/{board['id']}/lists", filter="open")
-    target_list = next((l for l in lists if list_name.lower() in l["name"].lower()), lists[0])
+## Move card example
 
-    card = trello("POST", "/cards",
-        idList=target_list["id"],
-        name=title,
-        desc=description,
-        pos="top"
-    )
-    return card["url"]
-
-url = add_task_to_trello(
-    "Research competitor pricing",
-    "## Goal\nAnalyze top 5 competitor pricing pages\n\n## Deliverable\nComparison spreadsheet",
-    board_name="Marketing"
-)
-print(f"Card created: {url}")
+```bash
+curl -s -X PUT "https://api.trello.com/1/cards/CARD_ID" \
+  -d "key=$TRELLO_API_KEY&token=$TRELLO_TOKEN&idList=TARGET_LIST_ID"
 ```
 
-## Error Handling
+## Errors
 
 | Error | Fix |
 |-------|-----|
-| 401 Unauthorized | Check `TRELLO_API_KEY` and `TRELLO_TOKEN` are set and valid |
-| 404 Not Found | Board/list/card ID is wrong; list boards/lists first to get correct IDs |
-| 429 Rate Limited | Trello allows ~300 req/10s; add `time.sleep(0.1)` between bulk calls |
-| Card won't move | Verify target list is on same board as card |
+| 401 Unauthorized | Check `TRELLO_API_KEY` and `TRELLO_TOKEN` are valid |
+| 404 Not Found | Board/list/card ID is wrong - list boards/lists first to get correct IDs |
+| 429 Rate Limited | Add 100ms delay between bulk calls |