Skip to content

ignission/thn

Repository files navigation

thn

Append memos to Obsidian daily notes from your terminal

CI Release License


thn demo

thn is a CLI tool compatible with the Thino plugin. Quickly capture memos from your terminal without opening Obsidian.

$ thn "Summarize the new feature decisions from the meeting"

Automatically appended to your daily note:

- 14:30 Summarize the new feature decisions from the meeting

Thino UI
View your memos in Thino's beautiful UI

✨ Features

  • ⚡ Fast: Capture memos without launching Obsidian
  • 🔄 Thino-compatible: Uses - HH:MM memo format for Thino UI integration
  • ⚙️ Zero config: Automatically reads Obsidian settings
  • 🔇 UNIX philosophy: Silent on success, output only on error

📦 Installation

Homebrew (macOS / Linux)

brew install ignission/tap/thn

Cargo (Rust)

cargo install --git https://github.com/ignission/thn

Binary

Download from Releases

🚀 Quick Start

1. Configure your vault

# Interactive mode
$ thn --init
Vault path: /Users/you/Documents/MyVault

# Or specify directly
$ thn --init /path/to/vault

2. Append a memo

$ thn "Shopping list: milk, bread, eggs"

3. Check configuration

$ thn --config
vault_path: /Users/you/Documents/MyVault
daily_folder: Daily
daily_format: YYYY-MM-DD

📝 Usage Examples

# Simple memo (quotes optional)
thn Idea: think of a new project name

# Multiple words work without quotes
thn Check tomorrow schedule

# Use quotes for shell special characters or multi-line
thn "Task with 'quotes' inside"
thn "TODO:
- Task 1
- Task 2"

⚙️ Configuration

thn config file

~/.config/thn/config.toml

vault_path = "/path/to/vault"

Obsidian settings (auto-detected)

Setting Source Default
Daily notes folder .obsidian/daily-notes.json Vault root
Date format .obsidian/daily-notes.json YYYY-MM-DD

📋 Requirements

Required Recommended
Obsidian Thino plugin
Daily Notes plugin

Note: Memos are appended even without Thino. Install Thino to view memos in the Thino UI.

⚠️ Limitations

Templates

thn creates files directly, so Obsidian templates (including Templater) are not applied.

Workarounds:

  1. Open the daily note in Obsidian first (recommended)
  2. Enable "Open daily note on startup"
  3. Use obsidian-cli alongside thn

Supported modes

Only Thino's DAILY mode is supported. FILE/MULTI/CANVAS modes are not supported.

🤝 Contributing

Issues and PRs are welcome.

📄 License

MIT


For Obsidian and Terminal Lovers ❤️

About

Terminal-first memo tool for Obsidian (Thino-compatible) — Think fast, write faster.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors