settle

settle is a CLI tool that helps you manage your digital Zettelkasten.

Getting started

Requirements

• cargo/rust toolchain
• SQLite

Installation

There's a crate on crates.io, so you can simply run:

cargo install settle

Overview

• full usage manual, contains more technical descriptions
• design principles
• project history
• configuration
• tags and subtags
• links and backlinks
• creating new notes (with templates as well)
• keeping the database up to date
• projects
  • moving notes between projects
• renaming notes
• query, search and filter
  • making a graph of your Zettelkasten

Roadmap

Before 2023

• generate the database from existing files
• create Zettel
• list Zettel
• tags
  • recognize hashtag-tags (e.g. #interesting-tag)
  • search for tags
  • list all tags
• configuration
  • custom Zettelkasten directory
  • custom database file path
  • be able to use templates
• list mentioned but non-existent Zettel ("ghosts")
• search for text inside notes
• update Zettel metadata individually
• projects (subdirectories within the main Zettelkasten folder)
  • add notes to projects
  • create an inbox project by default
  • generate the database with projects included
  • start with an 'inbox' project by default
  • move notes from project to project
• rename notes
  • update all links to the renamed note

After/During 2023

• query: filter notes based on various criteria (title, tags, etc.)
  • support regex
  • print according to a format
  • put custom separator between links, both forward and backward
• graph
  • DOT output
  • render DOT as image
• writing experience (help deal with writer's block)
  • find related notes
  • suggest random notes

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

License

MIT