https://github.com/bborbe/vault-cli
Go library for managing Obsidian tasks and goals across multiple vaults
https://github.com/bborbe/vault-cli
Last synced: 3 months ago
JSON representation
Go library for managing Obsidian tasks and goals across multiple vaults
- Host: GitHub
- URL: https://github.com/bborbe/vault-cli
- Owner: bborbe
- License: bsd-2-clause
- Created: 2026-02-27T13:13:49.000Z (3 months ago)
- Default Branch: master
- Last Pushed: 2026-02-27T21:24:09.000Z (3 months ago)
- Last Synced: 2026-02-27T21:26:21.098Z (3 months ago)
- Language: Go
- Size: 120 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# vault-cli
[](https://pkg.go.dev/github.com/bborbe/vault-cli)
[](https://github.com/bborbe/vault-cli/actions/workflows/ci.yml)
[](https://goreportcard.com/report/github.com/bborbe/vault-cli)
Go CLI tool for managing Obsidian vault tasks, goals, and themes.
## Overview
Fast CRUD operations for Obsidian markdown files (tasks, goals, themes) without spawning full Claude Code sessions. Reduces TaskOrchestrator operation latency from 2-5 seconds to <100ms.
## Installation
```bash
go install github.com/bborbe/vault-cli@latest
```
## Configuration
Create `~/.vault-cli/config.yaml`:
```yaml
default_vault: personal
vaults:
personal:
name: personal
path: ~/Documents/Obsidian/Personal
tasks_dir: "24 Tasks"
goals_dir: "23 Goals"
daily_dir: "60 Periodic Notes/Daily"
brogrammers:
name: brogrammers
path: ~/Documents/Obsidian/Brogrammers
tasks_dir: "40 Tasks"
daily_dir: "60 Periodic Notes/Daily"
```
## Usage
```bash
# Complete a task
vault-cli complete "Build vault-cli Go Tool"
# Complete a task in a specific vault
vault-cli --vault brogrammers complete "Some Task"
# Defer a task
vault-cli defer "Migrate TaskOrchestrator" +7d
vault-cli defer "Migrate TaskOrchestrator" monday
vault-cli defer "Migrate TaskOrchestrator" 2026-03-01
# Update task progress from checkboxes
vault-cli update "Build vault-cli Go Tool"
# Use custom config file
vault-cli --config /path/to/config.yaml complete "Some Task"
```
## Development
```bash
make test # Run tests
make check # Linting and checks
make precommit # Full development workflow
```
## License
BSD-2-Clause