#obsidian #vault #vaults #backup #goto #blazing #git

app obs

A blazing fast & lightweight CLI tool for interacting with the Obsidian vaults

1 unstable release

0.1.0 Mar 4, 2023

#8 in #vaults

48 downloads per month

MIT license

9MB
220 lines


obs - the Obsidian CLI

⚡️ Connecting your second brain to the termainl - blazing fast ⚡️

Note 🚧

  • obs is under active development and currently only support MacOS, please report any issue while using!

Features

  • Fast & easy access to vaults from terminal in seconds
  • Backup your vault to remote git effortlessly
  • Flat learning curve without the need to memorize complciated commands
  • Automatically fetch vault list from Obsidian, no extra config needed

animated

Usage

  • obs : open up a menu for choosing actions and vault to interact with
    • goto : goto vault
    • open : open vault
    • backup : backup vault
  • obs --goto <GOTO> : cd to the directory of vault <GOTO>
  • obs --open <OPEN> : open the vault <OPEN> in Obsidian
  • obs --help : show help

animated

Getting Started

  1. Clone this repo
  2. Install obs
cargo install --path .
  1. Put this in your .zshrc (or equivalent)
obs() {
    local result=$(command obs "$@")
    [ -n "$result" ] && cd -- "$result"
}
  1. obs

Roadmap

  • add clap and -h
  • imporve README
  • add obsidian-git support
  • improve error handling

License

MIT @ 2023: Distributed under the MIT License.

Dependencies

~4–12MB
~132K SLoC