Skip to main content

Voice Task Management

Create, query, update, and complete tasks using voice commands.

Overview​

Manage your tasks hands-free through web voice or phone. Norns understands natural language and executes the appropriate tool through Bifrost.

Access Methods​

MethodHow to Access
Web VoiceGo to voice.ravenhelm.dev, click microphone
PhoneCall +1 (737) 214-3330
ChatGo to norns.ravenhelm.dev

Example Conversations​

Query Tasks​

You: "What is on my todo list?"

System Flow:

Voice Input → LiveKit → Voice Agent → Whisper (STT)
    → Norns Agent → Bifrost query_tasks tool
    → PostgreSQL tasks table → Response
    → Piper (TTS) → Audio Output

Norns: "You have 3 tasks. First, review the pull request for authentication, due today. Second, update the documentation, due tomorrow. Third, deploy the new voice features, no due date."

Create a Task​

You: "Add a task to call mom on Sunday"

System Flow:

Voice → STT → Norns → Bifrost create_task tool
    → PostgreSQL INSERT → Confirmation
    → TTS → Audio

Norns: "I have created a task to call mom, due Sunday January 5th."

Complete a Task​

You: "Mark the documentation task as done"

System Flow:

Voice → STT → Norns → Bifrost query_tasks (find match)
    → Bifrost complete_task tool
    → PostgreSQL UPDATE status=completed
    → TTS → Audio

Norns: "Done. I have marked update the documentation as complete."

Update a Task​

You: "Move the pull request review to tomorrow"

System Flow:

Voice → STT → Norns → Bifrost query_tasks (find match)
    → Bifrost update_task tool (new due_date)
    → PostgreSQL UPDATE → Confirmation
    → TTS → Audio

Norns: "I have updated the pull request review task to be due tomorrow, January 4th."

Query by Project​

You: "What tasks are in the Ravenhelm project?"

Norns: "The Ravenhelm project has 5 open tasks..."

Tool Reference​

query_tasks​

{
  "name": "query_tasks",
  "domain": "tasks",
  "input_schema": {
    "status": "open|completed|all",
    "project_id": "uuid (optional)",
    "due_before": "ISO date (optional)",
    "limit": "number (default 10)"
  }
}

create_task​

{
  "name": "create_task",
  "domain": "tasks",
  "input_schema": {
    "title": "string (required)",
    "description": "string (optional)",
    "due_date": "ISO date (optional)",
    "project_id": "uuid (optional)",
    "priority": "low|medium|high (optional)"
  }
}

update_task​

{
  "name": "update_task",
  "domain": "tasks",
  "input_schema": {
    "task_id": "uuid (required)",
    "title": "string (optional)",
    "description": "string (optional)",
    "due_date": "ISO date (optional)",
    "priority": "low|medium|high (optional)"
  }
}

complete_task​

{
  "name": "complete_task",
  "domain": "tasks",
  "input_schema": {
    "task_id": "uuid (required)"
  }
}

Troubleshooting​

Task Not Found​

Symptom: "I could not find a task matching that description"

Solution: Be more specific or use the exact task title. You can also ask "list all my tasks" first.

Voice Not Recognized​

Symptom: Norns asks you to repeat

Solutions:

  • Speak clearly and at moderate pace
  • Reduce background noise
  • Try rephrasing the request

Wrong Task Updated​

Symptom: A different task was modified

Solution: Use task titles verbatim or reference by number ("complete task 2")

See Also​

  • [[Daily-Summary]] - Get task overview
  • [[Voice-Calendar]] - Calendar integration
  • [[../Voice-Platform]] - Voice infrastructure