---
project:
  name: OpenCode + Obsidian Integration
  status: active
  category: documentation
  source: live-verification
  created: 2026-01-06
  updated: 2026-04-19
  description: How OpenCode interacts with the Obsidian vault for task management
  tags: [documentation, opencode, obsidian, integration]
---

# OpenCode + Obsidian Integration

## Architecture

```
OpenCode Agent → Obsidian Vault (local filesystem)
```

The Obsidian vault lives at `/home/bear/homelabagentroot/obsidian-vault/` and is tracked in git alongside the infrastructure configs.

## Task Management

Tasks use Dataview queries embedded in `project.md` files:

```markdown
## Tasks
\```dataview
TASK
FROM "homelab/tasks"
WHERE !completed
SORT file.name ASC
\```
```

## Task File Structure

Tasks use the template in `Templates/task-template.md` with YAML frontmatter:

```yaml
---
task:
  project: "Project Name"
  status: pending|in_progress|completed|blocked
  priority: high|medium|low
  created: 2026-04-19
---
```

## Dashboard

The project dashboard (`Dashboard/project-status.md`) aggregates all projects via Dataview.

## Templates

| Template | Purpose |
|----------|---------|
| `Templates/project-template.md` | New project scaffolding |
| `Templates/task-template.md` | Task files |
| `Templates/service-template.md` | Service documentation |
| `Templates/script-template.md` | Script documentation |

## Related

- [[vault-readme.md|Vault Overview]]
- [[../ai-assistant/project.md|AI Assistant Config]]