Todozi Eisenhower matrix API client + LangChain tools. Create matrices, tasks, goals, notes; list/search/update; bulk operations; webhooks. Categories: do, done, dream, delegate, defer, dont.
**As SDK:**
```python
from skills.todozi.scripts.todozi import TodoziClient
client = TodoziClient(api_key="your_key")
matrices = await client.list_matrices()
task = await client.create_task("Build feature", priority="high")
await client.complete_item(task.id)
```
**As LangChain Tools:**
```python
from skills.todozi.scripts.todozi import TODOZI_TOOLS
```
| Class | Purpose |
|-------|---------|
| `TodoziClient` | Async API client |
| `TodoziTask` | Task dataclass |
| `TodoziMatrix` | Matrix dataclass |
| `TodoziStats` | Stats dataclass |
```bash
export TODOZI_API_KEY=your_key
export TODOZI_BASE=https://todozi.com/api # optional, default provided
```
```python
matrices = await client.list_matrices()
matrix = await client.create_matrix("Work", category="do")
matrix = await client.get_matrix("matrix_id")
await client.delete_matrix("matrix_id")
```
```python
task = await client.create_task(
title="Review PR",
priority="high",
due_date="2026-02-01",
description="Check the new feature",
tags=["pr", "review"],
)
goal = await client.create_goal("Ship v2", priority="high")
note = await client.create_note("Remember to call Mom")
item = await client.get_item("item_id")
updated = await client.update_item("item_id", {"title": "New title", "priority": "low"})
await client.complete_item("item_id")
await client.delete_item("item_id")
```
```python
tasks = await client.list_tasks(status="todo", priority="high")
goals = await client.list_goals()
notes = await client.list_notes()
all_items = await client.list_all()
```
**Searches only:** title, description, tags (NOT content)
```python
results = await client.search(
query="pr",
type_="task", # task, goal, or note
status="pending",
priority="high",
category="do",
tags=["review"],
limit=10,
)
```
```python
await client.bulk_update([
{"id": "id1", "title": "Updated"},
{"id": "id2", "priority": "low"},
])
await client.bulk_complete(["id1", "id2"])
await client.bulk_delete(["id1", "id2"])
```
```python
webhook = await client.create_webhook(
url="https://yoururl.com/todozi",
events=["item.created", "item.completed"],
)
webhooks = await client.list_webhooks()
await client.update_webhook(webhook_id, url, ["*"])
await client.delete_webhook(webhook_id)
```
```python
stats = await client.get_stats()
health = await client.health_check()
valid = await client.validate_api_key()
keys = await client.register(webhook="https://url.com")
```
The skill provides `@tool` decorated functions for agent integration:
```python
from skills.todozi.scripts.todozi import TODOZI_TOOLS
```
| Category | Description |
|----------|-------------|
| `do` | Do now (urgent + important) |
| `delegate` | Delegate (urgent + not important) |
| `defer` | Defer (not urgent + important) |
| `done` | Completed items |
| `dream` | Goals/dreams (not urgent + not important) |
| `dont` | Don't do (neither) |
**Auto-create default matrix:**
```python
task = await client.create_task("My task") # Creates "Default" matrix if needed
```
**Get stats with completion rate:**
```python
stats = await client.get_stats()
rate = stats.completed_tasks / stats.total_tasks * 100 if stats.total_tasks > 0 else 0
```
**Search with multiple filters:**
```python
results = await client.search("feature", type_="task", status="pending", priority="high")
```
**Complete multiple tasks:**
```python
tasks = await client.list_tasks(status="todo")
ids = [t.id for t in tasks[:5]]
await client.bulk_complete(ids)
```
Leave a review
No reviews yet. Be the first to review this skill!